Tasks

Work for your team, optionally linked to a record.

GET List tasks
POST Create a task
GET Get a task
PATCH Update a task
DELETE Delete a task
POST Complete a task

#List tasks

GET/api/v1/tasks

Operation list_tasks · needs scope tasks:read

Ordered by due date (soonest first; completed tasks by completion, newest first).

Parameter	In	Type	Notes
`limit`	query	integer	Page size, at most 100.
`cursor`	query	string	`pagination.nextCursor` from the previous page.
`window`	query	today \| overdue \| upcoming \| completed \| all
`owner`	query	string
`person`	query	string
`company`	query	string
`lead`	query	string
`opportunity`	query	string

bash

curl https://synconone.com/api/v1/tasks \
  -H "Authorization: Bearer sk_live_YOUR_KEY"

json

{
  "data": [
    {
      "id": "pr_1a2b3c4d5e6f7a8b",
      "object": "string",
      "title": "Annual plan renewal",
      "description": "Asked about annual terms on the website.",
      "kind": "task",
      "status": "open",
      "priority": "low",
      "due_at": "2026-11-05T10:00:00Z",
      "all_day": true,
      "owner": "string"
    }
  ],
  "pagination": {
    "nextCursor": null,
    "hasMore": false
  }
}

Errors: 401: Missing, invalid, revoked or expired API key. · 403: The key lacks the scope, or its role cannot do this. · 422: Validation failed. · 429: Rate limited. Honour Retry-After.. See errors.

#Create a task

POST/api/v1/tasks

Operation create_task · needs scope tasks:write

Body field	Type	Notes
`title` required	string
`description`	string
`kind`	task \| call \| meeting \| email \| follow_up
`priority`	low \| normal \| high \| urgent
`due_at`	datetime
`all_day`	boolean
`owner`	string	Member user id. Defaults to the key's creator.
`person`	string
`company`	string
`lead`	string
`opportunity`	string

bash

curl -X POST https://synconone.com/api/v1/tasks \
  -H "Authorization: Bearer sk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Annual plan renewal","description":"Asked about annual terms on the website.","kind":"task","priority":"low","due_at":"2026-11-05T10:00:00Z"}'

json

{
  "data": {
    "id": "pr_1a2b3c4d5e6f7a8b",
    "object": "string",
    "title": "Annual plan renewal",
    "description": "Asked about annual terms on the website.",
    "kind": "task",
    "status": "open",
    "priority": "low",
    "due_at": "2026-11-05T10:00:00Z",
    "all_day": true,
    "owner": "string"
  }
}

Errors: 401: Missing, invalid, revoked or expired API key. · 403: The key lacks the scope, or its role cannot do this. · 409: Conflict, approval required, or idempotent request in progress. · 422: Validation failed. · 429: Rate limited. Honour Retry-After.. See errors.

#Get a task

GET/api/v1/tasks/{id}

Operation get_task · needs scope tasks:read

Parameter	In	Type	Notes
`id` required	path	string	Public id of the task.

bash

curl https://synconone.com/api/v1/tasks/pr_1a2b3c4d5e6f7a8b \
  -H "Authorization: Bearer sk_live_YOUR_KEY"

json

{
  "data": {
    "id": "pr_1a2b3c4d5e6f7a8b",
    "object": "string",
    "title": "Annual plan renewal",
    "description": "Asked about annual terms on the website.",
    "kind": "task",
    "status": "open",
    "priority": "low",
    "due_at": "2026-11-05T10:00:00Z",
    "all_day": true,
    "owner": "string"
  }
}

Errors: 401: Missing, invalid, revoked or expired API key. · 403: The key lacks the scope, or its role cannot do this. · 404: Not found, or not visible to this key. · 422: Validation failed. · 429: Rate limited. Honour Retry-After.. See errors.

#Update a task

PATCH/api/v1/tasks/{id}

Operation update_task · needs scope tasks:write

Parameter	In	Type	Notes
`id` required	path	string	Public id of the task.

Body field	Type	Notes
`title`	string
`description`	string
`kind`	task \| call \| meeting \| email \| follow_up
`priority`	low \| normal \| high \| urgent
`due_at`	datetime
`owner`	string
`status`	open \| completed \| cancelled

bash

curl -X PATCH https://synconone.com/api/v1/tasks/pr_1a2b3c4d5e6f7a8b \
  -H "Authorization: Bearer sk_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"title":"Annual plan renewal","description":"Asked about annual terms on the website.","kind":"task","priority":"low","due_at":"2026-11-05T10:00:00Z"}'

json

{
  "data": {
    "id": "pr_1a2b3c4d5e6f7a8b",
    "object": "string",
    "title": "Annual plan renewal",
    "description": "Asked about annual terms on the website.",
    "kind": "task",
    "status": "open",
    "priority": "low",
    "due_at": "2026-11-05T10:00:00Z",
    "all_day": true,
    "owner": "string"
  }
}

Errors: 401: Missing, invalid, revoked or expired API key. · 403: The key lacks the scope, or its role cannot do this. · 404: Not found, or not visible to this key. · 409: Conflict, approval required, or idempotent request in progress. · 422: Validation failed. · 429: Rate limited. Honour Retry-After.. See errors.

#Delete a task

DELETE/api/v1/tasks/{id}

Operation delete_task · needs scope tasks:write

Removes the task for good, and the record it was on gets its next activity recalculated.

Parameter	In	Type	Notes
`id` required	path	string	Public id of the task.

bash

curl -X DELETE https://synconone.com/api/v1/tasks/pr_1a2b3c4d5e6f7a8b \
  -H "Authorization: Bearer sk_live_YOUR_KEY"

json

{
  "data": {
    "id": "pr_1a2b3c4d5e6f7a8b",
    "object": "string",
    "deleted": true
  }
}

#Complete a task

POST/api/v1/tasks/{id}/complete

Operation complete_task · needs scope tasks:write

Idempotent: completing a completed task changes nothing.

Parameter	In	Type	Notes
`id` required	path	string	Public id of the task.

bash

curl -X POST https://synconone.com/api/v1/tasks/pr_1a2b3c4d5e6f7a8b/complete \
  -H "Authorization: Bearer sk_live_YOUR_KEY"

json

{
  "data": {
    "id": "pr_1a2b3c4d5e6f7a8b",
    "object": "string",
    "title": "Annual plan renewal",
    "description": "Asked about annual terms on the website.",
    "kind": "task",
    "status": "open",
    "priority": "low",
    "due_at": "2026-11-05T10:00:00Z",
    "all_day": true,
    "owner": "string"
  }
}