VideohatiDocs
API referenceProjects

Create a project

Create a project

POST/v1/projects

This operation supports dashboard session-cookie authentication. Call it only from trusted server code; browsers must not manufacture or expose the session cookie.

Requires an approved account. Session-cookie auth only. Rate limit: 60 requests per 60 s per session.

Error codes: unauthorized (401), account_not_approved (403), not_found (404), invalid_name (400).

Authentication

  • sessionCookie — Dashboard session cookie set by POST /v1/auth/login. Video and playback endpoints additionally require the projectId query parameter under cookie auth.

Parameters

This operation takes no parameters.

Request body

required

Content type: application/json

Schema: ProjectCreateRequest

{
  "name": "Arabic Calculus Course"
}

Responses

StatusMeaning
201Project created on the account's current plan (Trial while the 14-day trial runs).
400The request body or query failed validation. The per-operation description lists the exact error.code values.
401No valid credential was presented.
403The credential is valid but does not permit this action. The per-operation description lists the exact error.code values.
404The resource does not exist or is not visible to this caller.
429Rate limit exceeded.

Example request

{
  "name": "Arabic Calculus Course"
}