Zur Navigation springen
Projects API

Create Project

Create a project to group related generations and assets. Pass the returned id as projectId on POST /v2/generate or POST /v2/assets to file them under this project so they show up together in Studio. Only name is required — visibility defaults to USER and mode to CREATOR. Supply a client-generated UUID as id for idempotent creation. A retry with the same id returns the existing project and ignores other request fields; an id owned by another user/organization or a deleted project returns 409.

Authentifizierung

x-api-keystring
API-Key-Authentifizierung via Header

Anfrage

This endpoint expects an object.
namestringErforderlich
A name for the project.
idstringOptional

Optional client-supplied project id (UUID) for idempotent creation. Re-sending the same id returns the existing project instead of creating a duplicate; the other request fields are ignored on such a replay. Fails with 409 if the id already belongs to a different user or organization, or to a deleted project.

descriptionstringOptional
An optional description for the project.
visibilityenumOptionalStandardwert ist USER

Who can see the project. Defaults to USER (visible only to the owner).

Erlaubte Werte:
modeenumOptionalStandardwert ist CREATOR
The project mode. Defaults to CREATOR.
Erlaubte Werte:
defaultWorkflowenumOptional

The default top-level creator workflow for this project.

Antwort

Project created successfully
idstring
A unique identifier for a project.
createdAtdatetime
The date and time the project was created.
updatedAtdatetime
The date and time the project was last updated.
visibilityenum
Who can see the project.
Erlaubte Werte:
modeenum
The project mode.
Erlaubte Werte:
namestringOptional
The display name of the project.
descriptionstringOptional
An optional description of the project.
defaultWorkflowenum or nullOptional

The default top-level creator workflow for this project. Null for projects created outside the creator-workflows surface.

Fehler

400
Bad Request Error
401
Unauthorized Error
409
Conflict Error
422
Unprocessable Entity Error
500
Internal Server Error