POST
/
api
/
v1
/
projects
curl -X POST \
  https://studio.dubformer.ai/api/v1/projects \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Marketing Campaign 2023",
    "managerEmail": "manager@company.com",
    "translationsGlossaryId": "gloss_5f83a14b2ec1b",
    "voicesGlossaryId": "voices_7c92e3a1f56d8"
  }'

{
  "id": "proj_5f83a14b2ec1b",
  "name": "Marketing Campaign 2023",
  "status": "new",
  "translationGlossary": "gloss_5f83a14b2ec1b",
  "voicesGlossary": "voices_7c92e3a1f56d8",
  "remark": null,
  "clientName": null,
  "projectUrl": "https://studio.dubformer.ai/projects/proj_5f83a14b2ec1b",
  "createdAt": "2023-12-01T10:00:00.000Z",
  "updatedAt": "2023-12-01T10:00:00.000Z"
}

​
Request Body

​
name
string
required
Name of the project.
​
managerEmail
string
Email of the project manager. If not provided, the API key user will be used as the manager.
​
translationsGlossaryId
string
Optional ID of a translation glossary to be used for this project.
​
voicesGlossaryId
string
Optional ID of a voices glossary to be used for this project.

​
Response

​
id
string
Unique project identifier.
​
name
string
Name of the project.
​
status
string
Current status of the project.
​
translationGlossary
string | null
ID of the translation glossary, if any.
​
voicesGlossary
string | null
ID of the voices glossary, if any.
​
remark
string | null
Project remarks, if any.
​
clientName
string | null
Client name, if specified.
​
projectUrl
string
URL to access the project in the web app.
​
createdAt
string
ISO 8601 timestamp when the project was created.
​
updatedAt
string
ISO 8601 timestamp when the project was last updated.
curl -X POST \
  https://studio.dubformer.ai/api/v1/projects \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Marketing Campaign 2023",
    "managerEmail": "manager@company.com",
    "translationsGlossaryId": "gloss_5f83a14b2ec1b",
    "voicesGlossaryId": "voices_7c92e3a1f56d8"
  }'

{
  "id": "proj_5f83a14b2ec1b",
  "name": "Marketing Campaign 2023",
  "status": "new",
  "translationGlossary": "gloss_5f83a14b2ec1b",
  "voicesGlossary": "voices_7c92e3a1f56d8",
  "remark": null,
  "clientName": null,
  "projectUrl": "https://studio.dubformer.ai/projects/proj_5f83a14b2ec1b",
  "createdAt": "2023-12-01T10:00:00.000Z",
  "updatedAt": "2023-12-01T10:00:00.000Z"
}

​
Notes

This endpoint creates a project with basic information only. Videos can be added to the project using separate video management endpoints.
The project manager must belong to the same company as the API key user. If no manager email is provided, the API key user will be assigned as the project manager.
Translation and voices glossaries are optional but must exist and be accessible to your organization if provided.