> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dialect.to/llms.txt
> Use this file to discover all available pages before exploring further.

# Execute Chained Action

> Endpoint for action chaining (multi-step workflows)



## OpenAPI

````yaml /openapi/blinks.json post /v1/blink/chain
openapi: 3.1.0
info:
  title: Dialect Blinks API
  description: >-
    Blockchain Links (Blinks) are the fastest way to take onchain experiences
    and make them distributable and actionable everywhere. This API enables
    applications to unbundle their product experiences from their apps and
    sites, allowing users to take instant, no-redirect actions wherever they
    are. Blinks transform URLs into complete, interactive blockchain experiences
    that can be embedded in any client application with automatic unfurling and
    transaction capabilities.
  version: 0.1.0
servers:
  - url: https://api.dial.to
    description: Dialect Production
  - url: http://localhost:8770
    description: Local Server
security:
  - clientKey: []
paths:
  /v1/blink/chain:
    post:
      tags:
        - Blink
      summary: Execute Chained Action
      description: Endpoint for action chaining (multi-step workflows)
      operationId: executeChainedAction
      parameters:
        - in: query
          name: apiUrl
          schema:
            type: string
            format: uri
            description: Blink API URL
            default: https://jito.dial.to/stake
            example: https://jito.dial.to/stake
          required: true
      requestBody:
        content:
          application/json:
            schema:
              anyOf:
                - $ref: '#/components/schemas/NextActionPostRequest'
                - $ref: '#/components/schemas/MessageNextActionPostRequest'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                anyOf:
                  - type: object
                    properties:
                      type:
                        type: string
                        enum:
                          - transaction
                          - message
                          - post
                          - external-link
                      message:
                        type: string
                      links:
                        type: object
                        properties:
                          next:
                            $ref: '#/components/schemas/NextActionLink'
                        required:
                          - next
                  - $ref: '#/components/schemas/CompletedAction'
        '502':
          description: Failed to fetch data from Blink Provider
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ActionError'
components:
  schemas:
    NextActionPostRequest:
      type: object
      properties:
        signature:
          type: string
        state:
          type: string
        account:
          type: string
        data:
          type: object
          additionalProperties:
            anyOf:
              - type: string
              - type: array
                items:
                  type: string
      required:
        - account
      description: Next Action Post Request
    MessageNextActionPostRequest:
      type: object
      properties:
        account:
          type: string
        signature:
          type: string
        state:
          type: string
        data:
          anyOf:
            - type: string
            - $ref: '#/components/schemas/SignMessageData'
      required:
        - account
        - signature
        - data
      description: Message Next Action Post Request
    NextActionLink:
      anyOf:
        - type: object
          properties:
            type:
              type: string
              const: post
            href:
              type: string
          required:
            - type
            - href
        - type: object
          properties:
            type:
              type: string
              const: inline
            action:
              type: object
              properties:
                type:
                  type: string
                  enum:
                    - action
                    - completed
                icon:
                  type: string
                title:
                  type: string
                description:
                  type: string
                extendedDescription:
                  type: string
                label:
                  type: string
                disabled:
                  type: boolean
                links:
                  type: object
                  properties:
                    actions:
                      type: array
                      items:
                        $ref: '#/components/schemas/LinkedAction'
                  required:
                    - actions
                error:
                  $ref: '#/components/schemas/ActionError'
                context:
                  $ref: '#/components/schemas/BlinkContext'
                preview:
                  $ref: '#/components/schemas/BlinkPreview'
              required:
                - type
                - icon
                - title
                - description
                - label
                - context
                - preview
          required:
            - type
            - action
      description: Next Action Link
    CompletedAction:
      type: object
      properties:
        type:
          type: string
          const: completed
        icon:
          type: string
        title:
          type: string
        description:
          type: string
        label:
          type: string
        disabled:
          type: boolean
        error:
          type: string
        message:
          type: string
      required:
        - type
        - icon
        - title
        - description
        - label
      description: Completed Action
    ActionError:
      type: object
      properties:
        message:
          type: string
      required:
        - message
      description: Error
    SignMessageData:
      type: object
      properties:
        domain:
          type: string
        address:
          type: string
        statement:
          type: string
        nonce:
          type: string
          minLength: 8
        issuedAt:
          type: string
        chainId:
          type: string
      required:
        - domain
        - address
        - statement
        - nonce
        - issuedAt
      description: Sign Message Data
    LinkedAction:
      type: object
      properties:
        type:
          $ref: '#/components/schemas/LinkedActionType'
        href:
          type: string
        label:
          type: string
        parameters:
          type: array
          items: {}
      required:
        - type
        - href
        - label
      description: Linked Action
    BlinkContext:
      type: object
      properties:
        url:
          type: string
        websiteUrl:
          type: string
        category:
          type: string
        provider:
          $ref: '#/components/schemas/BlinkProvider'
      required:
        - url
      description: Blink Context
    BlinkPreview:
      type: object
      properties:
        image:
          type: string
        title:
          type: string
        description:
          type: string
        cta:
          type: string
        context:
          $ref: '#/components/schemas/BlinkContext'
      required:
        - image
        - title
        - description
        - context
      description: Blink Preview
    LinkedActionType:
      type: string
      enum:
        - transaction
        - message
        - post
        - external-link
        - inline-link
      description: Linked Action Type
    BlinkProvider:
      type: object
      properties:
        name:
          type: string
        icon:
          type: string
      required:
        - name
      description: Blink Provider
  securitySchemes:
    clientKey:
      type: apiKey
      description: Client key to authorize requests.
      name: x-blink-client-key
      in: header

````