Tasks

Record tasks. PATCH completed closes or reopens.

Official Aivyro contentAligned with the current public contract

POST/api/v1/tasks

List and create require one parent (contact_id, company_id or deal_id). PATCH "completed": true completes. "completed": false reopens.

HTTP	Path	Scope
GET	`/api/v1/tasks`	`rest.crm.tasks.read`
POST	`/api/v1/tasks`	`rest.crm.tasks.write`
GET	`/api/v1/tasks/{id}`	`rest.crm.tasks.read`
PATCH	`/api/v1/tasks/{id}`	`rest.crm.tasks.write`

Query

Parameter	Type	Notes
contact_id \| company_id \| deal_id	UUID	Exactly one on list/create.
limit / cursor	number / string	Cursor page.

Fields

Field	Type	Notes
id	UUID	Immutable.
title	string	Required on create.
body	string \| null	Optional.
completed	boolean	PATCH true completes. false reopens.
due_at	datetime \| null	ISO-8601.
contact_id / company_id / deal_id	UUID \| null	Parent.

POST /api/v1/tasks

curl -sS -X POST "$AIVYRO_API_BASE/api/v1/tasks" \
  -H "Authorization: Bearer $AIVYRO_API_KEY" \
  -H 'Content-Type: application/json' \
  -d "{\"contact_id\":\"$CONTACT_ID\",\"title\":\"Send proposal\",\"due_at\":\"2026-08-20T15:00:00.000Z\"}"