Agents

Agent identities and their access.

5 tools — 1 read, 4 write.

Tool		What it does
create_agent	write	Create an agent persona you own.
disable_agent	write	Disable an agent you own.
issue_agent_token	write	Mint a nous_pat_ token for one of your agents.
list_agents	read	List the agents you own in this org, with shared-resource count, active token count, and last-active time.
revoke_agent_token	write	Revoke a token belonging to one of your agents.

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.