Skip to main content
GET
Get Grant

Authorizations

Authorization
string
header
required

A token from the identity provider your deployment federates with. It identifies a person; their roles in the workspace decide what they may do.

Path Parameters

grant_id
string
required

Response

Successful Response

id
string
required
enforcement_mode
enum<string>
required
Available options:
observe,
shadow,
canary,
enforce
canary_percent
integer | null
required
issued_against_provenance
string | null
required
agent_id
string | null
required
kind
string
required
environment
string | null
required
principal_type
string
required
principal_id
string
required
parent_grant_id
string | null
required
depth
integer
required
scope
Scope · object
required
audience
string | null
required
policy
string | null
required
policy_rendering
string | null
required
budget_amount_minor
integer | null
required
budget_currency
string | null
required
spent_amount_minor
integer
required
budget_count
integer | null
required
spent_count
integer
required
created_at
string<date-time>
required
not_before
string<date-time>
required
not_after
string<date-time>
required
conditions
Conditions · object
required
delegation_policy
string
required
status
string
required
held_amount_minor
integer
default:0
held_count
integer
default:0
pending_reason
string | null
revoked_at
string<date-time> | null
revoked_by
string | null
revoked_by_email
string | null
revocation_reason
string | null