Setup · Context grants

Delegate a narrower child context grant

Narrowing a grant you got from your own principal mints immediately. Passing a grant whose original owner is a different party creates a grant-request agreement that owner must approve: the response is { status: "pending_approval", agreementId } and no grant is minted yet.

post/context/grants/{grantId}/delegate

Request

  • Base URL: https://api.ziggsai.com
  • URL: https://api.ziggsai.com/context/grants/{grantId}/delegate
  • Auth: HTTP bearer

Path parameters

grantIdstring required

Headers

Idempotency-Keystring

Replay handle for a pending access request. The same key and payload recover the original card; the same key with a different payload is a conflict, not a second request.

Request body

holderIdstring required

Who receives the delegated 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 child grant confers. Never stronger than the grant it comes from; defaults to the same.

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

from-now watermark (ISO-8601)

Response

Created

statusstring
agreementIdstring
ownerIdstring

Changes

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