Workspaces
A workspace is a user's project in TOM. It holds saved elements (tabulations, Reach tables, targets and user variables, created in the TOM web application or through this API) and the surveys attached to it, and can be shared with other users. List, inspect and create workspaces, attach surveys to them, and turn a saved element into a request you can calculate again. A workspace's id and its elements' ids are the workspaceId and elementId of the workspace endpoints.
📄️ Create a workspace
Creates an empty workspace owned by the caller and returns its identifier.
📄️ Get a workspace
Returns a workspace with the saved elements you can reuse through the API and the surveys attached to it.
📄️ Delete a workspace
Deletes a workspace you own, together with everything it contains, and answers `204` without a body.
📄️ Get a workspace element as a reusable request
Returns a saved workspace element converted to the request format of this API, so that you can inspect it, modify it and send it again.
📄️ Delete an element of a workspace
Deletes one element of a workspace you own and answers `204` without a body. The element also disappears from the menu of the workspace.
📄️ Add a survey to a workspace
Attaches a survey to a workspace so that it appears in the list of surveys of the workspace.
📄️ List workspaces
Returns every workspace the caller can open: the ones they own and the ones other users have shared with them. The list is complete and is not paginated.