Create a project

Creates a new project. The project_id returned in the response is required to create tasks. You must create a project before creating any tasks.

POST /projects

Create a project

cURL

curl --request POST \
  --url https://test-writechoice.onrender.com/projects \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "API Documentation Revamp",
  "description": "Rewriting all public-facing API docs for v2."
}
'

201

{
  "project_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "name": "API Documentation Revamp",
  "description": "Rewriting all public-facing API docs for v2.",
  "created_at": "2025-05-12T10:30:00.000Z"
}

Authorizations

Authorization · string · header · required

All requests must include a valid API key in the Authorization header. Example: Authorization: Bearer tf-live-4a8f2c1e9b3d7e6a

Body

application/json

name · string · required

The name of the project. Required.

Example:

"API Documentation Revamp"

description · string

An optional description of the project.

Example:

"Rewriting all public-facing API docs for v2."

Response

201

application/json

Project created successfully.

project_id · string<uuid>

Unique identifier for the project. Generated automatically.

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

name · string

The name of the project.

Example:

"API Documentation Revamp"

description · string | null

An optional description of the project.

Example:

"Rewriting all public-facing API docs for v2."

created_at · string<date-time>

Timestamp of when the project was created.

Example:

"2025-05-12T10:30:00.000Z"