Skip to main content
GET
Get Device Authorization

Authorizations

korve.session_token
string
cookie
required

Path Parameters

userCode
string
required

Human-entered pairing code in XXXX-XXXX form, from an unambiguous alphabet.

Maximum string length: 9
Pattern: ^[BCDFGHJKLMNPQRSTVWXZ]{4}-[BCDFGHJKLMNPQRSTVWXZ]{4}$

Response

Safe approval details; the device code is never returned.

userCode
string
required

Human-entered pairing code in XXXX-XXXX form, from an unambiguous alphabet.

Maximum string length: 9
Pattern: ^[BCDFGHJKLMNPQRSTVWXZ]{4}-[BCDFGHJKLMNPQRSTVWXZ]{4}$
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
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]*$
requestedRole
enum<string>
required

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

Available options:
member,
admin
expiresAt
string<date-time>
required