Skip to main content
POST
/
v2
/
studio
/
deployment
Create a miniapp generator deployment
curl --request POST \
  --url https://api.neynar.com/v2/studio/deployment/ \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "fid": 1,
  "env": {},
  "display_name": "<string>"
}
'
{
  "id": "<string>",
  "deleted_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "created_at": "2023-11-07T05:31:56Z",
  "namespace": "<string>",
  "name": "<string>",
  "is_ready": true,
  "generated_app_exists": true,
  "generated_app_serving": true,
  "display_name": "<string>",
  "url": "<string>",
  "github_url": "<string>",
  "production_app_status": {
    "project_id": "<string>",
    "deployment_url": "<string>",
    "deployment_state": "<string>",
    "created_at": 123,
    "target": "<string>"
  }
}

Documentation Index

Fetch the complete documentation index at: https://docs.neynar.com/llms.txt

Use this file to discover all available pages before exploring further.

The Miniapp Studio API is an allowlisted API and not publicly available. Contact the Neynar team for more information.

Node.js SDK

šŸ”— SDK Method: createDeployment Use this API endpoint with the Neynar Node.js SDK for typed responses and better developer experience.

Authorizations

x-api-key
string
header
default:NEYNAR_API_DOCS
required

API key to authorize requests

Body

application/json
fid
integer
required

Farcaster ID of the user

Required range: x >= 0
env
object

Environment variables for the deployment

display_name
string

Display name for the deployment

Response

Success

id
string
required

Deployment ID

deleted_at
string<date-time> | null
required

Deletion timestamp

updated_at
string<date-time> | null
required

Last update timestamp

created_at
string<date-time>
required

Creation timestamp

namespace
string
required

Kubernetes namespace

name
string
required

Kubernetes deployment name

is_ready
boolean
required

Deployment is ready to serve app and accept prompts

generated_app_exists
boolean
required

Whether a generated app exists in the deployment

generated_app_serving
boolean
required

Whether the generated app is currently serving

display_name
string

Display name for the project

url
string<uri>

Public URL for the deployment

github_url
string

GitHub repository SSH URL

production_app_status
object

Production app deployment status from Vercel