Skip to main content
POST
Create a project

Authorizations

Authorization
string
header
required

Your API key, as a Bearer token: Authorization: Bearer <key>.

Headers

Idempotency-Key
string | null

A stable key identifying the project to group work under. Reusing it returns the project created the first time, with status 200 instead of 201, whatever that project is now named.

Required string length: 1 - 255

Body

application/json

Request body for POST /projects.

name
string
required

Display name for the project. It need not be unique, and you can rename the project later from the app.

Required string length: 1 - 255

Response

The project already created under this Idempotency-Key.

A project that groups a batch of generations.

project_id
string
required

Pass as project_id on POST /assets to attach generations to this project.

name
string
required

The project's display name.

created_at
string<date-time>
required

When the project was created (UTC).