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. Workflow GET endpoints support format=md query parameter for Markdown output (AI agent-friendly).

Share access: On shares, only approvals are accessible to guests. Guests see only approvals assigned to them (where approver_id matches their user ID) and can resolve those approvals. Tasks, todos, and worklogs require member or admin access — guests are blocked. Public guests remain blocked from everything. 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

On shares, only approvals are accessible to guests. Guests see only approvals assigned to them (where approver_id matches their user ID). Tasks, todos, and worklogs require member or admin access. Update, delete, and bulk delete require member or admin permissions — guests are blocked.

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

The assignee_id can refer to a pending member (an invited user who has not yet signed up). Pending members have a valid user ID and can be assigned to tasks before they create their account. When the user claims their account, the assignment is preserved.

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, worklog entries, or shares). 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",
        "version_id": null,
        "version_match": null,
        "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. The profile (workspace/share) is determined by the URL path.

Path Parameters

Request Body

Request Example

curl -X POST "https://api.fast.io/current/share/12345678901234567890/approvals/create/" \
  -H "Authorization: Bearer {jwt_token}" \
  -d "entity_type=task&entity_id=x1y2z3a4b5c6d7e8f9g0h1i2j3k4l5&description=Please%20review%20the%20deployment%20plan&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. The approver must be a member of or invited guest to the workspace/share. There is no title field — use description to describe what is being approved.

approver_id can refer to a pending member (an invited user who has not yet signed up). The approval is created with the pending member as the designated approver. When the user claims their account, the approval assignment is preserved.

For entity_type "share", the entity_id must be a valid share profile ID matching the share in the URL. Only shares are accepted — workspaces, orgs, and users are rejected. Only share members and admins can create (guests are blocked). The share must be active (not archived or disabled).

For entity_type "node", the current file version is automatically captured as version_id. This allows consumers to detect when a file has been updated since the approval was requested.

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/share/12345678901234567890/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. Stale approvals (version_match = false) cannot be resolved — returns error "This approval is stale". Create a new approval for the updated file version. The resolution comment is stored in comment (not resolution_comment).

Update Approval

Auth: Required (JWT). Members and admins only (guests blocked). Rate limited.

Request Body (all fields optional, at least one required)

Request Example

curl -X POST "https://api.fast.io/current/share/12345678901234567890/approvals/r1s2t3u4v5w6x7y8z9a0b1c2d3e4f5/update/" \
  -H "Authorization: Bearer {jwt_token}" \
  -d "description=Updated%20review%20request&deadline=2025-07-01T23:59:59%2B00:00"

Response: Returns the updated approval under the approval key with version_match computed.

Only pending approvals can be updated. Resolved approvals return an error. The status, entity_type, entity_id, and profile_id fields cannot be changed. At least one updatable field must be provided.

Delete Approval

Auth: Required (JWT). Members and admins only (guests blocked). Rate limited.

Request Example

curl -X POST "https://api.fast.io/current/share/12345678901234567890/approvals/r1s2t3u4v5w6x7y8z9a0b1c2d3e4f5/delete/" \
  -H "Authorization: Bearer {jwt_token}"

Response:

{
  "result": true,
  "deleted": true,
  "approval_id": "r1s2t3u4v5w6x7y8z9a0b1c2d3e4f5"
}

Deletion is permanent and irreversible. Both pending and resolved approvals can be deleted.

Bulk Approval Operations

Auth: Required (JWT). Bulk create and bulk delete require member or admin. Bulk approve/reject is accessible to guests but only processes approvals assigned to them (where approver_id matches their user ID). Rate limited.

Path Parameters

Bulk Create (action = "create")

Creates node approvals for every file and note in a share. Auto-captures version_id for each node. Limited to shares with 1–50 file/note nodes; rejected if >50 or 0 nodes found. Best-effort: creates as many as possible.

Response:

{
  "result": "yes",
  "response": {
    "action": "create",
    "profile_id": "12345678901234567890",
    "created_count": 5,
    "failed_count": 0,
    "total_nodes": 5,
    "approvals": ["a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5"]
  },
  "current_api_version": "1.0"
}

Bulk Approve (action = "approve")

Approves all pending approvals in a share. Atomic resolution (race-safe). Skips already-resolved and stale approvals (where the file has been updated since the approval was created). Stale approvals increment skipped_count.

Response:

{
  "result": "yes",
  "response": {
    "action": "approve",
    "profile_id": "12345678901234567890",
    "approved_count": 4,
    "failed_count": 0,
    "skipped_count": 1
  },
  "current_api_version": "1.0"
}

Bulk Reject (action = "reject")

Same as bulk approve but rejects. Response uses rejected_count instead of approved_count.

Response:

{
  "result": "yes",
  "response": {
    "action": "reject",
    "profile_id": "12345678901234567890",
    "rejected_count": 3,
    "failed_count": 0,
    "skipped_count": 2
  },
  "current_api_version": "1.0"
}

Bulk Delete (action = "delete")

Deletes all approvals in a share (both pending and resolved), up to 500. Best effort. Members and admins only — guests blocked.

Response:

{
  "result": "yes",
  "response": {
    "action": "delete",
    "deleted_count": 12,
    "failed_count": 0,
    "total": 12
  },
  "current_api_version": "1.0"
}

User Approvals List

List approvals for the authenticated user across all profiles. No specific workspace or share membership required -- returns approvals across all profiles where the user is involved.

Auth: Required (JWT). Rate limited.

Path Parameters

Filter Behavior

Query Parameters

Request Example

curl -X GET "https://api.fast.io/current/user/approvals/list/pending/?limit=25" \
  -H "Authorization: Bearer {jwt_token}"

Response

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

No specific share or workspace membership is needed. The filter value is included in the pagination object. For the created filter, the optional status query parameter narrows results to a specific status. For pending and resolved filters, results are based on the approver_id matching the authenticated user.

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.

The assignee_id can refer to a pending member (an invited user who has not yet signed up). Pending members have a valid user ID and can be assigned to todos before they create their account. When the user claims their account, the assignment is preserved.

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

Profile-Scoped Filtered Lists & Summaries

All four workflow types support profile-scoped filtered list and summary endpoints. Workspace context provides a personal view (filtered to the current user). Share context provides a group view for owners (all items) and a scoped view for guests (approvals assigned to them only). Tasks, todos, and worklogs on shares are restricted to members and admins. All endpoints support ?limit= (default 50, max 100) and ?offset= (default 0).

Approval Filtered Lists

Approval Summaries

Task Filtered Lists

Task Summaries

Todo Filtered Lists

Todo Summaries

Worklog Base Listing

Worklog Filtered Lists

Worklog Summaries

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.