POST
/
v2
/
farcaster
/
frame
/
action
/
Post a mini app action, cast action or a cast composer action
curl --request POST \
  --url https://api.neynar.com/v2/farcaster/frame/action/ \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '{
  "signer_uuid": "19d0c5fd-9b33-4a48-a0e2-bc7b0555baec",
  "cast_hash": "0x71d5225f77e0164388b1d4c120825f3a2c1f131c",
  "action": {
    "version": "<string>",
    "title": "<string>",
    "image": "<string>",
    "button": {
      "title": "<string>",
      "index": 123,
      "action_type": "post",
      "target": "<string>",
      "post_url": "<string>"
    },
    "input": {
      "text": "Draw a purple ringed planet"
    },
    "state": {
      "serialized": "%7B%22counter%22%3A1%7D"
    },
    "transaction": {
      "hash": "0xa80de157a3ab4648db1ecfab7e6355b342215bc549f6e37be9e6da527cc024f7"
    },
    "address": "<string>",
    "frames_url": "<string>",
    "post_url": "<string>"
  }
}'
{
  "version": "<string>",
  "image": "<string>",
  "frames_url": "<string>",
  "buttons": [
    {
      "title": "<string>",
      "index": 123,
      "action_type": "post",
      "target": "<string>",
      "post_url": "<string>"
    }
  ],
  "post_url": "<string>",
  "title": "<string>",
  "image_aspect_ratio": "<string>",
  "input": {
    "text": "<string>"
  },
  "state": {
    "serialized": "<string>"
  }
}
To learn more about using this route on your own backend to handle frame interactions, read our guide on Frame Interactions with the Neynar API
The post frame action API can be used by clients to interact with a frame. You need to have an approved signer_uuid to post a frame action.
The POST request to the post_url has a timeout of 5 seconds.

Authorizations

x-api-key
string
header
default:NEYNAR_API_DOCS
required

API key to authorize requests

Body

application/json
signer_uuid
string
required

UUID of the signer. signer_uuid is paired with API key, can't use a uuid made with a different API key.

Example:

"19d0c5fd-9b33-4a48-a0e2-bc7b0555baec"

action
object
required
cast_hash
string
Example:

"0x71d5225f77e0164388b1d4c120825f3a2c1f131c"

Response

Success

Mini app v1 object

version
string
required

Version of the mini app, 'next' for v2, 'vNext' for v1

image
string
required

URL of the image

frames_url
string
required

Launch URL of the mini app

buttons
FrameActionButton · object[]
post_url
string

Post URL to take an action on this mini app

title
string
image_aspect_ratio
string
input
object
state
object