Skip to main content
POST
Create a miniapp generator deployment
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<int32>
required

Farcaster ID of the user

Required range: x >= 0
Example:

3

display_name
string

Display name for the deployment

env
object

Environment variables for the deployment

Response

Success

created_at
string<date-time>
required

Creation timestamp

deleted_at
string<date-time> | null
required

Deletion timestamp

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

id
string
required

Deployment ID

is_ready
boolean
required

Deployment is ready to serve app and accept prompts

name
string
required

Kubernetes deployment name

namespace
string
required

Kubernetes namespace

updated_at
string<date-time> | null
required

Last update timestamp

dev_server_state
enum<string>

Dev server process state: stopped, starting, running, crashed, or hung

Available options:
stopped,
starting,
running,
crashed,
hung
display_name
string

Display name for the project

github_url
string

GitHub repository SSH URL

has_database
boolean

Whether the deployment has a Neon database configured

production_app_status
object

Production app deployment status from Vercel

url
string<uri>

Public URL for the deployment