Checking authentication...

Workspaces

Create and manage workspaces

8 tools

List Workspaces

Read Idempotent

POST /v1/tools/tape/listWorkspaces

List all workspaces in the Tape organization you have access to. Returns workspace_id, name, type, and member count for each workspace. No parameters required. Use workspace_id from results with tape_listApps(workspace_id) to find apps in a specific workspace.

Request

curl -X POST https://api.syncello.io/v1/tools/tape/listWorkspaces \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response

{
  "workspaces": [
    {
      "workspace_id": 12345,
      "org_id": 111,
      "name": "CRM & Communications",
      "description": "",
      "slug": "crm",
      "icon": {
        "type": "graphic",
        "id": "contact_page",
        "color": "gray"
      },
      "type": "private"
    },
    {
      "workspace_id": 12346,
      "org_id": 111,
      "name": "Client Management",
      "description": "",
      "slug": "clients",
      "type": "open"
    }
  ],
  "total": 2
}

Try It

Try it

Get Workspace

Read Idempotent

POST /v1/tools/tape/getWorkspace

Get details for a specific Tape workspace by workspace_id. Returns workspace name, type, description, and member information. Convenience wrapper that filters listWorkspaces results to a single workspace.

Parameters

Name	Type	Required	Description
`workspace_id`	number	required	The workspace ID to retrieve (from listWorkspaces or platform context).

Request

curl -X POST https://api.syncello.io/v1/tools/tape/getWorkspace \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "workspace_id": "123"
}'

Response

{
  "workspace_id": 500100,
  "org_id": 44001,
  "name": "Sales",
  "description": "",
  "slug": "sales",
  "icon": {
    "type": "graphic",
    "id": "contact_page",
    "color": "gray"
  },
  "type": "private"
}

Try It

Try it

Create Workspace

Write

POST /v1/tools/tape/createWorkspace

Create a new workspace in the Tape organization. Workspace types control membership: "private" (invite-only), "open" (any org member can join), "default" (org default visibility), "closed" (read-only for non-members). Use tape_listWorkspaces first to see existing workspaces and avoid duplicates.

Parameters

Name	Type	Required	Description
`name`	string	required	Display name of the workspace.
`type`	string	required	Workspace type: "private" (invite-only), "open" (anyone can join), "default" (org default), "closed" (read-only for non-members). Values: private, open, default, closed
`description`	string	optional	Optional description of the workspace.

Request

curl -X POST https://api.syncello.io/v1/tools/tape/createWorkspace \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "name": "example",
  "type": "private"
}'

Response

{
  "workspace_id": 500126,
  "org_id": 44001,
  "name": "Marketing",
  "slug": "marketing",
  "type": "private"
}

Try It

Try it

Update Workspace

Write

POST /v1/tools/tape/updateWorkspace

Update a Tape workspace name and/or description. Only include the properties you want to change — omitted properties remain unchanged. Use tape_getWorkspace first to verify current values.

Parameters

Name	Type	Required	Description
`workspace_id`	number	required	The workspace ID to update (from listWorkspaces or platform context).
`name`	string	optional	New workspace name (only if changing).
`description`	string	optional	New workspace description (only if changing).

Request

curl -X POST https://api.syncello.io/v1/tools/tape/updateWorkspace \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "workspace_id": "123"
}'

Response

{
  "workspace_id": 500100,
  "org_id": 44001,
  "name": "Sales",
  "description": "Deals, quotes, and pipeline tracking",
  "slug": "sales",
  "type": "private"
}

Try It

Try it

List Workspace Members

Read Idempotent

POST /v1/tools/tape/listWorkspaceMembers

List all members of a Tape workspace with their user_id, name, email, and role (member/admin). Use this to find user_ids before adding/removing members, or before setting user fields in records.

Parameters

Name	Type	Required	Description
`workspace_id`	number	required	The workspace ID to list members for (from listWorkspaces or platform context).

Request

curl -X POST https://api.syncello.io/v1/tools/tape/listWorkspaceMembers \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "workspace_id": "123"
}'

Response

{
  "workspace_members": [
    {
      "user_id": 4820193,
      "workspace_id": 500100,
      "role": "admin"
    },
    {
      "user_id": 4820194,
      "workspace_id": 500100,
      "role": "member"
    }
  ]
}

Try It

Try it

Add Workspace Member

Write

POST /v1/tools/tape/addWorkspaceMember

Add a user to a Tape workspace or update an existing member's role. The user must already be in the organization. Roles: "member" (standard access) or "admin" (full workspace management). Also use this to change an existing member from "member" to "admin" or vice versa.

Parameters

Name	Type	Required	Description
`workspace_id`	number	required	The workspace ID (from listWorkspaces or platform context).
`user_id`	number	required	The user ID to add (from listWorkspaceMembers, getOrganization, or platform context). Must be an existing org member.
`role`	string	required	Role to assign: "member" (standard access) or "admin" (full management).

Request

curl -X POST https://api.syncello.io/v1/tools/tape/addWorkspaceMember \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "workspace_id": "123",
  "user_id": "123",
  "role": "example"
}'

Response

{
  "user_id": 4820194,
  "workspace_id": 500100,
  "role": "member"
}

Try It

Try it

Remove Workspace Member

Destructive

POST /v1/tools/tape/removeWorkspaceMember

Remove a user from a Tape workspace. The user loses access to all apps and records in the workspace. They remain in the organization. Use tape_listWorkspaceMembers first to verify the user_id.

Parameters

Name	Type	Required	Description
`workspace_id`	number	required	The workspace ID (from listWorkspaces or platform context).
`user_id`	number	required	The user ID to remove (from listWorkspaceMembers).

Request

curl -X POST https://api.syncello.io/v1/tools/tape/removeWorkspaceMember \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "workspace_id": "123",
  "user_id": "123"
}'

Response

{}

Try It

Try it

Delete Workspace

Destructive

POST /v1/tools/tape/deleteWorkspace

Permanently delete a Tape workspace and ALL its apps and records. This action CANNOT be undone. Use tape_getWorkspace first to verify you have the correct workspace.

Parameters

Name	Type	Required	Description
`workspace_id`	number	required	The workspace ID to delete (from listWorkspaces or platform context).

Request

curl -X POST https://api.syncello.io/v1/tools/tape/deleteWorkspace \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json"
  -d '{
  "workspace_id": "123"
}'

Response

{
  "workspace_id": 500126,
  "org_id": 44001,
  "name": "Marketing",
  "description": "Marketing team workspace",
  "slug": "marketing",
  "type": "private"
}