Workflow (Task Management) API Task lists, tasks, worklogs, interjections, approvals, and todos.

All workflow endpoints (except toggle) require the workflow feature to be enabled on the target workspace or share. All GET endpoints support format=md query parameter for Markdown output (AI agent-friendly).

Share access: Workflow features on shares (tasks, todos, approvals, worklogs) require Member-level access or higher. Guests and public guests cannot access workflow features on shares. Toggle endpoints (enable/disable) remain Admin-only.

Endpoint Summary

Feature Toggle

Task Lists & Tasks

Worklogs

Approvals

Todos

Common Path Parameters

Common Error Responses

These errors apply to all workflow endpoints (except toggle):

Share Workflow Access Levels

Workflow features on shares have a restricted permission model. Only users with Member-level access or higher can use workflow endpoints on shares.

Feature Toggle

Enable or disable workflow on a workspace or share. Requires admin-level access. These endpoints do not require workflow to already be enabled.

Enable Workflow on Workspace

Auth: Required (JWT). Admin or owner.

Request Example

curl -X POST "https://api.fast.io/current/workspace/1234567890123456789/workflow/enable/" \
  -H "Authorization: Bearer {jwt_token}"

Response

{
  "result": "yes",
  "response": {
    "message": "Workflow features enabled",
    "workflow": true
  },
  "current_api_version": "1.0"
}

Response Fields

Access Levels

Error Responses

Disable Workflow on Workspace

Request Example

curl -X POST "https://api.fast.io/current/workspace/1234567890123456789/workflow/disable/" \
  -H "Authorization: Bearer {jwt_token}"

Response

{
  "result": "yes",
  "response": {
    "message": "Workflow features disabled",
    "workflow": false
  },
  "current_api_version": "1.0"
}

Error Responses

Share Toggle Endpoints

Behave identically to the workspace variants above, using {share_id} instead. Requires Admin-level access on the share.

Disabling workflow does not delete any data. All entities are preserved and become accessible again when re-enabled.

Task Lists & Tasks

Task lists are containers for tasks, scoped to a workspace or share. Tasks support statuses, priorities, assignees, dependencies, and file/folder node links.

Task Status Values

Valid Status Transitions

Task Priority (integer)

Task List Object

Task Object

List Task Lists

Backwards compatibility: The previous routes (/current/tasks/workspace/{workspace_id}/ and /current/tasks/share/{share_id}/) continue to work via automatic redirect.

Auth: Required (JWT). Rate limited.

Query Parameters

Request Example

curl -X GET "https://api.fast.io/current/workspace/1234567890123456789/tasks/?limit=50" \
  -H "Authorization: Bearer {jwt_token}"

Response

{
  "result": "yes",
  "response": {
    "task_lists": [
      {
        "id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5",
        "profile_id": "1234567890123456789",
        "name": "Sprint 12 Tasks",
        "description": "Tasks for the current sprint",
        "created_by": "9876543210987654321",
        "properties": {},
        "sort_order": 0,
        "created": "2025-06-01T09:00:00+00:00",
        "updated": "2025-06-10T14:30:00+00:00",
        "deleted": null
      }
    ],
    "pagination": {
      "limit": 50,
      "offset": 0,
      "total": 1
    }
  },
  "current_api_version": "1.0"
}

Create Task List

Backwards compatibility: The previous routes (/current/tasks/workspace/{workspace_id}/create/ and /current/tasks/share/{share_id}/create/) continue to work via automatic redirect.

Auth: Required (JWT). Rate limited.

Request Body

Request Example

curl -X POST "https://api.fast.io/current/workspace/1234567890123456789/tasks/create/" \
  -H "Authorization: Bearer {jwt_token}" \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "name=Sprint%2012%20Tasks&description=Tasks%20for%20the%20current%20sprint"

Response

{
  "result": "yes",
  "response": {
    "task_list": {
      "id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5",
      "profile_id": "1234567890123456789",
      "name": "Sprint 12 Tasks",
      "description": "Tasks for the current sprint",
      "created_by": "9876543210987654321",
      "properties": {},
      "sort_order": 0,
      "created": "2025-06-01T09:00:00+00:00",
      "updated": "2025-06-01T09:00:00+00:00",
      "deleted": null
    }
  },
  "current_api_version": "1.0"
}

Get Task List Details

Auth: Required (JWT). Rate limited.

Query Parameters

Response

{
  "result": "yes",
  "response": {
    "task_list": {
      "id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5",
      "profile_id": "1234567890123456789",
      "name": "Sprint 12 Tasks",
      "description": "Tasks for the current sprint",
      "created_by": "9876543210987654321",
      "properties": {},
      "sort_order": 0,
      "created": "2025-06-01T09:00:00+00:00",
      "updated": "2025-06-10T14:30:00+00:00",
      "deleted": null
    },
    "tasks": [
      {
        "id": "x1y2z3a4b5c6d7e8f9g0h1i2j3k4l5",
        "task_list_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5",
        "profile_id": "1234567890123456789",
        "title": "Implement login flow",
        "description": "Build the OAuth2 login flow",
        "status": "in_progress",
        "assignee_id": "9876543210987654321",
        "priority": 3,
        "sort_order": 0,
        "dependencies": null,
        "node_id": null,
        "properties": {},
        "created": "2025-06-01T09:30:00+00:00",
        "updated": "2025-06-10T14:30:00+00:00",
        "deleted": null
      }
    ]
  },
  "current_api_version": "1.0"
}

Update Task List

Auth: Required (JWT). Rate limited.

Request Body

Delete Task List

Auth: Required (JWT). Rate limited.

List Tasks

Auth: Required (JWT). Rate limited.

Query Parameters

Create Task

Auth: Required (JWT). Rate limited.

Request Body

Request Example

curl -X POST "https://api.fast.io/current/tasks/a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5/items/create/" \
  -H "Authorization: Bearer {jwt_token}" \
  -d "title=Implement%20login%20flow&priority=3&assignee_id=9876543210987654321"

Response

{
  "result": "yes",
  "response": {
    "task": {
      "id": "x1y2z3a4b5c6d7e8f9g0h1i2j3k4l5",
      "task_list_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5",
      "profile_id": "1234567890123456789",
      "title": "Implement login flow",
      "description": null,
      "status": "pending",
      "assignee_id": "9876543210987654321",
      "priority": 3,
      "sort_order": 0,
      "dependencies": null,
      "node_id": null,
      "properties": {},
      "created": "2025-06-01T09:30:00+00:00",
      "updated": "2025-06-01T09:30:00+00:00",
      "deleted": null
    }
  },
  "current_api_version": "1.0"
}

Get Task Details

Auth: Required (JWT). Rate limited.

Query Parameters

Update Task

Auth: Required (JWT). Rate limited.

Request Body

Delete Task

Auth: Required (JWT). Rate limited.

Change Task Status

Auth: Required (JWT). Rate limited.

Request Body

Request Example

curl -X POST "https://api.fast.io/current/tasks/a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5/items/x1y2z3a4b5c6d7e8f9g0h1i2j3k4l5/status/" \
  -H "Authorization: Bearer {jwt_token}" \
  -d "status=in_progress"

Response

{
  "result": "yes",
  "response": {
    "task": {
      "id": "x1y2z3a4b5c6d7e8f9g0h1i2j3k4l5",
      "status": "in_progress",
      "...": "..."
    },
    "old_status": "pending",
    "new_status": "in_progress"
  },
  "current_api_version": "1.0"
}

Assign Task

Auth: Required (JWT). Rate limited.

Request Body

Move Task

Auth: Required (JWT). Rate limited.

Request Body

Constraints: Target list must exist, not be deleted, and belong to the same profile. Source and target list cannot be the same.

Example

curl -X POST "https://api.fast.io/current/tasks/a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5/items/x1y2z3a4b5c6d7e8f9g0h1i2j3k4l5/move/" \
  -H "Authorization: Bearer {jwt_token}" \
  -H "Content-Type: application/json" \
  -d '{"target_task_list_id": "p1q2r3s4t5u6v7w8x9y0z1a2b3c4d5"}'

Response: Updated task object with old_task_list_id and new_task_list_id.

Bulk Update Task Status

Auth: Required (JWT). Rate limited.

Request Body

Request Example

curl -X POST "https://api.fast.io/current/tasks/a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5/items/bulk-status/" \
  -H "Authorization: Bearer {jwt_token}" \
  -H "Content-Type: application/json" \
  -d '{"tasks": [{"task_id": "x1y2z3...", "status": "complete"}, {"task_id": "p1q2r3...", "status": "in_progress"}]}'

Response

{
  "result": "yes",
  "response": {
    "success": true,
    "updated_count": 2,
    "failed_count": 0,
    "total_count": 2,
    "results": [
      {"task_id": "x1y2z3...", "success": true, "error": null},
      {"task_id": "p1q2r3...", "success": true, "error": null}
    ]
  },
  "current_api_version": "1.0"
}

Response Fields

Reorder Tasks

Auth: Required (JWT). Rate limited.

Request Body (JSON)

Each entry in the order array specifies a task ID and its new sort order. All task IDs must belong to the specified task list.

Request Example

curl -X POST "https://api.fast.io/current/tasks/a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5/items/reorder/" \
  -H "Authorization: Bearer {jwt_token}" \
  -H "Content-Type: application/json" \
  -d '{"order": [{"id": "x1y2z3...", "sort_order": 0}, {"id": "p1q2r3...", "sort_order": 1}]}'

Response

{
  "result": "yes",
  "response": {
    "reordered": 2,
    "list_id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5"
  },
  "current_api_version": "1.0"
}

Response Fields

Reorder Task Lists

Backwards compatibility: The previous routes (/current/tasks/workspace/{workspace_id}/reorder/ and /current/tasks/share/{share_id}/reorder/) continue to work via automatic redirect.

Auth: Required (JWT). Rate limited.

Request Body (JSON)

Each entry in the order array specifies a task list ID and its new sort order. All task list IDs must belong to the specified workspace or share.

Request Example

curl -X POST "https://api.fast.io/current/workspace/1234567890123456789/tasks/reorder/" \
  -H "Authorization: Bearer {jwt_token}" \
  -H "Content-Type: application/json" \
  -d '{"order": [{"id": "a1b2c3...", "sort_order": 0}, {"id": "d4e5f6...", "sort_order": 1}]}'

Response

{
  "result": "yes",
  "response": {
    "reordered": 2,
    "profile_id": "1234567890123456789"
  },
  "current_api_version": "1.0"
}

Response Fields

Worklogs

Worklogs provide an append-only activity stream attached to entities. Entries are immutable after creation. Interjections are urgent entries that require acknowledgement.

Worklog Entity Types

Entry Types

Priority

Worklog Entry Object

Worklog entries are immutable after creation. The only mutable operation is acknowledging an interjection, which sets acknowledged, acknowledged_at, and updated.

List Worklog Entries

Auth: Required (JWT). Rate limited.

Path Parameters

Query Parameters

Request Example

curl -X GET "https://api.fast.io/current/worklogs/task/x1y2z3a4b5c6d7e8f9g0h1i2j3k4l5/?limit=20&sort=desc" \
  -H "Authorization: Bearer {jwt_token}"

Response

{
  "result": "yes",
  "response": {
    "entries": [
      {
        "id": "w1x2y3z4a5b6c7d8e9f0g1h2i3j4k5",
        "entity_type": "task",
        "entity_id": "x1y2z3a4b5c6d7e8f9g0h1i2j3k4l5",
        "profile_id": "1234567890123456789",
        "author_id": "9876543210987654321",
        "entry_type": "info",
        "content": "Completed initial review of uploaded documents.",
        "priority": "normal",
        "target_id": null,
        "acknowledged": false,
        "acknowledgable": false,
        "acknowledged_at": null,
        "properties": null,
        "created": "2025-06-10T14:30:00+00:00",
        "updated": "2025-06-10T14:30:00+00:00"
      }
    ],
    "pagination": {
      "limit": 20,
      "offset": 0,
      "total": 1
    }
  },
  "current_api_version": "1.0"
}

Append Worklog Entry

Auth: Required (JWT). Rate limited.

Request Body

Request Example

curl -X POST "https://api.fast.io/current/worklogs/task/x1y2z3a4b5c6d7e8f9g0h1i2j3k4l5/append/" \
  -H "Authorization: Bearer {jwt_token}" \
  -d "content=Completed%20initial%20review&entry_type=info"

Response: Returns the created entry under the entry key.

Create Interjection

Auth: Required (JWT). Rate limited.

Request Body

Request Example

curl -X POST "https://api.fast.io/current/worklogs/task/x1y2z3a4b5c6d7e8f9g0h1i2j3k4l5/interjection/" \
  -H "Authorization: Bearer {jwt_token}" \
  -d "content=STOP%3A%20The%20uploaded%20contract%20has%20incorrect%20terms&target_id=9876543210987654321"

Response: Returns the created interjection entry under the entry key.

List Unacknowledged Interjections

Auth: Required (JWT). Rate limited.

Get Entry Details

Auth: Required (JWT). Rate limited.

Response: Returns the entry under the entry key.

Acknowledge Interjection

Auth: Required (JWT). Rate limited.

Request Example

curl -X POST "https://api.fast.io/current/worklogs/w1x2y3z4a5b6c7d8e9f0g1h2i3j4k5/acknowledge/" \
  -H "Authorization: Bearer {jwt_token}"

Response: Returns the updated entry with acknowledged: true, acknowledgable: false, acknowledged_at, and updated set.

Acknowledging a standard (non-interjection) entry returns an error. Acknowledging an already-acknowledged interjection returns an error. Worklog entries are append-only and immutable. Once created, they cannot be edited or deleted.

Approvals

Formal approval requests attached to entities (tasks, nodes, or worklog entries). A designated approver or any admin can approve or reject.

Approval Status

Approval Entity Types

Approval Object

List Approvals

Backwards compatibility: The previous routes (/current/approvals/workspace/{workspace_id}/ and /current/approvals/share/{share_id}/) continue to work via automatic redirect.

Auth: Required (JWT). Rate limited.

Query Parameters

Request Example

curl -X GET "https://api.fast.io/current/workspace/1234567890123456789/approvals/?status=pending" \
  -H "Authorization: Bearer {jwt_token}"

Response

{
  "result": "yes",
  "response": {
    "approvals": [
      {
        "id": "r1s2t3u4v5w6x7y8z9a0b1c2d3e4f5",
        "entity_type": "task",
        "entity_id": "x1y2z3a4b5c6d7e8f9g0h1i2j3k4l5",
        "profile_id": "1234567890123456789",
        "requested_by": "9876543210987654321",
        "description": "Please review and approve the deployment plan.",
        "status": "pending",
        "approver_id": "5678901234567890123",
        "resolved_by": null,
        "resolved_at": null,
        "comment": null,
        "deadline": "2025-06-15T23:59:59+00:00",
        "node_id": null,
        "properties": null,
        "created": "2025-06-10T09:00:00+00:00",
        "updated": "2025-06-10T09:00:00+00:00"
      }
    ],
    "pagination": {
      "limit": 50,
      "offset": 0,
      "total": 1
    }
  },
  "current_api_version": "1.0"
}

Create Approval

Auth: Required (JWT). Rate limited.

Path Parameters

Request Body

Request Example

curl -X POST "https://api.fast.io/current/approvals/task/x1y2z3a4b5c6d7e8f9g0h1i2j3k4l5/create/" \
  -H "Authorization: Bearer {jwt_token}" \
  -d "description=Please%20review%20the%20deployment%20plan&profile_id=1234567890123456789&approver_id=5678901234567890123&deadline=2025-06-15T23:59:59%2B00:00"

Response: Returns the created approval under the approval key.

approver_id is a single user (not an array). If omitted, any admin can resolve. There is no title field — use description to describe what is being approved.

Get Approval Details

Auth: Required (JWT). Rate limited.

Response: Returns the approval under the approval key.

Resolve Approval

Auth: Required (JWT). Designated approver or admin. Rate limited.

Request Body

Request Example

curl -X POST "https://api.fast.io/current/approvals/r1s2t3u4v5w6x7y8z9a0b1c2d3e4f5/resolve/" \
  -H "Authorization: Bearer {jwt_token}" \
  -d "action=approve&comment=Looks%20good%2C%20approved."

Response: Returns the resolved approval under the approval key with status, resolved_by, resolved_at, and comment updated.

Access Levels

The field is action (not resolution). Values: "approve" or "reject". Only approvals with "pending" status can be resolved. The resolution comment is stored in comment (not resolution_comment).

Todos

Lightweight checklists scoped to workspaces or shares. Each todo has a title, done state, optional assignee, and sort order.

Todo Object

Todos do not have a description field. The done field is an integer (0 or 1), not a boolean.

List Todos

Backwards compatibility: The previous routes (/current/todos/workspace/{workspace_id}/ and /current/todos/share/{share_id}/) continue to work via automatic redirect.

Auth: Required (JWT). Rate limited.

Query Parameters

Request Example

curl -X GET "https://api.fast.io/current/workspace/1234567890123456789/todos/" \
  -H "Authorization: Bearer {jwt_token}"

Response

{
  "result": "yes",
  "response": {
    "todos": [
      {
        "id": "t1u2v3w4x5y6z7a8b9c0d1e2f3g4h5",
        "profile_id": "1234567890123456789",
        "title": "Review uploaded contracts",
        "done": 0,
        "assignee_id": null,
        "sort_order": 0,
        "properties": null,
        "created": "2025-06-10T09:00:00+00:00",
        "updated": "2025-06-10T09:00:00+00:00",
        "deleted": null
      },
      {
        "id": "u1v2w3x4y5z6a7b8c9d0e1f2g3h4i5",
        "profile_id": "1234567890123456789",
        "title": "Send report to stakeholders",
        "done": 1,
        "assignee_id": "9876543210987654321",
        "sort_order": 1,
        "properties": null,
        "created": "2025-06-09T14:00:00+00:00",
        "updated": "2025-06-10T10:30:00+00:00",
        "deleted": null
      }
    ],
    "pagination": {
      "limit": 50,
      "offset": 0,
      "total": 2
    }
  },
  "current_api_version": "1.0"
}

Create Todo

Backwards compatibility: The previous routes (/current/todos/workspace/{workspace_id}/create/ and /current/todos/share/{share_id}/create/) continue to work via automatic redirect.

Auth: Required (JWT). Rate limited.

Request Body

Request Example

curl -X POST "https://api.fast.io/current/workspace/1234567890123456789/todos/create/" \
  -H "Authorization: Bearer {jwt_token}" \
  -d "title=Review%20uploaded%20contracts"

Response: Returns the created todo under the todo key. Todos are created with done: 0.

Get Todo Details

Auth: Required (JWT). Rate limited.

Response: Returns the todo under the todo key.

Update Todo

Auth: Required (JWT). Rate limited.

Request Body

The endpoint path includes /details/ (i.e., /todos/{todo_id}/details/update/).

Delete Todo

Auth: Required (JWT). Rate limited.

Toggle Todo

Auth: Required (JWT). Rate limited.

Request Example

curl -X POST "https://api.fast.io/current/todos/t1u2v3w4x5y6z7a8b9c0d1e2f3g4h5/details/toggle/" \
  -H "Authorization: Bearer {jwt_token}"

Response: Returns the updated todo under the todo key with the toggled done value.

Bulk Toggle Todos

Backwards compatibility: The previous routes (/current/todos/workspace/{workspace_id}/bulk-toggle/ and /current/todos/share/{share_id}/bulk-toggle/) continue to work via automatic redirect.

Auth: Required (JWT). Rate limited.

Request Body

Request Example

curl -X POST "https://api.fast.io/current/workspace/1234567890123456789/todos/bulk-toggle/" \
  -H "Authorization: Bearer {jwt_token}" \
  -H "Content-Type: application/json" \
  -d '{"todo_ids": ["t1u2v3...", "u1v2w3..."], "done": true}'

Response

{
  "result": "yes",
  "response": {
    "success": true,
    "updated_count": 2,
    "failed_count": 0,
    "total_count": 2,
    "results": [
      {"todo_id": "t1u2v3...", "success": true, "error": null},
      {"todo_id": "u1v2w3...", "success": true, "error": null}
    ]
  },
  "current_api_version": "1.0"
}

Response Fields

Workflow Events

Workflow primitives emit events on all state changes. Filter with:

GET /current/events/search/?workspace_id={id}&category=workflow

Task Events

• task_list_created
• task_list_updated
• task_list_deleted
• task_created
• task_updated
• task_deleted
• task_status_changed
• task_assigned
• task_moved
• task_completed
• tasks_reordered
• task_lists_reordered

Worklog Events

• worklog_entry_created
• worklog_interjection_created
• worklog_interjection_acknowledged

Approval Events

• approval_requested
• approval_approved
• approval_rejected

Todo Events

• todo_created
• todo_toggled
• todo_deleted
• todo_updated

All workflow events use event category workflow and subcategory workflow.