Skip to main content
POST
Renew an access grant

Authorizations

Authorization
string
header
required

Personal byk_ API key; user-principal, resolved to a tenant by org context.

Headers

X-Bonya-Organization-ID
string

Org context. Omitted means the caller's personal organization. A well-formed non-member org is 404; malformed is 400.

Path Parameters

sandbox_id
string
required
preview_id
string
required
Pattern: ^pv-[a-z2-7]{26}$
grant_id
string
required

Body

application/json
ttl_seconds
integer
Required range: 0 <= x <= 31536000

Response

Renewed grant

id
string
required
preview_id
string
required
created_at
string<date-time>
required
expires_at
string<date-time>
required
revoked_at
string<date-time>
token
string

Returned only when the grant is created.

exchange_url
string

Returned only when the grant is created.