Skip to main content
GET
List Grants

Authorizations

korve.session_token
string
cookie
required

Path Parameters

orgId
string
required

The organization's id (UUID) or slug — either form is accepted.

Response

200 - application/json

Revocable agent grants.

id
string<uuid>
required
clientId
enum<string>
required
Available options:
korve-cli,
korve-mcp
audience
enum<string>
required

The first-party client surface that may present the resulting token.

Available options:
cli,
mcp
role
enum<string>
required

Maximum organization role the grant may exercise. Owner grants do not exist.

Available options:
member,
admin
scopes
string[]
required

Exact public API operation ids the grant may call.

Required array length: 1 - 256 elements
Maximum string length: 128
Pattern: ^[A-Za-z][A-Za-z0-9]*\.[A-Za-z][A-Za-z0-9]*$
userId
string
required
revokedAt
string<date-time> | null
required
lastUsedAt
string<date-time> | null
required
createdAt
string<date-time>
required