Spaces

Where your data lives: private, shared with you, General, and the spaces you are in.

10 tools — 3 read, 7 write.

Tool		What it does
add_space_member	write	Add a person or a team to a space's roster.
create_space	write	Create a named space — a shared container with its own roster.
delete_space	write	Delete a named space.
get_space	read	Get a space you are in, with its roster (people and teams, each with owner/member role and who added them).
get_space_types	read	Which kinds of items live in your private space ('private') or are shared with you from outside your spaces ('shared').
list_spaces	read	List the spaces you can put things in: General (every org member) and every named space you are in, with your role in each.
move_to_space	write	Move items into a space (or back to your private space with spaceId: null).
remove_space_member	write	Remove a roster row (a person or a team) from a space.
set_space_member_role	write	Promote a roster row to owner or demote it to member.
update_space	write	Rename a space and/or set its swatch color.

Calling these

Over MCP, find one with search_tools, then run it with execute_tool. Over REST, POST /api/capabilities/<tool> with the arguments as the JSON body. Either way, fetch the input schema for the tool you're about to call rather than guessing — get_tool_schema over MCP, or GET /api/capabilities?name=<tool> over REST.

See How the API works for auth, errors and the shared envelope.