Skip to main content
POST
/
projects
/
{id}
/
tasks
Create a task
curl --request POST \
  --url https://api.corebill.io/v1/projects/{id}/tasks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "title": "Design homepage mockup",
  "description": "Create initial mockups for the homepage",
  "assigned_to": "<string>",
  "parent_task_id": "<string>",
  "depends_on": [
    "<string>"
  ],
  "status": "todo",
  "priority": "high",
  "estimated_hours": 8,
  "start_date": "2023-12-25",
  "due_date": "2023-12-25",
  "is_billable": true,
  "hourly_rate": 75,
  "position": 123,
  "tags": [
    "design"
  ],
  "metadata": {}
}
'
{
  "data": {
    "id": "tsk_a1b2c3d4e5f6",
    "public_id": "TSK-2025-000001",
    "project_id": "pro_a1b2c3d4e5f6",
    "parent_task_id": "<string>",
    "depends_on": [
      "<string>"
    ],
    "assigned_to": "<string>",
    "created_by": "<string>",
    "title": "Design homepage mockup",
    "description": "<string>",
    "status": "in_progress",
    "priority": "high",
    "estimated_hours": 8,
    "start_date": "2023-12-25",
    "due_date": "2023-12-25",
    "completed_at": "2023-11-07T05:31:56Z",
    "is_billable": true,
    "hourly_rate": 75,
    "position": 0,
    "tags": [
      "design",
      "frontend"
    ],
    "metadata": {},
    "created_at": "2023-11-07T05:31:56Z",
    "updated_at": "2023-11-07T05:31:56Z"
  }
}

Authorizations

​
Authorization
string
header
required

API key authentication. Generate keys from the Corebill dashboard under the Developers section.

Example: Authorization: Bearer sk_live_abc123def456

Path Parameters

​
id
string
required

The project ID

Query Parameters

​
company_id
string
required

The company ID to scope the request to

Body

application/json
​
title
string
required

Task title

Example:

"Design homepage mockup"

​
description
string
Example:

"Create initial mockups for the homepage"

​
assigned_to
string | null

User ID to assign the task to

​
parent_task_id
string

Parent task ID to create a subtask

​
depends_on
string[]

Task IDs this task depends on

​
status
enum<string>

Task status (defaults to backlog)

Available options:
backlog,
todo,
in_progress,
in_review,
completed,
cancelled
Example:

"todo"

​
priority
enum<string>

Task priority (defaults to medium)

Available options:
low,
medium,
high,
urgent
Example:

"high"

​
estimated_hours
number
Example:

8

​
start_date
string<date>
​
due_date
string<date>
​
is_billable
boolean

Whether this task is billable (defaults to true)

Example:

true

​
hourly_rate
number<double>

Override hourly rate for this task

Example:

75

​
position
integer

Sort order

​
tags
string[]
Example:
["design"]
​
metadata
object

Response

Task created

​
data
object
required

Task object