The Workspaces API lets robot integrations read workspace metadata, manage human and robot memberships, issue invitations, and read billing plan information. Most write operations require the Admin role.
The workspace resource contains the name, slug, and configuration for a Ptolemy workspace. Robot users can read this but only human Admins can modify it.
GET/Get workspaceViewer+▶
Members
Members are the human and robot users with access to a workspace. The /memberships endpoint returns all member types; use /memberships/robots for robot-only operations.
DELETE/memberships/{membershipId}Remove a memberAdmin▶
POST/memberships/filterFilter membersAdmin▶
Robot Users
Robot users are service accounts used for API integrations. See the Authentication page for the full token lifecycle reference. This section covers the membership management endpoints.
POST/memberships/robotsCreate a robot userAdmin▶
GET/memberships/robotsList robot usersAdmin▶
GET/memberships/robots/{userId}Get a robot userAdmin▶
POST/memberships/robots/{userId}/tokensCreate a tokenAdmin▶