Get Task

Overview

Use this endpoint to fetch the complete current state of a task. The response includes everything about the task: its title, description, status, priority, due date, who created it, who is assigned to it, what hashtags are attached, and which list/board/organization it belongs to. This is essential for syncing task state back to your system or verifying that an update was applied correctly. The task ID is permanent - even if users move the task to a different list or board within StrikeOff, the ID stays the same and this endpoint will always return its current location.

When to Use This

• Checking the current status of a task before deciding whether to update it
• Syncing task details back to your external system on a schedule
• Verifying that a previous create or update operation succeeded
• Fetching task data to display in your application UI
• Debugging webhook payloads by comparing them to the full task data

Path Parameters

Request Example

curl -X GET "https://strikeoffapp.com/api/external/v1/tasks/cltask001" \
  -H "Authorization: Bearer sk_live_your_api_key"

Response

{
  "success": true,
  "data": {
    "task": {
      "id": "cltask001...",
      "title": "Review Q4 financial report",
      "description": "Review and approve the quarterly report before Friday",
      "status": "DOING",
      "priority": "HIGH",
      "dueDate": "2024-12-31T23:59:59Z",
      "archived": false,
      "archivedAt": null,
      "createdAt": "2024-12-15T10:30:00Z",
      "updatedAt": "2024-12-16T09:00:00Z",
      "closedDate": null,
      "list": {
        "id": "cllist002...",
        "name": "In Progress",
        "board": {
          "id": "clxxx123...",
          "name": "Development"
        }
      },
      "createdBy": {
        "id": "cluser001...",
        "name": "Jane Smith",
        "email": "jane@example.com"
      },
      "assignedTo": [
        {
          "user": {
            "id": "cluser002...",
            "name": "Bob Wilson",
            "email": "bob@example.com"
          }
        }
      ],
      "hashtags": [
        {
          "id": "clhash001...",
          "name": "urgent",
          "color": "#ff0000"
        }
      ]
    }
  }
}

Notes

• The task must belong to a board in your organization.
• Returns 404 if the task does not exist or is not accessible.
• closedDate is set automatically when status changes to CLOSED.
• archivedAt contains the timestamp when the task was archived (null if not archived).
• assignedTo is an array - tasks can have multiple assignees.