Get a task

Returns a task with the content changes it proposed or applied.

GET /v1/tasks/{id}

Bearer token scope content:write

curl 'https://api.ferndesk.com/v1/tasks/art_01JXY9AZK4KV' \
  --request GET \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "id": "tsk_01JXYAQ4M7RC",
  "title": "Create API key onboarding docs",
  "status": "in_progress",
  "outputs": [
    {
      "id": "tout_01JXYAQ4M7RC",
      "kind": "article",
      "operation": "create",
      "status": "applied",
      "title": "Getting started with API keys",
      "targetArticleId": "art_01JXY9AZK4KV",
      "targetCollectionId": "col_01JXYA6ABN52",
      "targetSectionId": "sect_01JXYA4T1JNT",
      "appliedAt": "2026-01-01T12:00:00Z"
    }
  ]
}

Task with outputs

Path parameters

· 1

id string required

Identifier of the requested resource.

Path parameters

Responses