task.completed

WEBHOOK

task.completed

{
  "event_type": "task.completed",
  "id": "task_public_id",
  "book_id": "book_public_id",
  "subscription_id": "subscription_public_id",
  "user_id": "user_public_id",
  "company_id": "company_public_id",
  "task": {
    "id": "task_public_id",
    "book_id": "book_public_id",
    "title": "Send review summary",
    "description": "Email the meeting summary.",
    "deadline_at": "2026-10-20T17:00:00Z",
    "all_day": false,
    "status": "done",
    "priority": "medium_priority",
    "is_private": false,
    "completed_at": "2026-10-19T16:15:00Z",
    "created_at": "2026-10-15T12:00:00Z",
    "updated_at": "2026-10-19T16:15:00Z",
    "assigned_to": {
      "id": "user_public_id",
      "name": "Jane Doe",
      "email": "jane@example.com"
    },
    "assigned_team": null,
    "record": {
      "id": "household_public_id",
      "type": "household",
      "name": "Example household"
    },
    "tags": []
  }
}

Sent when a task is completed. This also emits task.updated. A task reopened before delivery can appear as todo in this snapshot. The snapshot is prepared asynchronously and may reflect changes made after the triggering event. Use its updated_at to reconcile local state. Scheduled and unapproved tasks do not emit these events. Fetch the current task with GET /v1/tasks/{id}. Verify the raw request body before processing. See the webhook overview for signing, retries, subscription context, and ordering.

Headers

svix-id

string

required

Delivery message ID. Use for idempotency; overlapping subscriptions have distinct IDs.

svix-timestamp

string

required

Unix timestamp used for signature verification.

svix-signature

string

required

Signature(s) to verify with the endpoint signing secret and a Svix verification library.

Body

application/json

JSON payload sent to your configured webhook endpoint.

subscription_id

string

required

Subscription that caused this delivery.

user_id

string

required

Subscribed Slant user.

book_id

string

required

Book containing the record.

company_id

string

required

Company that owns the book.

event_type

string

required

Allowed value: "task.completed"

string

required

ID of the affected task.

task

object

required

Show child attributes

Response

200

Return a successful 2xx response promptly after verifying and durably accepting the delivery. Non-success responses can cause retries.

⌘I

{
  "event_type": "task.completed",
  "id": "task_public_id",
  "book_id": "book_public_id",
  "subscription_id": "subscription_public_id",
  "user_id": "user_public_id",
  "company_id": "company_public_id",
  "task": {
    "id": "task_public_id",
    "book_id": "book_public_id",
    "title": "Send review summary",
    "description": "Email the meeting summary.",
    "deadline_at": "2026-10-20T17:00:00Z",
    "all_day": false,
    "status": "done",
    "priority": "medium_priority",
    "is_private": false,
    "completed_at": "2026-10-19T16:15:00Z",
    "created_at": "2026-10-15T12:00:00Z",
    "updated_at": "2026-10-19T16:15:00Z",
    "assigned_to": {
      "id": "user_public_id",
      "name": "Jane Doe",
      "email": "jane@example.com"
    },
    "assigned_team": null,
    "record": {
      "id": "household_public_id",
      "type": "household",
      "name": "Example household"
    },
    "tags": []
  }
}

Getting started

Endpoints

Webhooks

Headers

Body

Response