Skip to main content
GET
/
tasks
/
{taskId}
{
  "id": "task-abc123",
  "subject": "Follow up call",
  "description": "Discuss partnership proposal",
  "type": "call",
  "dueDate": "2024-12-31T10:00:00Z",
  "contactId": "contact_8f3k2j",
  "completed": false,
  "completedAt": null,
  "createdAt": "2024-12-15T10:00:00Z"
}

Your Implementation Required

This endpoint must be implemented on your server
Enginy calls this endpoint to retrieve task details.

Path Parameters

taskId
string
required
The task’s CRM ID
bash GET /tasks/task-abc123

Response

id
string
required
Task CRM ID
subject
string
Task subject
description
string
Task description
completed
boolean
Completion status
completedAt
string
Completion timestamp (if completed)
{
  "id": "task-abc123",
  "subject": "Follow up call",
  "description": "Discuss partnership proposal",
  "type": "call",
  "dueDate": "2024-12-31T10:00:00Z",
  "contactId": "contact_8f3k2j",
  "completed": false,
  "completedAt": null,
  "createdAt": "2024-12-15T10:00:00Z"
}

Not Found

Return 404 if task doesn’t exist:
{
  "error": "Task not found"
}