Skip to main content
GET
/
v2
/
studio
/
deployment
/
by-name-and-fid
Get deployment info
curl --request GET \
  --url https://api.neynar.com/v2/studio/deployment/by-name-and-fid \
  --header 'x-api-key: <api-key>'
{
  "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: getDeployment 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

Query Parameters

ā€‹
deployment_id
string<uuid>

Deployment ID (UUID). Required if name not provided.

ā€‹
fid
integer<int32> | null

Farcaster ID of the user; if not provided, namespace must be provided

Required range: x >= 0
Example:

3

ā€‹
name
string

Kubernetes deployment name. Required if deployment_id not provided.

ā€‹
namespace
string

Optional Kubernetes namespace. If not provided, will query for the active namespace for the given FID.

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