Tasks

Tasks let you create follow-up reminders and action items linked to contacts.

---

List Contact Tasks

GET /contacts/{contact_id}/tasks

Returns tasks linked to a specific contact.

Query Parameters

Parameter	Type	Default	Description
status	string	—	Filter by status (open, completed, overdue)

Example

cURL

curl "https://be.graph8.com/api/v1/contacts/12345/tasks?status=open" \
  -H "Authorization: Bearer $API_KEY"

Python

response = requests.get(
    f"{BASE_URL}/contacts/12345/tasks",
    headers=HEADERS,
    params={"status": "open"}
)

Response

{
  "data": [
    {
      "id": "task-abc",
      "title": "Send proposal",
      "description": "Draft and send the enterprise proposal.",
      "status": "open",
      "priority": 2,
      "due_date": "2026-03-05T00:00:00Z",
      "assignee_id": "user-123",
      "entity_type": "contact",
      "entity_id": "12345",
      "created_at": "2026-02-25T10:00:00Z",
      "updated_at": "2026-02-25T10:00:00Z"
    }
  ]
}

---

List All Tasks

GET /tasks

Returns all tasks across the organization, with optional filters.

Query Parameters

Parameter	Type	Default	Description
status	string	—	Filter by status
priority	integer	—	Filter by priority (0=none, 1=urgent, 2=high, 3=normal, 4=low)
assignee_id	string	—	Filter by assignee
search	string	—	Search in title and description

---

Create Task

POST /contacts/{contact_id}/tasks

Request Body

Field	Type	Required	Description
title	string	Yes	Task title
description	string	No	Task details
due_date	string	No	ISO 8601 due date
assignee_id	string	No	User ID to assign
priority	integer	No	0=none, 1=urgent, 2=high, 3=normal, 4=low

Example

cURL

curl -X POST "https://be.graph8.com/api/v1/contacts/12345/tasks" \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title": "Send proposal", "due_date": "2026-03-05", "priority": 2}'

---

Update Task

PATCH /tasks/{task_id}

Supports partial updates. Send only the fields you want to change.

---

Delete Task

DELETE /tasks/{task_id}

Returns 204 No Content on success.