POST /api/project/v1/create/

curl --request POST \
  --url http://localhost:8000/api/project/v1/create/ \
  --header 'Content-Type: application/json' \
  --header 'X-OTAS-USER-TOKEN: <your-token>' \
  --data '{
    "project_name": "My Agent App",
    "project_description": "Production project for the recommendation agent",
    "project_domain": "https://myapp.example.com"
  }'

{
  "status": 1,
  "status_description": "project_created",
  "response_body": {
    "project": {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "name": "My Agent App",
      "description": "Production project for the recommendation agent",
      "domain": "https://myapp.example.com"
    }
  }
}

curl --request POST \
  --url http://localhost:8000/api/project/v1/create/ \
  --header 'Content-Type: application/json' \
  --header 'X-OTAS-USER-TOKEN: <your-token>' \
  --data '{
    "project_name": "My Agent App",
    "project_description": "Production project for the recommendation agent",
    "project_domain": "https://myapp.example.com"
  }'

{
  "status": 1,
  "status_description": "project_created",
  "response_body": {
    "project": {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "name": "My Agent App",
      "description": "Production project for the recommendation agent",
      "domain": "https://myapp.example.com"
    }
  }
}

This endpoint creates a new project and registers the authenticated user as its administrator. The project name is required; description and domain are optional. After creation the caller is automatically recorded in a UserProjectMapping with privilege=1 (Admin), granting them full control over the project including SDK key management.

The caller becomes the sole Admin of the project at creation time. Additional members can be added separately via the project membership endpoints.

Request

Method: POST
URL: http://localhost:8000/api/project/v1/create/
Authentication: X-OTAS-USER-TOKEN header

Headers

string

required

Signed JWT returned by /api/user/v1/login/ or /api/user/v1/create/.

Body parameters

string

required

Human-readable name for the project (max 255 characters).

string

Optional short description of the project (max 300 characters).

string

Optional URL of the project’s primary domain (e.g. https://myapp.example.com).

Response

integer

required

1 on success, 0 on failure.

string

required

project_created on success.

object

Show properties

object

Show project properties

string

UUID of the newly created project.

string

Project name as stored.

string

Project description, or empty string.

string

Project domain URL, or empty string.

Example

curl --request POST \
  --url http://localhost:8000/api/project/v1/create/ \
  --header 'Content-Type: application/json' \
  --header 'X-OTAS-USER-TOKEN: <your-token>' \
  --data '{
    "project_name": "My Agent App",
    "project_description": "Production project for the recommendation agent",
    "project_domain": "https://myapp.example.com"
  }'

{
  "status": 1,
  "status_description": "project_created",
  "response_body": {
    "project": {
      "id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
      "name": "My Agent App",
      "description": "Production project for the recommendation agent",
      "domain": "https://myapp.example.com"
    }
  }
}

Error responses

`status_description`	HTTP status	Cause
`missing_token`	400	The `X-OTAS-USER-TOKEN` header was absent.
`invalid_token`	401	The token is malformed, expired, or not associated with a user.
`project_creation_failed`	400	Payload validation failed or `project_name` was missing.
`project_creation_failed`	500	Unexpected server-side error during project creation.

UASAM — Users & Auth

UASAM — Projects & Keys

UASAM — Agents

Brain — Event Capture

Brain — Analytics

POST /api/project/v1/create/

Request

Headers

Body parameters

Response

Example

Error responses

​Request

​Headers

​Body parameters

​Response

​Example

​Error responses

Request

Headers

Body parameters

Response

Example

Error responses