AgentStack User AI Settings API
User AI settings. REST compatibility surface; for new integrations prefer MCP actions, GET/POST /api/dna/data, or POST /api/commands (see docs/API_CHANNELS_AND_PROTOCOLS.md).
User AI settings. REST compatibility surface; for new integrations prefer MCP actions, GET/POST /api/dna/data, or POST /api/commands (see docs/API_CHANNELS_AND_PROTOCOLS.md).
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/agentstack-tech:agentstack-tech-user-ai-settings-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: AgentStack Core User AI Settings API
description: 'AgentStack is a Universal Processing System — a patented AI-first platform that replaces an entire backend stack and ships a ready admin UI. One ecosystem covers auth, payments, data, social, messenger, AI, knowledge base, game economy, RBAC and more — behind a single SDK, REST API and Model Context Protocol surface. You say the outcome. An AI with AgentStack connected hosts, configures, and reads the result back. Free tier from $0.
**Two layers:** (1) **Universal access** — `POST /mcp` (`agentstack.execute`), `GET /mcp/actions`, `GET /mcp/discovery`; `GET/POST /api/dna/data` (8DNA key-value); `POST /api/commands/*` (Protein, same stack as MCP `commands.execute`). (2) **REST compatibility** — many `/api/*` routes for SPA, SDK, OAuth, webhooks, uploads. See repo doc `docs/API_CHANNELS_AND_PROTOCOLS.md`.
**Channels:** Prefer MCP (`POST /mcp`, `GET /mcp/actions`), 8DNA (`/api/dna/data`), and Protein commands (`/api/commands/*`) for new integrations. REST paths below are the compatibility surface for SPA, SDKs, OAuth, and uploads. See `/api-docs`, `/mcp-docs`, and docs/API_CHANNELS_AND_PROTOCOLS.md.
**Try it:** Use Authorize with `X-API-Key` or Bearer JWT. Changelog: docs/api/API_CHANGELOG.md.'
version: 0.4.24
x-agentstack-version: 0.4.24
x-genetic-tag: docs.api.specs.gen1
x-changelog-url: docs/api/API_CHANGELOG.md
x-exported-at: '2026-11-01T04:40:16Z'
security:
- ApiKeyAuth: []
- BearerAuth: []
tags:
- name: User AI Settings
description: User AI settings. REST compatibility surface; for new integrations prefer MCP actions, GET/POST /api/dna/data, or POST /api/commands (see docs/API_CHANNELS_AND_PROTOCOLS.md).
paths:
/api/users/me/ai-keys:
put:
tags:
- User AI Settings
summary: Update User Ai Keys
description: 'Обновить AI API ключи пользователя
Philosophy v0.2.55: User control over API keys
Body:
{
"openai": "sk-...",
"anthropic": "sk-ant-...",
"gemini": "..."
}
Keys are stored in user.protected.keys.api.service_keys
Empty string removes the key
Returns:
{
"success": true,
"message": "AI keys updated",
"updated_providers": ["openai", "gemini"]
}'
operationId: update_user_ai_keys_api_users_me_ai_keys_put
requestBody:
content:
application/json:
schema:
additionalProperties:
type: string
type: object
title: Api Keys
description: AI provider API keys
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
'400':
description: Bad Request
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ProblemDetails'
'401':
description: Unauthorized
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ProblemDetails'
'403':
description: Forbidden
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ProblemDetails'
'404':
description: Not Found
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ProblemDetails'
'409':
description: Conflict
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ProblemDetails'
'429':
description: Too Many Requests
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ProblemDetails'
'500':
description: Internal Server Error
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ProblemDetails'
parameters:
- $ref: '#/components/parameters/IdempotencyKey'
x-channel: rest_compat
/api/users/me/ai-settings:
get:
tags:
- User AI Settings
summary: Get User Ai Settings
description: 'Получить AI настройки пользователя
Returns:
{
"settings": {
"use_own_keys": false,
"default_key_source": "ecosystem"
},
"keys_status": {
"openai": false,
"anthropic": false,
"gemini": false
},
"keys_probe": {
"ok": true,
"error_code": null
}
}
Note: Keys themselves are NOT returned (only status)'
operationId: get_user_ai_settings_api_users_me_ai_settings_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'400':
description: Bad Request
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ProblemDetails'
'401':
description: Unauthorized
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ProblemDetails'
'403':
description: Forbidden
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ProblemDetails'
'404':
description: Not Found
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ProblemDetails'
'409':
description: Conflict
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ProblemDetails'
'422':
description: Unprocessable Entity
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ProblemDetails'
'429':
description: Too Many Requests
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ProblemDetails'
'500':
description: Internal Server Error
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ProblemDetails'
x-channel: rest_compat
put:
tags:
- User AI Settings
summary: Update User Ai Settings
description: 'Обновить AI настройки пользователя
Body:
{
"use_own_keys": true,
"default_key_source": "user"
}
Stored in user.data.ai_settings
Returns:
{
"success": true,
"settings": {...}
}'
operationId: update_user_ai_settings_api_users_me_ai_settings_put
requestBody:
content:
application/json:
schema:
additionalProperties: true
type: object
title: Settings
description: AI settings
required: true
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
'400':
description: Bad Request
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ProblemDetails'
'401':
description: Unauthorized
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ProblemDetails'
'403':
description: Forbidden
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ProblemDetails'
'404':
description: Not Found
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ProblemDetails'
'409':
description: Conflict
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ProblemDetails'
'429':
description: Too Many Requests
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ProblemDetails'
'500':
description: Internal Server Error
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ProblemDetails'
parameters:
- $ref: '#/components/parameters/IdempotencyKey'
x-channel: rest_compat
/api/users/me/ai-runtime:
get:
tags:
- User AI Settings
summary: Get User Ai Runtime
description: 'User LLM runtime BFF — ai-settings + energy balance in one response.
Replaces parallel GET /ai-settings + GET /energy/balance for profile AI keys UI.'
operationId: get_user_ai_runtime_api_users_me_ai_runtime_get
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'400':
description: Bad Request
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ProblemDetails'
'401':
description: Unauthorized
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ProblemDetails'
'403':
description: Forbidden
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ProblemDetails'
'404':
description: Not Found
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ProblemDetails'
'409':
description: Conflict
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ProblemDetails'
'422':
description: Unprocessable Entity
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ProblemDetails'
'429':
description: Too Many Requests
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ProblemDetails'
'500':
description: Internal Server Error
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ProblemDetails'
x-channel: rest_compat
/api/users/me/ai-keys/{provider}:
delete:
tags:
- User AI Settings
summary: Delete User Ai Key
description: 'Удалить API ключ пользователя для конкретного провайдера
Args:
provider: openai | anthropic | gemini
Returns:
{
"success": true,
"message": "API key removed for {provider}"
}'
operationId: delete_user_ai_key_api_users_me_ai_keys__provider__delete
parameters:
- name: provider
in: path
required: true
schema:
type: string
title: Provider
- $ref: '#/components/parameters/IdempotencyKey'
responses:
'200':
description: Successful Response
content:
application/json:
schema: {}
'422':
description: Validation Error
content:
application/json:
schema:
$ref: '#/components/schemas/HTTPValidationError'
'400':
description: Bad Request
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ProblemDetails'
'401':
description: Unauthorized
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ProblemDetails'
'403':
description: Forbidden
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ProblemDetails'
'404':
description: Not Found
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ProblemDetails'
'409':
description: Conflict
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ProblemDetails'
'429':
description: Too Many Requests
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ProblemDetails'
'500':
description: Internal Server Error
content:
application/problem+json:
schema:
$ref: '#/components/schemas/ProblemDetails'
x-channel: rest_compat
components:
schemas:
HTTPValidationError:
properties:
detail:
items:
$ref: '#/components/schemas/ValidationError'
type: array
title: Detail
type: object
title: HTTPValidationError
ProblemDetails:
type: object
description: RFC 7807 Problem Details (+ AgentStack trace_id).
required:
- title
- status
properties:
type:
type: string
format: uri
default: about:blank
description: URI reference identifying the problem type.
title:
type: string
description: Short, human-readable summary of the problem type.
status:
type: integer
minimum: 100
maximum: 599
description: HTTP status code for this occurrence.
detail:
type: string
description: Human-readable explanation specific to this occurrence.
instance:
type: string
format: uri
description: URI reference identifying this specific occurrence.
trace_id:
type: string
description: AgentStack request/trace correlation id (X-Trace-Id).
ValidationError:
properties:
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Location
msg:
type: string
title: Message
type:
type: string
title: Error Type
input:
title: Input
ctx:
type: object
title: Context
type: object
required:
- loc
- msg
- type
title: ValidationError
parameters:
IdempotencyKey:
name: Idempotency-Key
in: header
required: false
description: Client-generated key to make mutating requests idempotent.
schema:
type: string
maxLength: 256
securitySchemes:
BearerAuth:
type: http
scheme: bearer
bearerFormat: JWT
description: User session JWT from /auth/login.
ApiKeyAuth:
type: apiKey
in: header
name: X-API-Key
description: 'Project API key. Optional service_caps whitelist is enforced before RBAC. See /dev/docs/secure/api-keys-scopes. OAuth 2.1 Device Code (RFC 8628) for plugins: see /oauth/device/code — documented in docs, not as a non-standard OAS flow.'
x-tagGroups:
- name: Unified access
tags:
- MCP
- 8DNA API
- Commands
- name: Field access policy
tags:
- DataAccess
- name: Identity & access
tags:
- Authentication
- User
- Profile
- Sessions
- RBAC
- Permissions
- OAuth 2.1
- API Keys
- name: Project platform
tags:
- Projects
- Project
- CRM
- Business
- Integrations
- Agents Fleet
- Support
- Bots
- Dashboard
- Notifications
- name: Commerce
tags:
- Payments
- AgentNet
- Commerce
- Commerce Shop
- Commerce Merchant
- Marketplace
- Assets
- Global Assets
- Invoices
- Buffs
- name: Automation
tags:
- Logic Engine
- Logic Templates
- Commands
- Scheduler
- Webhooks
- Unified API
- name: Data & AI
tags:
- 8DNA API
- RAG
- Neural Architecture
- Neural Events
- AI Builder
- Files
- Project Files
- Hosting
- name: Ops
tags:
- Health & Metrics
- Admin
- Analytics
- Backup Management
- OAuth 2.1 Admin
- Observability
- OpTrace
- API Hub
- name: Fabric & platform
tags:
- Fabric
- Capabilities
- Sandbox
- Shell Hub
- Platform
- Discovery
- Guidance
- Ecosystem
- name: Social & AgentNet
tags:
- AgentSocial
- AgentNet
- AgentNet PTR
- AgentNet BNB
- AgentNet Solana
- AgentNet Arbitrum
- AgentNet Chain Control
- AgentNet Chain Control Public
- name: Public surfaces
tags:
- Public hosting
- Public demo hosting
- Public showcase
- Public grants
- Public commerce lite
- name: Finance & billing
tags:
- Finance
- Billing
- Business
- PrincipalAccess