Skip to main content
POST
Call pages.capabilities.configure

Authorizations

Authorization
string
header
required

An API key minted at Settings › API & MCP. Send it as Authorization: Bearer <key>. A key carries its holder's own permissions, resolved on every call — revoking a membership closes the key's reach immediately. Keep it in an environment variable (GOOSY_API_KEY), never in a committed file.

Body

application/json
configuration
object
required
confirmation_id
string<uuid>
workspace
string

Which workspace to run in — its slug. Omit to use your default. With more than one reachable workspace and no default, the call is refused and the choices are listed.

Minimum string length: 1

Response

The call was admitted and dispatched. ok says whether the tool succeeded — a refusal the tool itself produced is still a 200, exactly as it is a successful JSON-RPC result over MCP.

The tool ran and answered.

ok
boolean
required
state
enum<string>
required
Available options:
confirmation_required,
configured,
enrollment_pending
kind
enum<string>
required
Available options:
policy,
grant,
standing_approval,
grant_revoke,
standing_approval_revoke,
workflow_enrollment
workspace
string
required

The slug of the workspace this call ran in.

working_in
object
required

Which workspace this call ran in, and how that was decided. Present on every workspace-scoped result.

confirmation_id
string<uuid>
expires_in_seconds
integer
disclosure_summary
string
policy_id
string<uuid>
version_id
string<uuid>
version
integer
activated
boolean
grant_id
string<uuid>
grant_saved
boolean
runtime_credential
enum<string>
Available options:
ready,
not_required,
enrollment_pending
enrollment_error_code
string
standing_approval_id
string<uuid>
enrollment_id
string<uuid>
workflow_definition_id
string<uuid>
workflow_definition_version_id
string<uuid>
service_actor_user_id
string<uuid>
service_actor_role
string
changed
boolean
standing_approvals_revoked
integer
Required range: x >= 0
managed_keys_revoked
integer
Required range: x >= 0
request_replayed
boolean