API reference
Every operation of the REST API (v1.0.0-rc.9, 107 operations), generated from docs/openapi.json and docs/API-REFERENCE.md. Envelope, amounts, Idempotency-Key and versioning: see Errors and the tools reference for the MCP mapping of most of these calls.
Download OpenAPI
Stable (92)
#GET /v1/me
PATCH tylko Owner: {name?, timezone?, base_currency?, locale?}, §14.5
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#PATCH /v1/me
PATCH tylko Owner: {name?, timezone?, base_currency?, locale?}, §14.5
- Access
owner- Body
UpdateMeInput- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/fx/rates
kursy użyte przez system; Owner i agenci z `finances:observe`
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/businesses
KONTRAKT §9
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#POST /v1/businesses
KONTRAKT §9
- Access
owner- Body
CreateBusinessInput- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/businesses/{id}
KONTRAKT §9
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#PATCH /v1/businesses/{id}
KONTRAKT §9
- Access
owner- Body
UpdateBusinessInput- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/businesses/{id}/projects
KONTRAKT §9
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#POST /v1/businesses/{id}/projects
KONTRAKT §9
- Access
owner- Body
CreateProjectInput- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/projects/{id}
KONTRAKT §9
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#PATCH /v1/projects/{id}
KONTRAKT §9
- Access
owner- Body
UpdateProjectInput- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/businesses/{id}/financial-summary
KONTRAKT §9
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/businesses/{id}/subscriptions
KONTRAKT §9
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/businesses/{id}/forecast
KONTRAKT §9
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/businesses/{id}/ads
owner-level: ten sam kształt + `business_id` na każdym account
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/ads
owner-level: ten sam kształt + `business_id` na każdym account
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/businesses/{id}/project-health
KONTRAKT §9
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/businesses/{id}/saas-metrics
1.0.0-rc.3: SaasMetrics z `subscription_change` klientów; Backend B7-23; scope finances:observe
- Access
owneragent- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/businesses/{id}/context
KONTRAKT §9
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/personal/financial-summary
KONTRAKT §9
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/personal/forecast
KONTRAKT §9
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/personal/subscriptions
KONTRAKT §9
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/overview
metryki top-level, upcoming, alerty
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/free-capital
KONTRAKT §9
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/forecast
cały owner
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/coverage
KONTRAKT §9
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/daily-brief
KONTRAKT §9
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/events
KONTRAKT §9
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/events/{id}
KONTRAKT §9
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#POST /v1/expenses
KONTRAKT §9
- Access
owner- Body
CreateExpenseInput- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#POST /v1/recurring-expenses
KONTRAKT §9
- Access
owner- Body
CreateRecurringExpenseInput- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#POST /v1/planned-expenses
KONTRAKT §9
- Access
owner- Body
CreatePlannedExpenseInput- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#POST /v1/revenues
KONTRAKT §9
- Access
owner- Body
CreateRevenueInput- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/subscriptions
KONTRAKT §9
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#POST /v1/subscriptions
KONTRAKT §9
- Access
owner- Body
CreateSubscriptionInput- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/subscriptions/{id}
KONTRAKT §9
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#PATCH /v1/subscriptions/{id}
KONTRAKT §9
- Access
owner- Body
UpdateSubscriptionInput- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#PUT /v1/subscriptions/{id}/allocations
pełna lista, Σ=10000 bps
- Access
owner- Body
PutAllocationsInput- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/subscriptions/{id}/capacity
KONTRAKT §9
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#PUT /v1/subscriptions/{id}/capacity
KONTRAKT §9
- Access
owner- Body
PutCapacityInput- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/budget-reservations
KONTRAKT §9
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#POST /v1/budget-reservations
KONTRAKT §9
- Access
owner- Body
CreateReservationInput- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#POST /v1/budget-reservations/{id}/release
KONTRAKT §9
- Access
owner- Body
ReleaseReservationInput- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#POST /v1/cash-snapshots
Owner; 0.7.1: także z integracji przez `EventSink.snapshot`, patrz §9 „Salda bankowe"
- Access
owner- Body
CreateCashSnapshotInput- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/agents
KONTRAKT §9
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#POST /v1/agents
KONTRAKT §9
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/approvals
tylko Owner; approve body: {decision_note?, params_override?}; `?kind=request|write` na liście
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/approvals/{id}
tylko Owner; approve body: {decision_note?, params_override?}; `?kind=request|write` na liście
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#POST /v1/approvals/{id}/approve
tylko Owner; approve body: {decision_note?, params_override?}; `?kind=request|write` na liście
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#POST /v1/approvals/{id}/reject
tylko Owner; approve body: {decision_note?, params_override?}; `?kind=request|write` na liście
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#POST /v1/approvals/{id}/dismiss
tylko Owner; approve body: {decision_note?, params_override?}; `?kind=request|write` na liście
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#POST /v1/agent-decisions
KONTRAKT §9
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#POST /v1/ad-budget-changes
= propose_ad_budget_change; scope `ads`, min. `recommend`; przy `execute` w limitach: zapis planu + Approval auto-approved z `approval_id` w `limit_checked`
- Access
owneragent- Body
CreateAdBudgetChangeInput- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/goals
MVP: zawsze `[]`
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#POST /v1/goals
§2.17-2.18
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#POST /v1/permission-requests
KONTRAKT §9
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/audit
KONTRAKT §9
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/integrations
bez auth, 0.8.1
- Access
- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#POST /v1/integrations/{provider}/connect
bez auth, 0.8.1
- Access
- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#POST /v1/integrations/{provider}/sync
bez auth, 0.8.1
- Access
- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/integrations/catalog
bez auth, 0.8.1
- Access
- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/public/integrations
bez auth, 0.8.1
- Access
- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#POST /v1/webhooks/{provider}
podpis weryfikowany; bez Idempotency-Key, dedup po external_id; provider ∈ stripe (Stripe-Signature) | meta_ads (X-Hub-Signature-256) | google_ads (relay HMAC) | paddle (Paddle-Signature) | lemonsqueezy (X-Signature, HMAC-SHA256)
- Access
- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#POST /v1/webhooks/generic/{integration_id}
1.0.0-rc.8, R-129; PUBLICZNY co do Bearer, autoryzacja przez podpis: `X-Operlance-Signature: sha256=<HMAC-SHA256(raw body, secret integracji)>` + `X-Operlance-Timestamp` (tolerancja 5 min, jak Google Ads relay); `integration_id` = integracja `provider="generic"` utworzona przez Ownera (`POST /v1/integrations/generic/connect` → `{integration_id, secret}`, sekret pokazany raz, przechowywany jak inne `credentials_enc`, §2.20); body `{ events?: NormalizedEvent[], signals?: IntegrationSignal[] }` (co najmniej jedno niepuste, oba zod z core, max 500 elementów łącznie); trafia przez `EventSink.ingest`/`.signal` jak każdy adapter, z wymuszonym `source.type=IMPORT` i `source.integration_id=:integration_id` niezależnie od tego, co przyśle klient; odpowiedź jak `ingest`/`signal` połączona: `{ inserted, deduped, rejected[], signals_accepted, signals_deduped }`; zły podpis lub nieznane `integration_id` → 401, bez zapisu
- Access
- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#POST /v1/integrations/generic/connect`
1.0.0-rc.8, R-129; PUBLICZNY co do Bearer, autoryzacja przez podpis: `X-Operlance-Signature: sha256=<HMAC-SHA256(raw body, secret integracji)>` + `X-Operlance-Timestamp` (tolerancja 5 min, jak Google Ads relay); `integration_id` = integracja `provider="generic"` utworzona przez Ownera (`POST /v1/integrations/generic/connect` → `{integration_id, secret}`, sekret pokazany raz, przechowywany jak inne `credentials_enc`, §2.20); body `{ events?: NormalizedEvent[], signals?: IntegrationSignal[] }` (co najmniej jedno niepuste, oba zod z core, max 500 elementów łącznie); trafia przez `EventSink.ingest`/`.signal` jak każdy adapter, z wymuszonym `source.type=IMPORT` i `source.integration_id=:integration_id` niezależnie od tego, co przyśle klient; odpowiedź jak `ingest`/`signal` połączona: `{ inserted, deduped, rejected[], signals_accepted, signals_deduped }`; zły podpis lub nieznane `integration_id` → 401, bez zapisu
- Access
- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#POST /v1/waitlist
PUBLICZNY, patrz „Waitlist"
- Access
- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/waitlist
tylko Owner; paginacja jak wszędzie, csv = całość
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/notifications
Owner; §2.15
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#PATCH /v1/notifications/{id}
Owner; §2.15
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#POST /v1/notifications/read-all
Owner; §2.15
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/me/notification-preferences
Owner; §2.15
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#PATCH /v1/me/notification-preferences
Owner; §2.15
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#PUT /v1/me/notification-webhook
Owner; §2.15
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/plan
Owner; §2.16; checkout/webhook billing, miejsce, bez implementacji
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#POST /v1/plan
Owner; §2.16; checkout/webhook billing, miejsce, bez implementacji
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/plan/upgrade-preview
Owner; §2.16; checkout/webhook billing, miejsce, bez implementacji
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/goals/{id}
§2.17-2.18
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#PATCH /v1/goals/{id}
§2.17-2.18
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#DELETE /v1/goals/{id}
§2.17-2.18
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#POST /v1/goal-proposals
§2.17-2.18
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/decision-outcomes
§2.17-2.18
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/passport-templates
0.6.1; §2.7-2.8
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#POST /v1/imports
0.6.1; §9 „Importy"
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/imports/{id}
0.6.1; §9 „Importy"
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#POST /v1/imports/{id}/confirm
0.6.1; §9 „Importy"
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/imports/presets
0.6.1; §9 „Importy"
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#POST /v1/auth/magic-link
§2.19; magic-link PUBLICZNY
- Access
- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#POST /v1/auth/verify
§2.19; magic-link PUBLICZNY
- Access
- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#POST /v1/auth/logout
§2.19; magic-link PUBLICZNY
- Access
- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/me/sessions
Owner; §2.19
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#POST /v1/me/sessions/{id}/revoke
Owner; §2.19
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#POST /v1/me/sessions/revoke-others
Owner; §2.19
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
Experimental (15)
Shape may still change between minor contract versions; agents should tolerate new optional fields.
#GET /v1/agents/economics
0.7.1, spec §32: Owner wszystkie, agent własne
- Access
owneragent- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/agents/{id}/economics
0.7.1, spec §32: Owner wszystkie, agent własne
- Access
owneragent- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/agents/me/economics
0.7.1, spec §32: Owner wszystkie, agent własne
- Access
owneragent- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/agents/{id}
KONTRAKT §9
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#PATCH /v1/agents/{id}
KONTRAKT §9
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#POST /v1/agents/{id}/rotate-token
KONTRAKT §9
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#POST /v1/agents/{id}/revoke
KONTRAKT §9
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/agents/{id}/passport
KONTRAKT §9
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#PUT /v1/agents/{id}/passport
KONTRAKT §9
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/agents/me
0.6.1; §2.7-2.8
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#POST /v1/agents/{id}/passport/from-template
0.6.1; §2.7-2.8
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#POST /v1/simulations
0.7.0; bez Idempotency-Key, `finances:observe`+`forecast:observe`; body = SimulationInput; koperta z coverage
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#POST /v1/data-requests
0.7.0; agent; → Approval 202, action connect_integration|provide_data
- Access
owneragent- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/decisions/{id}/review
0.7.0; DecisionOutcome; Owner i agent-autor
- Access
owneragent- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error
#GET /v1/integrations/google_ads/callback
0.6.1; OAuth redirect; bez Bearer, state podpisany HMAC, 302 do panelu
- Access
owner- Errors
- 400 validation_error, missing_idempotency_key, missing_reason · 401 token_revoked, token_expired, session_expired, session_revoked, login_token_invalid · 403 scope_denied, limit_exceeded, agent_suspended, plan_limit_exceeded, plan_expired, trial_expired, ip_not_allowed, csrf_rejected · 404 not_found · 409 idempotency_conflict, state_conflict · 413 payload_too_large · 415 unsupported_media_type · 422 allocation_sum_invalid, capacity_exceeded, currency_mismatch, currency_unsupported, fx_unavailable, webhook_url_invalid · 426 contract_too_old · 429 rate_limited · 500 internal_error