Preferences API
Auto-generated from
openapi-snapshot.json. Do not edit by hand — changes are overwritten byscripts/docs/generate_api_reference.py.
10 endpoints in this group.
GET /api/preferences/
Get Preferences
Return the active tenant’s preferences. Falls back to defaults when DB is unavailable.
Responses
| Code | Description |
|---|---|
200 | Successful Response |
PATCH /api/preferences/
Update Preferences
Update tenant preferences. Returns the updated values.
Request body: application/json
Responses
| Code | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
GET /api/preferences/credentials
List Credentials
Return masked credential summaries for all supported providers.
Responses
| Code | Description |
|---|---|
200 | Successful Response |
POST /api/preferences/credentials
Set Credential
Upsert an API credential for the given provider.
Request body: application/json
Responses
| Code | Description |
|---|---|
201 | Successful Response |
422 | Validation Error |
DELETE /api/preferences/credentials/{provider}
Delete Credential
Remove the stored credential for the given provider.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
provider | path | string | required |
Responses
| Code | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
GET /api/preferences/llm-credentials
List Llm Credentials
Return masked credential summaries for every supported LLM provider.
Responses
| Code | Description |
|---|---|
200 | Successful Response |
POST /api/preferences/llm-credentials
Set Llm Credential
Request body: application/json
Responses
| Code | Description |
|---|---|
201 | Successful Response |
422 | Validation Error |
DELETE /api/preferences/llm-credentials/{provider}
Delete Llm Credential
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
provider | path | string | required |
Responses
| Code | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |
GET /api/preferences/llm-provider
Get Llm Provider
Responses
| Code | Description |
|---|---|
200 | Successful Response |
PATCH /api/preferences/llm-provider
Update Llm Provider
Request body: application/json
Responses
| Code | Description |
|---|---|
200 | Successful Response |
422 | Validation Error |