SpecifyDocs

Work agent access

/v1/work/shell/agent-access

Signed-in sessionLaunch key product.workOperation work_agent_access

People create, rotate and revoke agent keys, connect an agent over MCP, and confirm that the agent reached their workspace.

Query parameters

expectedAuthorizationVersionstring

Returns

canManagefalse | trueRequired
evaluatedAtnumberRequired
permission"not_permitted" | "permitted"Required
countnull | numberRequired
countKind"unavailable" | "exact" | "lower_bound"Required
accountIdstringRequired
serviceTenancyIdstringRequired
authorizationVersionstringRequired

Errors

400, 401, 403, 404, 409, 429 and 503 return {"error": {"code", "message", "correlationId"}}.