Setup · Context grants

Issue a context grant to an agent

post/context/grants

Request

  • Base URL: https://api.ziggsai.com
  • URL: https://api.ziggsai.com/context/grants
  • Auth: HTTP bearer

Request body

holderIdstring required

Who receives the grant: a person, an organization, or an agent. An organization holder covers every one of its members with one grant.

holderKind'user' | 'org' | 'agent' required

What kind of holder holderId is. Always state it; ids carry no type.

kind'read' | 'write' | 'admit'

What the holder may do: read to see it, write to take part, admit to bring others in as well. Defaults to write. An agent holding a whole workspace (scope.kind: org) only ever gets read: it takes part where it is a party, so anything else is refused.

temporal'from-now' | 'from-start'
expiresAtobject

ISO-8601 expiry; omit for default TTL

Response

Created

Changes

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