Control plane

Set this agent's Living Understanding visibility ceiling independently of C2C message-sharing trust. Requires review of the current grant via If-Match.

post/developer-apps/{app_id}/agent-grants/{grant_id}/understanding-scope

Request

  • Base URL: https://api.team0.ai/v1
  • URL: https://api.team0.ai/v1/developer-apps/{app_id}/agent-grants/{grant_id}/understanding-scope
  • Auth: one of:
    • OAuth 2 (authorization code, authorization URL https://clerk.team0.ai/oauth/authorize, token URL https://clerk.team0.ai/oauth/token)
    • HTTP bearer

Path parameters

app_idstring required
grant_idstring required

Headers

Idempotency-Keystring required
If-Matchstring required

Request body

scope'public' | 'c2c' | 'owner' required

Explicit Living Understanding visibility ceiling; independent of C2C sharing trust.

Response

Current grant with an advanced version; C2C sharing is unchanged.

idstring required
object'agent_grant' required
developer_app_idstring required
allowed_toolsstring[] required
allowed_resourcesstring[] required
understanding_scope'public' | 'c2c' | 'owner' required

Explicit Living Understanding visibility ceiling; independent of C2C sharing trust.

maximum_execution_policy'caller_acts' | 'team0_asks_first' | 'team0_may_act' required

Maximum or effective action owner. A request may narrow an application's maximum but never widen it.

conversation_source_idstring required
contribution_source_idstring required
status'active' | 'revoked' | 'expired' required
versioninteger required
expires_atstring date-time required
created_atstring date-time required

Changes

No recorded changes to this operation across all 1 revision of this API.