List tool namespaces
/api/v1/tools/namespacesList the tool namespaces visible to the caller together with a per-namespace tool count, for building grouped pickers without retrieving the complete catalog.
Required access
Credentials: service principal, delegated token, user session
Counts use the same caller-visible catalog as the tool list.
An organization-owned automation key, prefixed gsmc_sk_. Already bound to one organization, so it needs no X-Org-Id header. It carries no user identity: it never reaches a private resource however it is scoped, and a run it starts has no user for an interactive tool to reach.
In: header
Query Parameters
trueHeader Parameters
Selects the active organization for a credential that belongs to more than one. Service-principal keys are bound to a single organization and ignore it.
Response Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/api/v1/tools/namespaces" \ -H "Authorization: Bearer $GUEST_MACHINES_API_KEY"{ "namespaces": [ { "namespace": "string", "tool_count": 0 } ], "total": 0}{ "detail": "string", "error_code": "string", "request_id": "string"}{ "detail": "string", "error_code": "string", "request_id": "string"}{ "detail": "string", "error_code": "string", "request_id": "string"}{ "detail": "string", "error_code": "string", "request_id": "string"}{ "detail": "string", "error_code": "string", "request_id": "string"}