> ## 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 Blink Action

> Returns a ready-to-sign transaction



## OpenAPI

````yaml /openapi/blinks.json post /v1/blink
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:
    post:
      tags:
        - Blink
      summary: Execute Blink Action
      description: Returns a ready-to-sign transaction
      operationId: executeBlinkAction
      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:
              $ref: '#/components/schemas/ActionPostRequest'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                anyOf:
                  - $ref: '#/components/schemas/TransactionResponse'
                  - $ref: '#/components/schemas/PostResponse'
                  - $ref: '#/components/schemas/ExternalLinkResponse'
                  - $ref: '#/components/schemas/SignMessageResponse'
        '502':
          description: Failed to fetch data from Blink Provider
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ActionError'
components:
  schemas:
    ActionPostRequest:
      type: object
      properties:
        type:
          type: string
          enum:
            - transaction
            - message
            - post
            - external-link
        account:
          type: string
        data:
          type: object
          additionalProperties:
            anyOf:
              - type: string
              - type: array
                items:
                  type: string
      required:
        - account
      description: Action Post Request
    TransactionResponse:
      type: object
      properties:
        type:
          type: string
          const: transaction
        message:
          type: string
        links:
          type: object
          properties:
            next:
              $ref: '#/components/schemas/NextActionLink'
          required:
            - next
        transaction:
          type: string
        lifecycle:
          type: object
          properties:
            executing:
              type: object
              properties:
                message:
                  type: string
            success:
              type: object
              properties:
                message:
                  type: string
                links:
                  type: object
                  properties:
                    actions:
                      type: array
                      items:
                        type: object
                        properties:
                          type:
                            type: string
                            const: inline-link
                          label:
                            type: string
                          link:
                            type: string
                        required:
                          - type
                          - label
                          - link
                  required:
                    - actions
            error:
              type: object
              properties:
                message:
                  type: string
      required:
        - type
        - transaction
      description: Transaction Response
    PostResponse:
      type: object
      properties:
        type:
          type: string
          const: post
        message:
          type: string
        links:
          type: object
          properties:
            next:
              $ref: '#/components/schemas/NextActionLink'
          required:
            - next
      required:
        - type
      description: Post Response
    ExternalLinkResponse:
      type: object
      properties:
        type:
          type: string
          const: external-link
        message:
          type: string
        links:
          type: object
          properties:
            next:
              $ref: '#/components/schemas/NextActionLink'
          required:
            - next
        externalLink:
          type: string
      required:
        - type
        - externalLink
      description: External Link Response
    SignMessageResponse:
      type: object
      properties:
        type:
          type: string
          const: message
        message:
          type: string
        links:
          type: object
          properties:
            next:
              $ref: '#/components/schemas/PostNextActionLink'
          required:
            - next
        data:
          anyOf:
            - type: string
            - $ref: '#/components/schemas/SignMessageData'
        state:
          type: string
      required:
        - type
        - links
        - data
      description: Sign Message Response
    ActionError:
      type: object
      properties:
        message:
          type: string
      required:
        - message
      description: Error
    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
    PostNextActionLink:
      type: object
      properties:
        type:
          type: string
          const: post
        href:
          type: string
      required:
        - type
        - href
      description: Post Next Action Link
    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

````