Skip to content
Savorum API

Redeem a managed session grant

POST
/api/v1/auth/{provider}/managed-sessions
curl --request POST \
  --url http://127.0.0.1:8080/api/v1/auth/example/managed-sessions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "code_verifier": "example", "grant": "example" }'

Available only when account authentication is enabled. Provider configuration is restart-bound. Local logout does not require an external provider. Responses must not be cached.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
provider
required
string

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
code_verifier
required
string
grant
required
string
Examplegenerated
{
  "code_verifier": "example",
  "grant": "example"
}

Responses

Section titled “Responses”

200

Section titled “200”

An ordinary local session after one-use grant, PKCE and local membership checks.

Media typeapplication/json
object
csrf_token
required
string
invitation_accepted
required
boolean
user
required
object
display_name
required
string
id
required
string
instance_admin
required
boolean
key
additional properties
any
Examplegenerated
{
  "csrf_token": "example",
  "invitation_accepted": true,
  "user": {
    "display_name": "example",
    "id": "example",
    "instance_admin": true
  }
}

400

Section titled “400”

Structured authentication boundary failure

Media typeapplication/problem+json
object
code
required
string
detail
required
string
status
required
integer
title
required
string
type
required
string
Examplegenerated
{
  "code": "example",
  "detail": "example",
  "status": 1,
  "title": "example",
  "type": "example"
}

401

Section titled “401”

Structured authentication boundary failure

Media typeapplication/problem+json
object
code
required
string
detail
required
string
status
required
integer
title
required
string
type
required
string
Examplegenerated
{
  "code": "example",
  "detail": "example",
  "status": 1,
  "title": "example",
  "type": "example"
}

403

Section titled “403”

Structured authentication boundary failure

Media typeapplication/problem+json
object
code
required
string
detail
required
string
status
required
integer
title
required
string
type
required
string
Examplegenerated
{
  "code": "example",
  "detail": "example",
  "status": 1,
  "title": "example",
  "type": "example"
}

429

Section titled “429”

Structured authentication boundary failure

Media typeapplication/problem+json
object
code
required
string
detail
required
string
status
required
integer
title
required
string
type
required
string
Examplegenerated
{
  "code": "example",
  "detail": "example",
  "status": 1,
  "title": "example",
  "type": "example"
}

500

Section titled “500”

Structured authentication boundary failure

Media typeapplication/problem+json
object
code
required
string
detail
required
string
status
required
integer
title
required
string
type
required
string
Examplegenerated
{
  "code": "example",
  "detail": "example",
  "status": 1,
  "title": "example",
  "type": "example"
}