Skip to main content

​
List Tasks

Retrieve a paginated list of tasks. Optionally filter by company or status.
​
page
integer
default:"1"
Page number for pagination.
​
per_page
integer
default:"25"
Number of tasks per page.
​
company_id
string
Filter tasks by company ID (UUID).
​
status
string
Filter tasks by status (e.g., pending, in_progress, completed).
curl -X GET "https://api.pipelinegeneration.ai/v1/tasks?status=pending&per_page=10" \
  -H "x-api-key: your_api_key"

{
  "data": [
    {
      "id": "t1a2b3c4-d5e6-7890-abcd-ef1234567890",
      "title": "Follow up with Acme decision maker",
      "description": "Schedule a demo with the VP of Engineering",
      "status": "pending",
      "priority": "high",
      "company_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "assignee_id": "u1v2w3x4-y5z6-7890-abcd-ef1234567890",
      "due_date": "2026-03-15",
      "created_at": "2026-03-10T09:00:00Z"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 10,
    "total": 23
  }
}

​
Get Task

Retrieve detailed information about a specific task.
​
task_id
string
required
The unique identifier of the task.
curl -X GET "https://api.pipelinegeneration.ai/v1/tasks/{task_id}" \
  -H "x-api-key: your_api_key"

{
  "id": "t1a2b3c4-d5e6-7890-abcd-ef1234567890",
  "title": "Follow up with Acme decision maker",
  "description": "Schedule a demo with the VP of Engineering",
  "status": "pending",
  "priority": "high",
  "company_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "assignee_id": "u1v2w3x4-y5z6-7890-abcd-ef1234567890",
  "due_date": "2026-03-15",
  "created_at": "2026-03-10T09:00:00Z",
  "updated_at": "2026-03-10T09:00:00Z"
}

​
Create Task

Create a new task in your workspace.
​
title
string
required
The task title.
​
description
string
A description of the task.
​
company_id
string
Associate the task with a company (UUID).
​
assignee_id
string
Assign the task to a team member (UUID).
​
due_date
string
The due date in YYYY-MM-DD format.
​
priority
string
Task priority level (e.g., low, medium, high).
curl -X POST "https://api.pipelinegeneration.ai/v1/tasks" \
  -H "x-api-key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Send proposal to TechCorp",
    "description": "Prepare and send the Q2 proposal deck",
    "company_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "priority": "high",
    "due_date": "2026-03-20"
  }'

{
  "id": "t2b3c4d5-e6f7-8901-bcde-f23456789012",
  "title": "Send proposal to TechCorp",
  "description": "Prepare and send the Q2 proposal deck",
  "status": "pending",
  "priority": "high",
  "company_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "due_date": "2026-03-20",
  "created_at": "2026-03-12T10:00:00Z"
}

​
Update Task

Update an existing task. Only include the fields you want to change.
​
task_id
string
required
The unique identifier of the task.
​
title
string
Updated task title.
​
description
string
Updated task description.
​
status
string
Updated status (e.g., pending, in_progress, completed).
​
assignee_id
string
Reassign the task to a different team member (UUID).
​
due_date
string
Updated due date in YYYY-MM-DD format.
​
priority
string
Updated priority level.
curl -X PATCH "https://api.pipelinegeneration.ai/v1/tasks/{task_id}" \
  -H "x-api-key: your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "completed"
  }'

{
  "id": "t1a2b3c4-d5e6-7890-abcd-ef1234567890",
  "title": "Follow up with Acme decision maker",
  "status": "completed",
  "priority": "high",
  "company_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "due_date": "2026-03-15",
  "updated_at": "2026-03-12T15:30:00Z"
}