---
title: "Create a miniapp generator deployment"
method: POST
path: "/v2/studio/deployment/"
tags: ["studio"]
---

# Create a miniapp generator deployment

`POST /v2/studio/deployment/`

Creates and deploys an instance of the miniapp generator for a user. Requires authentication via API key in the request header. Note: Studio CU is tracked based on LLM token usage, not per API call.

## Request body

- object
  - `display_name` string — Display name for the deployment
  - `env` object — Environment variables for the deployment
  - `fid` integer, required — Farcaster ID of the user

## Response `200`

Success

- object
  - `created_at` string, date-time, required — Creation timestamp
  - `deleted_at` string, date-time, nullable, required — Deletion timestamp
  - `dev_server_state` 'stopped' | 'starting' | 'running' | 'crashed' | 'hung' — Dev server process state: stopped, starting, running, crashed, or hung
  - `display_name` string — Display name for the project
  - `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
  - `github_url` string — GitHub repository SSH URL
  - `has_database` boolean — Whether the deployment has a Neon database configured
  - `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
  - `production_app_status` object — Production app deployment status from Vercel
    - `created_at` number, required — Deployment creation timestamp (Unix ms)
    - `deployment_state` string, required — Deployment state (e.g., READY, BUILDING, ERROR)
    - `deployment_url` string, required — Vercel deployment URL
    - `project_id` string, required — Vercel project ID
    - `target` string — Deployment target (e.g., production, preview)
  - `updated_at` string, date-time, nullable, required — Last update timestamp
  - `url` string, uri — Public URL for the deployment

## Other responses

- `400` — Bad Request
- `500` — Server Error

---

[API](https://skmtc.dev/neynar/apis/neynar-api.md) · [All operations](https://skmtc.dev/neynar/apis/neynar-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/neynar/neynar-api/revisions/dbb91bfb0d1a/schema)