> ## Documentation Index
> Fetch the complete documentation index at: https://developers.zite.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Zite via API

> Programmatically create Zites from a prompt using the REST API.

The Create Zite API lets you programmatically generate a Zite from a text prompt, optionally including files, a theme, and a name. The Zite is created instantly and a **claim URL** is returned so a user can take ownership of it.

No authentication is required to call this endpoint.

## Use cases

* **Embed app creation in your product.** Add a "Create an app" button to your website or tool that generates a Zite behind the scenes
* **Share prompts that generate apps.** Create shareable links or workflows that produce a Zite from a predefined prompt
* **Automate app generation.** Integrate Zite creation into scripts, pipelines, or automation workflows
* **Rapid prototyping.** Quickly spin up Zites from the command line or CI/CD

## How it works

1. Send a `POST` request with a prompt (and optional files, theme, or name)
2. A new Zite is generated instantly
3. The response includes a `claimUrl`. Share it with a user so they can claim the Zite into their own account

<Frame>
  <img src="https://mintcdn.com/zite-js/TLc4d0g38r-hM_FM/images/claim-image.png?fit=max&auto=format&n=TLc4d0g38r-hM_FM&q=85&s=486be7bab496321cbefcea290d2d4004" alt="Claiming a Zite" width="2702" height="1426" data-path="images/claim-image.png" />
</Frame>

<Info>
  The base URL is `https://api.zite.com/v1/api`.
</Info>

## API reference

### Endpoint

```text theme={"system"}
POST /zite/create
```

### Request body

| Field | Type | Required | Description |
| - | - | - | - |
| `prompt` | string | Yes | The prompt to generate the Zite from. 1–10,000 characters, trimmed. |
| `files` | array | No | Files to include. Max 10 items. |
| `files[].url` | string | Yes (within `files`) | A valid URL pointing to the file. |
| `files[].fileName` | string | No | A display name for the file. |
| `theme` | string | No | A theme for the Zite. If omitted, auto-selected from the prompt (when no files are attached). |
| `name` | string | No | A name for the Zite. Max 250 characters. If omitted, auto-generated from the prompt. |

### Response body

| Field | Type | Description |
| - | - | - |
| `flowPublicIdentifier` | string | Unique identifier for the created Zite. |
| `claimUrl` | string | URL the user can visit to claim and own the Zite. |
| `appName` | string | The resolved app name (provided or auto-generated). |

<Note>
  If no `theme` is provided and no files are attached, a theme is automatically selected using AI based on the prompt.
</Note>

## Example

### Request

```bash theme={"system"}
curl -X POST https://api.zite.com/v1/api/zite/create \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A project management dashboard with task boards, deadlines, and team assignments"
  }'
```

### Response

```json theme={"system"}
{
  "claimUrl": "https://www.zite.com/claim/abc123def456",
  "appName": "Project Management Dashboard"
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.