latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-15142192531.5 KB

7d1aff84ce3b

Projects

What the caller may do here

Role, gate state, plan limits and a set of derived booleans — so an agent on a static surface can check before it acts instead of attempting a write and reading the failure.

Descriptive, never authoritative: see the schema.

get/projects/{projectId}/capabilities

Response

The caller's capabilities in this project.

projectIdstring required
organizationIdstring nullable required
rolestring required

The caller's ORGANIZATION role: guest, member, admin or owner. This is what the platform's role checks rank; a project grant does not raise it.

projectRolestring required

admin or editor, when the caller holds a project grant.

surfacestring required

Which channel we resolved this request to arrive on. Echoed so an agent can confirm it is labelled the way it expects — a CLI showing up as rest means its user agent is not reaching us.