API Reference

scopes

2 endpoints

GET/oauth2/scopes

Get Scope Metadata

Get grouped scope metadata for consent screen.

Groups scopes by category and provides appropriate consent descriptions based on the level of access requested. Scopes with requires_ownership=True are flagged as requiring resource-level access (vs personal resources).

Query parameters

scopes*

string

Space-separated list of scope names

Responses

200Successful Response

Field

Type

Description

groups*

ScopeGroup[]

Scopes grouped by category with combined descriptions

array items · ScopeGroup

Field	Type	Description
consent_description*	string	User-friendly description for consent screen
scopes*	string[]	List of scope identifiers in this group
sensitive	boolean	True if any scope in the group is sensitive default: false
category*	string	Scope category
requires_resource_access	boolean	True if scopes apply to resources user has access to, not personal resources default: false

422Validation Error

Field

Type

Description

detail

ValidationError[]

array items · ValidationError

Field	Type	Description
loc*	string \| integer[]
msg*	string
type*	string

Example request

curl -X GET "https://api.davi.social/oauth2/scopes" \
  -H "Authorization: Bearer <token>"

GET/oauth2/client-info

Get Client Info

Get OAuth app details for consent pages and login banners.

Unauthenticated endpoint. Returns app info with icon (fallback to org logo), organization details, and optionally scope groups.

Query parameters

client_id*	string	OAuth2 client_id
with_scopes	boolean	default: false
scopes	string \| null

Responses

200Successful Response

Field

Type

Description

client*

ClientInfo

object · ClientInfo

Field	Type	Description
client_id*	string
client_name*	string
client_description	string \| null
icon_url	string \| null
client_uri	string \| null

organization*

OrganizationInfo

object · OrganizationInfo

Field	Type	Description
name*	string
description	string \| null
logo_url	string \| null
website	string \| null

scope_groups

ScopeGroup[] | null

array items · ScopeGroup

Field	Type	Description
consent_description*	string	User-friendly description for consent screen
scopes*	string[]	List of scope identifiers in this group
sensitive	boolean	True if any scope in the group is sensitive default: false
category*	string	Scope category
requires_resource_access	boolean	True if scopes apply to resources user has access to, not personal resources default: false

422Validation Error

Field

Type

Description

detail

ValidationError[]

array items · ValidationError

Field	Type	Description
loc*	string \| integer[]
msg*	string
type*	string

Example request

curl -X GET "https://api.davi.social/oauth2/client-info" \
  -H "Authorization: Bearer <token>"