Farcaster
- User
- Signer
- Cast
- Feed
- Reaction
- Notifications
- Channel
- Follows
- Storage
- Mini Apps
- Agents
- Fname
- Webhook
- Action
- Mute
- Block
- Ban
- Onchain
- Login
- Metrics
Onchain
Farcaster Hub API
- Info
- Casts
- Reactions
- Links
- UserData
- Fids
- Storage
- Usernames
- Verifications
- OnChainEvents
- Message
- HubEvents
Neynar SDK
- Getting Started with Neynar NodeJS SDK
- NodeJS SDK v1 to v2 migration guide
- Getting Started with Neynar Rust SDK
- Getting Started with Neynar Go SDK
Signature packet
Post a mini app action that has been signed with a developer managed signer
The POST request to the post_url has a timeout of 5 seconds.
POST
/
farcaster
/
frame
/
developer_managed
/
action
curl --request POST \
--url https://api.neynar.com/v2/farcaster/frame/developer_managed/action \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '{
"cast_hash": "0xfe90f9de682273e05b201629ad2338bdcd89b6be",
"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>"
},
"signature_packet": {
"untrustedData": {
"fid": 3,
"url": "<string>",
"messageHash": "<string>",
"timestamp": "<string>",
"network": 123,
"buttonIndex": 123,
"inputText": "<string>",
"state": "<string>",
"transactionId": "<string>",
"address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"castId": {
"fid": 3,
"hash": "<string>"
}
},
"trustedData": {
"messageBytes": "<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>"
}
}
Authorizations
API key to authorize requests
Body
application/json
Response
200
application/json
Successful operation.
Mini app v1 object Mini app base object used across all versions
Mini app v1 object Mini app base object used across all versions
Mini app v2 object Mini app base object used across all versions
Was this page helpful?
curl --request POST \
--url https://api.neynar.com/v2/farcaster/frame/developer_managed/action \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '{
"cast_hash": "0xfe90f9de682273e05b201629ad2338bdcd89b6be",
"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>"
},
"signature_packet": {
"untrustedData": {
"fid": 3,
"url": "<string>",
"messageHash": "<string>",
"timestamp": "<string>",
"network": 123,
"buttonIndex": 123,
"inputText": "<string>",
"state": "<string>",
"transactionId": "<string>",
"address": "0x5a927ac639636e534b678e81768ca19e2c6280b7",
"castId": {
"fid": 3,
"hash": "<string>"
}
},
"trustedData": {
"messageBytes": "<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>"
}
}
Assistant
Responses are generated using AI and may contain mistakes.