Passer à la navigation
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.

Authentification

x-api-keystring
Authentification par clé API via en-tête

Requête

This endpoint expects an object.
namestringRequis
A name for the project.
idstringOptionnel

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.

descriptionstringOptionnel
An optional description for the project.
visibilityenumOptionnelPar défaut USER

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

Valeurs autorisées:
modeenumOptionnelPar défaut CREATOR
The project mode. Defaults to CREATOR.
Valeurs autorisées:
defaultWorkflowenumOptionnel

The default top-level creator workflow for this project.

Réponse

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.
Valeurs autorisées:
modeenum
The project mode.
Valeurs autorisées:
namestringOptionnel
The display name of the project.
descriptionstringOptionnel
An optional description of the project.
defaultWorkflowenum or nullOptionnel

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

Erreurs

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