Workspace Management Create, configure, and manage workspaces within organizations. Control members, assets, shares, and AI intelligence settings.

Workspaces are shared project spaces within an organization. They support file versioning, search, AI chat, and member management. Most workspace endpoints also accept the workspace's folder_name (e.g., my-project) in place of the numeric ID.

Endpoint Summary

Workspace CRUD

Assets

Members

Invitations

Shares (in workspace context)

Cloud Import

Workflow

Task Lists (Workflow)

Todos (Workflow)

Approvals (Workflow)

Discovery

Compact Responses (output=)

Every endpoint that returns one or more workspace objects (details, list, discovery) accepts an optional output query parameter that selects the response shape. A single detail-level token may be combined with modifier tokens; specifying two detail levels (e.g. ?output=terse,standard) returns HTTP 400. When output= is omitted, responses are full and byte-for-byte unchanged.

Use terse for workspace switchers, autocomplete, and org-scoped navigation — it carries the identifier, display name, folder slug, parent org domain, and user_status so the two-column "Joined vs. Available" workspace list can render and the join button can enable/disable without a follow-up fetch. Use standard for workspace list views and the summary area of workspace detail pages — it adds lifecycle flags (including the locked admin-only chip), storage usage, timestamps, description, the workspace's visual identity (logo, accent_color), plus the intelligence/workflow feature toggles and the plan-gate capabilities bundle so list rows can differentiate "enabled but plan-locked" from "usable." Use full (or omit the parameter) for the workspace settings screen, branding editors, and any workflow that reads permission matrices or remaining feature blocks (comments, chat, search, assets, workflow_permissions). Unknown tokens are silently ignored. Add the markdown modifier (e.g. ?output=standard,markdown) to receive the response as GitHub-flavored Markdown (Content-Type: text/markdown; charset=UTF-8) instead of JSON — see the cross-cutting ?output= reference for the full contract.

Field Constraints

Permission Values

perm_join — who can self-join from the parent org

perm_member_manage — who can manage workspace members

Permission Levels (numeric hierarchy)

Intelligence Setting

The intelligence boolean on a workspace controls whether uploaded files are automatically indexed for RAG (retrieval-augmented generation).

• Enable (intelligence=true) — files are auto-indexed for semantic search, summarization, and citation. Required for chat_with_files AI chat type. Requires both the content_ai and ai_agent plan features. Plans that lack either feature cannot set intelligence=true; the API rejects the create/update request with 1605 (Invalid Input).
• Disable (intelligence=false) — files are stored/shared without RAG indexing. You can still attach files directly to a chat type conversation for one-off analysis on plans that support chat.
• Set at creation: POST /current/org/{org_id}/create/workspace/ with intelligence=true|false
• Update later: POST /current/workspace/{id}/update/ with intelligence=true|false
• Can be enabled and disabled within time restrictions. Disabling intelligence destroys indexed embeddings (the vector index is flushed). Re-enabling intelligence incurs re-indexing costs as AI credits are consumed to re-index all files.
• Agent-account default: On plans that include ai_agent, new workspaces created by agent accounts default intelligence=true if the parameter is omitted. On plans without ai_agent (including the free agent plan), the default is false because the indexing pipeline has no consumer. See the AI reference for the full plan matrix.

Workspace CRUD

Create Workspace

Auth: JWT required. Org membership (Member or above) required.

Path Parameters

Request Parameters

Example

curl -X POST "https://api.fast.io/current/org/10000000000000000001/create/workspace/" \
  -H "Authorization: Bearer {jwt_token}" \
  -d "folder_name=engineering" \
  -d "name=Engineering Team" \
  -d "description=Main engineering workspace for the team" \
  -d "perm_join=Member or above" \
  -d "perm_member_manage=Admin or above" \
  -d "intelligence=true"

Response (200 OK)

{
  "result": "yes",
  "response": {
    "workspace": {
      "id": "12345678901234567890",
      "folder_name": "engineering"
    }
  },
  "current_api_version": "1.0"
}

Response Fields

Access Levels

Error Responses

Get Workspace Details

Auth: JWT required. Workspace membership required (View or above).

Path Parameters

Example

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

Response (200 OK)

{
  "result": "yes",
  "response": {
    "workspace": {
      "id": "12345678901234567890",
      "name": "Engineering Team",
      "folder_name": "engineering",
      "description": "Main engineering workspace",
      "accent_color": "#0066CC",
      "logo": "https://assets.fast.io/12345678901234567890/logo.png",
      "closed": false,
      "archived": false,
      "perm_join": "Member or above",
      "perm_member_manage": "Admin or above",
      "created": "2023-01-15 10:30:00",
      "updated": "2024-01-20 14:45:00",
      "user_status": "joined",
      "org_domain": "acme-corp"
    }
  },
  "current_api_version": "1.0"
}

Response Fields

Access Levels

Error Responses

Update Workspace

Auth: JWT required. Admin or Owner required.

Path Parameters

Request Parameters (all optional)

Example

curl -X POST "https://api.fast.io/current/workspace/12345678901234567890/update/" \
  -H "Authorization: Bearer {jwt_token}" \
  -d "name=Updated Workspace Name" \
  -d "description=New description for the workspace" \
  -d "perm_join=Admin or above"

Response (200 OK)

{
  "result": "yes",
  "current_api_version": "1.0"
}

Error Responses

If no fields have changed, returns 200 OK without making changes. JSON fields are decoded server-side; send valid JSON strings.

Delete Workspace

Auth: JWT required. Owner only. 2FA required.

Path Parameters

Query Parameters

Example

curl -X DELETE "https://api.fast.io/current/workspace/12345678901234567890/delete/?confirm=engineering" \
  -H "Authorization: Bearer {jwt_token}"

Response (202 Accepted)

{
  "result": "yes",
  "current_api_version": "1.0"
}

Error Responses

Archive Workspace

Auth: JWT required. Admin or Owner required. 2FA required.

Example

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

Response (202 Accepted)

{
  "result": "yes",
  "current_api_version": "1.0"
}

Error Responses

Unarchive Workspace

Auth: JWT required. Admin or Owner required. 2FA required.

Example

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

Response (202 Accepted)

{
  "result": "yes",
  "current_api_version": "1.0"
}

Error Responses

Workspace Assets

List Available Asset Types

Auth: JWT required.

Example

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

Response (200 OK)

{
  "result": "yes",
  "response": {
    "assets": [
      {
        "name": "logo",
        "type": "image",
        "max_size": 5242880,
        "accepted_formats": ["image/png", "image/jpeg", "image/svg+xml"]
      }
    ]
  },
  "current_api_version": "1.0"
}

List Workspace Assets

Auth: JWT required. Owner only. 2FA required.

Example

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

Response (200 OK)

{
  "result": "yes",
  "response": {
    "assets": {
      "logo": {
        "url": "https://assets.fast.io/12345678901234567890/logo.png",
        "size": 102400,
        "content_type": "image/png"
      }
    }
  },
  "current_api_version": "1.0"
}

Upload/Set Workspace Asset

Auth: JWT required. Admin or Owner required.

Path Parameters

Request Body (multipart/form-data)

Example

curl -X POST "https://api.fast.io/current/workspace/12345678901234567890/assets/logo/" \
  -H "Authorization: Bearer {jwt_token}" \
  -F "file=@/path/to/logo.png" \
  -F "metadata={}"

Response (200 OK)

{
  "result": "yes",
  "response": {
    "asset": {
      "name": "logo",
      "url": "https://assets.fast.io/12345678901234567890/logo.png"
    }
  },
  "current_api_version": "1.0"
}

Error Responses

Delete Workspace Asset

Auth: JWT required. Admin or Owner required.

Example

curl -X DELETE "https://api.fast.io/current/workspace/12345678901234567890/assets/logo/" \
  -H "Authorization: Bearer {jwt_token}"

Response (200 OK)

{
  "result": "yes",
  "current_api_version": "1.0"
}

Read Asset Binary

Auth: JWT required. Any workspace member. 2FA required.

Example

# Download asset
curl -X GET "https://api.fast.io/current/workspace/12345678901234567890/assets/logo/read/" \
  -H "Authorization: Bearer {jwt_token}" \
  --output logo.png

# Get metadata headers only
curl -I "https://api.fast.io/current/workspace/12345678901234567890/assets/logo/read/" \
  -H "Authorization: Bearer {jwt_token}"

Response: Raw binary content with appropriate Content-Type header (not JSON).

Workspace Members

Add or Invite a Member

Auth: JWT required. Permission depends on workspace perm_member_manage setting.

Path Parameters

Request Parameters (adding by user ID)

Request Parameters (inviting by email)

Examples

# Add existing user by ID
curl -X POST "https://api.fast.io/current/workspace/12345678901234567890/members/98765432109876543210/" \
  -H "Authorization: Bearer {jwt_token}" \
  -d "permissions=member"

# Invite by email
curl -X POST "https://api.fast.io/current/workspace/12345678901234567890/members/newuser@example.com/" \
  -H "Authorization: Bearer {jwt_token}" \
  -d "permissions=member" \
  -d "message=Welcome to the project!"

Response — Direct Add (200 OK)

{
  "result": "yes",
  "current_api_version": "1.0"
}

Response — Invitation Sent (200 OK)

{
  "result": "yes",
  "response": {
    "invitation": {
      "id": "12345678901234567890",
      "inviter": "John Doe",
      "invitee_email": "newuser@example.com",
      "entity_type": "workspace",
      "state": "pending",
      "created": "2025-01-15 10:30:00",
      "expires": "2025-02-15 10:30:00"
    }
  },
  "current_api_version": "1.0"
}

Error Responses

Adding a user to a workspace may also auto-add them to the parent organization if the workspace is configured for automatic org membership.

Remove a Member

Auth: JWT required. Permission depends on perm_member_manage.

Example

curl -X DELETE "https://api.fast.io/current/workspace/12345678901234567890/members/98765432109876543210/" \
  -H "Authorization: Bearer {jwt_token}"

Response (200 OK)

{
  "result": "yes",
  "current_api_version": "1.0"
}

Error Responses

Removing a member cascades removal into all shares within the workspace.

List Workspace Members

Auth: JWT required. Any workspace member.

Example

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

Response (200 OK)

{
  "result": "yes",
  "response": {
    "users": [
      {
        "id": "12345678901234567890",
        "account_type": "human",
        "email_address": "owner@example.com",
        "first_name": "Alice",
        "last_name": "Johnson",
        "permissions": "owner",
        "invite": "accepted",
        "notify": "Email me",
        "expires": null
      },
      {
        "id": "98765432109876543210",
        "account_type": "agent",
        "email_address": "bot@example.com",
        "first_name": "Sync",
        "last_name": "Bot",
        "permissions": "member",
        "invite": "accepted",
        "notify": "Notify me in app",
        "expires": "2025-12-31 23:59:59"
      }
    ]
  },
  "current_api_version": "1.0"
}

Response Fields

Leave Workspace (Self)

Auth: JWT required.

Example

curl -X DELETE "https://api.fast.io/current/workspace/12345678901234567890/member/" \
  -H "Authorization: Bearer {jwt_token}"

Response (200 OK)

{
  "result": "yes",
  "current_api_version": "1.0"
}

Error Responses

Get Member Details

Auth: JWT required. Any workspace member.

Example

curl -X GET "https://api.fast.io/current/workspace/12345678901234567890/member/98765432109876543210/details/" \
  -H "Authorization: Bearer {jwt_token}"

Response (200 OK)

{
  "result": "yes",
  "response": {
    "member": {
      "id": "98765432109876543210",
      "account_type": "human",
      "email_address": "user@example.com",
      "first_name": "Jane",
      "last_name": "Smith",
      "permissions": "member",
      "invite": "accepted",
      "notify": "Notify me in app",
      "expires": null
    }
  },
  "current_api_version": "1.0"
}

Response Fields

Error Responses

Update a Member

Auth: JWT required. Permission depends on perm_member_manage.

Request Parameters (all optional)

Example

curl -X POST "https://api.fast.io/current/workspace/12345678901234567890/member/98765432109876543210/update/" \
  -H "Authorization: Bearer {jwt_token}" \
  -d "permissions=admin"

Response (200 OK)

{
  "result": "yes",
  "current_api_version": "1.0"
}

Error Responses

Users cannot escalate permissions beyond their own level.

Transfer Workspace Ownership

Auth: JWT required. Owner only.

Example

curl -X POST "https://api.fast.io/current/workspace/12345678901234567890/member/98765432109876543210/transfer_ownership/" \
  -H "Authorization: Bearer {jwt_token}"

Response (200 OK)

{
  "result": "yes",
  "current_api_version": "1.0"
}

Error Responses

Join Workspace

Auth: JWT required.

Request Parameters

Example

curl -X POST "https://api.fast.io/current/workspace/12345678901234567890/members/join/" \
  -H "Authorization: Bearer {jwt_token}"

Response (200 OK)

{
  "result": "yes",
  "current_api_version": "1.0"
}

Error Responses

Self-joining members are assigned the member role. Only notification preferences are accepted. Self-joined memberships do not expire.

Join Workspace via Invitation

Auth: JWT required.

Path Parameters

Example

curl -X POST "https://api.fast.io/current/workspace/12345678901234567890/members/join/abc123def456/accept/" \
  -H "Authorization: Bearer {jwt_token}"

Response (200 OK)

{
  "result": "yes",
  "current_api_version": "1.0"
}

Error Responses

The system validates the inviter still has sufficient permissions at acceptance time. Accepting may also auto-add the user to the parent organization.

Pending Members

When a user is invited to a workspace by email but does not yet have a Fast.io account, they appear as a pending member in the member list. Pending members are placeholders that allow teams to pre-assign workflow items before the invitee signs up.

How pending members appear in responses:

• The status field is "pending" (vs "active" for registered users).
• An invite object is included with basic invitation details (id, created, expires).
• email_address shows the invited email address.
• first_name is set to the invited email address; last_name is empty.

Example Member List Entry (Pending)

{
  "id": "55667788990011223344",
  "account_type": "human",
  "email_address": "newuser@example.com",
  "first_name": "newuser@example.com",
  "last_name": "",
  "permissions": "member",
  "status": "pending",
  "invite": {
    "id": "55667788990011223344",
    "created": "2025-01-15 10:30:00",
    "expires": "2025-02-15 10:30:00"
  },
  "notify": "Notify me in app",
  "expires": null
}

Workflow assignments: Pending members can be assigned to tasks, approvals, and todos before they create an account. Their user ID is valid and works with all assignment endpoints.

Account claim: When the invited user signs up or accepts the invitation with an existing account, their status transitions from "pending" to "active". All existing workflow assignments (tasks, approvals, todos) are preserved and transfer automatically.

Removal: To remove a pending member, delete their invitation using the invitation endpoints (see Workspace Invitations below). Deleting the invitation removes the pending member and unassigns any workflow items associated with them.

Notifications: Pending members do not receive in-app or email notifications until they claim their account.

Workspace Invitations

List Workspace Invitations

Auth: JWT required. Any workspace member.

Example

curl -X GET "https://api.fast.io/current/workspace/12345678901234567890/members/invitations/list/" \
  -H "Authorization: Bearer {jwt_token}"

Response (200 OK)

{
  "result": "yes",
  "response": {
    "invitations": [
      {
        "id": "12345678901234567890",
        "inviter": "Alice Johnson",
        "invitee_email": "newuser@example.com",
        "invitee_uid": null,
        "accepted_uid": null,
        "entity_type": "workspace",
        "workspace": {
          "id": "98765432109876543210",
          "name": "Project Alpha"
        },
        "state": "pending",
        "created": "2025-01-15 10:30:00",
        "updated": "2025-01-15 10:30:00",
        "expires": "2025-02-15 10:30:00"
      }
    ]
  },
  "current_api_version": "1.0"
}

Response Fields

List Invitations by State

Auth: JWT required. Any workspace member.

Path Parameters

Example

curl -X GET "https://api.fast.io/current/workspace/12345678901234567890/members/invitations/list/pending/" \
  -H "Authorization: Bearer {jwt_token}"

Response: Same format as List Workspace Invitations, filtered by state.

Error Responses

Update an Invitation

Auth: JWT required. Permission depends on perm_member_manage.

Request Parameters (all optional)

Examples

# Revoke by ID
curl -X POST "https://api.fast.io/current/workspace/12345678901234567890/members/invitation/11111111111111111111/" \
  -H "Authorization: Bearer {jwt_token}" \
  -d "state=revoked"

# Update by email
curl -X POST "https://api.fast.io/current/workspace/12345678901234567890/members/invitation/user@example.com/" \
  -H "Authorization: Bearer {jwt_token}" \
  -d "permissions=admin"

Response (200 OK)

{
  "result": "yes",
  "current_api_version": "1.0"
}

Error Responses

Delete an Invitation

Auth: JWT required. Permission depends on perm_member_manage.

Example

curl -X DELETE "https://api.fast.io/current/workspace/12345678901234567890/members/invitation/11111111111111111111/" \
  -H "Authorization: Bearer {jwt_token}"

Response (200 OK)

{
  "result": "yes",
  "current_api_version": "1.0"
}

Error Responses

Creating Shares from Workspaces

Create Share

Auth: JWT required. Admin or Owner required.

For full share management documentation, see Shares reference.

Required Parameters

Optional Parameters

Access Options (access_options)

Example

curl -X POST "https://api.fast.io/current/workspace/12345678901234567890/create/share/" \
  -H "Authorization: Bearer {jwt_token}" \
  -d "title=Client Deliverables" \
  -d "share_type=send" \
  -d "intelligence=true" \
  -d "access_options=Anyone with a registered account" \
  -d "invite=owners"

Response (200 OK)

{
  "result": "yes",
  "response": {
    "share": {
      "id": "98765432109876543210",
      "custom_name": "abc123opaque",
      "storage_mode": "independent"
    }
  },
  "current_api_version": "1.0"
}

Response — Workspace Folder Share

{
  "result": "yes",
  "response": {
    "share": {
      "id": "98765432109876543210",
      "custom_name": "def456opaque",
      "storage_mode": "workspace_folder",
      "folder_node_id": "abc123def456"
    }
  },
  "current_api_version": "1.0"
}

Response Fields

Error Responses

List Shares in Workspace

Auth: JWT required. View or above.

Query Parameters

Example

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

Response (200 OK)

{
  "result": "yes",
  "response": {
    "shares": [
      {
        "id": "98765432109876543210",
        "title": "Client Deliverables",
        "share_type": "send",
        "custom_name": "client-deliverables",
        "archived": false,
        "closed": false
      }
    ]
  },
  "current_api_version": "1.0"
}

Import Share into Workspace

Auth: JWT required. Must be workspace member AND share owner.

Path Parameters

Example

curl -X POST "https://api.fast.io/current/workspace/12345678901234567890/import/share/98765432109876543210/" \
  -H "Authorization: Bearer {jwt_token}"

Response (200 OK)

{
  "result": "yes",
  "response": {
    "share": {
      "id": "98765432109876543210",
      "parent_type": "workspace",
      "parent_workspace": "12345678901234567890"
    }
  },
  "current_api_version": "1.0"
}

Error Responses

Share must be user-owned (not already in another workspace). User must be the sole owner. Multiple owners must be removed first. Archived shares are auto-unarchived during import.

Workspace Discovery

List All Workspaces

Auth: JWT required.

Example

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

Response (200 OK)

{
  "result": "yes",
  "response": {
    "workspaces": [
      {
        "id": "12345678901234567890",
        "name": "Engineering Team",
        "folder_name": "engineering",
        "description": "Main engineering workspace",
        "accent_color": "#0066CC",
        "logo": "https://assets.fast.io/12345678901234567890/logo.png",
        "closed": false,
        "archived": false,
        "perm_join": "Member or above",
        "perm_member_manage": "Admin or above",
        "created": "2023-01-15 10:30:00",
        "updated": "2024-01-20 14:45:00",
        "user_status": "joined",
        "org_domain": "acme-corp"
      }
    ]
  },
  "current_api_version": "1.0"
}

Response Fields

Spans all organizations the user belongs to. Workspaces from orgs without active subscriptions are filtered out.

List Available Workspaces

Auth: JWT required.

Example

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

Response: Same structure as List All Workspaces, but only includes un-joined workspaces.

Check Workspace Name

Auth: JWT required. Org membership (Member or above) required. 2FA required.

Path Parameters

Example

curl -X GET "https://api.fast.io/current/workspaces/check/name/engineering/" \
  -H "Authorization: Bearer {jwt_token}"

Response — Name Available (202 Accepted)

{
  "result": "yes",
  "current_api_version": "1.0"
}

Error Responses

Checks globally across all workspaces, not just the current org. Returns 202 Accepted (not 200 OK) when the name is available.

List Workspaces in Org

Auth: JWT required.

Path Parameters

Query Parameters

Example

curl -X GET "https://api.fast.io/current/org/10000000000000000001/list/workspaces/?limit=50&offset=0" \
  -H "Authorization: Bearer {jwt_token}"

Response (200 OK)

{
  "result": "yes",
  "response": {
    "workspaces": [
      {
        "id": "12345678901234567890",
        "folder_name": "engineering",
        "name": "Engineering Team",
        "description": "Main project workspace"
      }
    ],
    "pagination": {
      "total": 5,
      "limit": 50,
      "offset": 0,
      "has_more": false
    }
  },
  "current_api_version": "1.0"
}

Access Levels

Cloud Import

Enable Cloud Import

Auth: JWT required. Admin or Owner required. Requires the cloud import billing feature.

Path Parameters

Example

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

Response (200 OK)

{
  "result": "yes",
  "response": {
    "message": "Cloud import features enabled",
    "cloud_import": true
  },
  "current_api_version": "1.0"
}

Error Responses

Disable Cloud Import

Auth: JWT required. Admin or Owner required. Requires the cloud import billing feature.

Path Parameters

Example

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

Response (200 OK)

{
  "result": "yes",
  "response": {
    "message": "Cloud import features disabled",
    "cloud_import": false
  },
  "current_api_version": "1.0"
}

Error Responses

Workflow

Enable Workflow

Auth: JWT required. Admin or Owner required. Requires the workflow billing feature.

Path Parameters

Example

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

Response (200 OK)

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

Error Responses

Disable Workflow

Auth: JWT required. Admin or Owner required. Requires the workflow billing feature.

Path Parameters

Example

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

Response (200 OK)

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

Error Responses

Task Lists

Task lists are a workflow feature. Workflow must be enabled on the workspace before using these endpoints. All task list endpoints support Accept: text/markdown for markdown-formatted output.

List Task Lists

Auth: JWT required. View or above. Requires the workflow billing feature.

Path Parameters

Query Parameters

Headers

Example

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

Response (200 OK)

{
  "result": "yes",
  "response": {
    "task_lists": [
      {
        "id": "abc123opaque",
        "profile_id": "12345678901234567890",
        "name": "Sprint Backlog",
        "description": "Current sprint items",
        "created_by": "98765432109876543210",
        "properties": {},
        "sort_order": 0,
        "created": "2026-01-15T10:30:00+00:00",
        "updated": "2026-01-20T14:45:00+00:00",
        "deleted": null
      }
    ],
    "pagination": {
      "limit": 100,
      "offset": 0,
      "total": 1
    }
  },
  "current_api_version": "1.0"
}

Response Fields

Error Responses

Create Task List

Auth: JWT required. View or above. Requires the workflow billing feature.

Path Parameters

Request Body (JSON)

Example

curl -X POST "https://api.fast.io/current/workspace/12345678901234567890/tasks/create/" \
  -H "Authorization: Bearer {jwt_token}" \
  -H "Content-Type: application/json" \
  -d '{"name": "Sprint Backlog", "description": "Current sprint items"}'

Response (200 OK)

{
  "result": "yes",
  "response": {
    "task_list": {
      "id": "abc123opaque",
      "profile_id": "12345678901234567890",
      "name": "Sprint Backlog",
      "description": "Current sprint items",
      "created_by": "98765432109876543210",
      "properties": {},
      "sort_order": 0,
      "created": "2026-01-15T10:30:00+00:00",
      "updated": "2026-01-15T10:30:00+00:00",
      "deleted": null
    }
  },
  "current_api_version": "1.0"
}

Error Responses

Reorder Task Lists

Auth: JWT required. View or above. Requires the workflow billing feature.

Path Parameters

Request Body (JSON)

Example

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

Response (200 OK)

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

Error Responses

Todos

Todos are a workflow feature. Workflow must be enabled on the workspace before using these endpoints. All todo endpoints support Accept: text/markdown for markdown-formatted output.

List Todos

Auth: JWT required. View or above. Requires the workflow billing feature.

Path Parameters

Query Parameters

Headers

Example

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

Response (200 OK)

{
  "result": "yes",
  "response": {
    "todos": [
      {
        "id": "abc123opaque",
        "profile_id": "12345678901234567890",
        "title": "Review pull request",
        "done": 0,
        "assignee_id": "98765432109876543210",
        "sort_order": 0,
        "created_by": "98765432109876543210",
        "properties": null,
        "created": "2026-01-15T10:30:00+00:00",
        "updated": "2026-01-20T14:45:00+00:00",
        "deleted": null
      }
    ],
    "pagination": {
      "limit": 100,
      "offset": 0,
      "total": 1
    }
  },
  "current_api_version": "1.0"
}

Response Fields

Error Responses

Create Todo

Auth: JWT required. View or above. Requires the workflow billing feature.

Path Parameters

Request Body (JSON)

Example

curl -X POST "https://api.fast.io/current/workspace/12345678901234567890/todos/create/" \
  -H "Authorization: Bearer {jwt_token}" \
  -H "Content-Type: application/json" \
  -d '{"title": "Review pull request", "assignee_id": "98765432109876543210"}'

Response (200 OK)

{
  "result": "yes",
  "response": {
    "todo": {
      "id": "abc123opaque",
      "profile_id": "12345678901234567890",
      "title": "Review pull request",
      "done": 0,
      "assignee_id": "98765432109876543210",
      "sort_order": 0,
      "created_by": "98765432109876543210",
      "properties": null,
      "created": "2026-01-15T10:30:00+00:00",
      "updated": "2026-01-15T10:30:00+00:00",
      "deleted": null
    }
  },
  "current_api_version": "1.0"
}

Error Responses

Bulk Toggle Todos

Auth: JWT required. View or above. Requires the workflow billing feature.

Path Parameters

Request Body (JSON)

Example

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

Response (200 OK)

{
  "result": "yes",
  "response": {
    "toggled": 2,
    "done": true
  },
  "current_api_version": "1.0"
}

Error Responses

Approvals

Approvals are a workflow feature. Workflow must be enabled on the workspace before using this endpoint. Supports Accept: text/markdown for markdown-formatted output.

List Approvals

Auth: JWT required. View or above. Requires the workflow billing feature.

Path Parameters

Query Parameters

Headers

Example

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

Response (200 OK)

{
  "result": "yes",
  "response": {
    "approvals": [
      {
        "id": "abc123opaque",
        "entity_type": "file",
        "entity_id": "def456opaque",
        "profile_id": "12345678901234567890",
        "requested_by": "98765432109876543210",
        "description": "Please review this document",
        "status": "pending",
        "approver_id": "11111111111111111111",
        "resolved_by": null,
        "resolved_at": null,
        "comment": null,
        "deadline": "2026-02-01T00:00:00+00:00",
        "node_id": "ghi789opaque",
        "properties": {},
        "created": "2026-01-15T10:30:00+00:00",
        "updated": "2026-01-15T10:30:00+00:00"
      }
    ],
    "pagination": {
      "limit": 100,
      "offset": 0,
      "total": 1
    }
  },
  "current_api_version": "1.0"
}

Response Fields

Error Responses