App Self-Service API

Reference for the App Self-Service endpoint group — 9 endpoints.

Generated from the live OpenAPI spec. Re-run _generate_api_reference.py after backend changes.

Authentication#

All endpoints require a Bearer JWT in the Authorization header unless noted otherwise. See Concepts → Tokens and scopes and Reference → OAuth endpoints for how to obtain one.

Endpoints#

GET /api/v1/apps/self#

Get Self

Parameters:

Responses:

GET /api/v1/apps/self/domains#

List Domains

Parameters:

Responses:

POST /api/v1/apps/self/domains#

Add Domain

Register a domain for verification. Returns the challenge to satisfy.

Parameters:

Request body:

Required.

• application/json → DomainBody

Responses:

DELETE /api/v1/apps/self/domains/{domain}#

Delete Domain

Parameters:

Responses:

POST /api/v1/apps/self/domains/{domain}/verify#

Verify Domain

Parameters:

Responses:

DELETE /api/v1/apps/self/logout-uris#

Remove Logout Uri

Parameters:

Request body:

Required.

• application/json → UriBody

Responses:

POST /api/v1/apps/self/logout-uris#

Add Logout Uri

Parameters:

Request body:

Required.

• application/json → UriBody

Responses:

DELETE /api/v1/apps/self/redirect-uris#

Remove Redirect Uri

Parameters:

Request body:

Required.

• application/json → UriBody

Responses:

POST /api/v1/apps/self/redirect-uris#

Add Redirect Uri

Parameters:

Request body:

Required.

• application/json → UriBody

Responses:

Schemas#

Definitions for every type referenced by the endpoints above. Schema-to-schema references on this page link within the page; cross-page references would require visiting the linked page.

DomainBody#

HTTPValidationError#

UriBody#

ValidationError#