Sign in

v1

latestOpenAPI 3.0.42026-07-26159287356.1 KB
Cast

Post a cast

Posts a cast or cast reply. Works with mentions and embeds.
(In order to post a cast signer_uuid must be approved)

post/v2/farcaster/cast/

Request body

channel_idstring

Channel ID of the channel where the cast is to be posted. e.g. neynar, farcaster, warpcast

idemstring

An Idempotency key is a unique identifier for the request. Note:

  1. This is used to prevent duplicate requests. Use the same idem key on retry attempts.
  2. This should be a unique identifier for each request.
  3. Recommended format is a 16-character string generated by the developer at the time of making this request.
parentstring

parent_url of the channel the cast is in, or hash of the cast

parent_author_fidinteger

The unique identifier of a farcaster user or app (unsigned integer)

signer_uuidstring required

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

textstring

Example request

{
  "channel_id": "neynar",
  "embeds": [
    {
      "cast_id": {
        "fid": 3
      }
    }
  ],
  "parent_author_fid": 3,
  "signer_uuid": "19d0c5fd-9b33-4a48-a0e2-bc7b0555baec"
}

Response

Success

successboolean required

Example response

{
  "cast": {
    "author": {
      "fid": 3
    },
    "hash": "0x71d5225f77e0164388b1d4c120825f3a2c1f131c"
  }
}