For developers
API and safe errors
Core external-application endpoints and behavior when context validation fails.
Updated: August 10, 2026
01
Public Web Chat API
httpKanyman docs
POST /api/public/web-chat/{public_key}/sessions
Idempotency-Key: <unique-session-creation-key>
Content-Type: application/json
{
"locale": "en",
"context_token": "<optional-signed-jwt>"
}httpKanyman docs
PUT /api/public/web-chat/{public_key}/sessions/{session_id}/context
Authorization: Bearer <session_token>
Content-Type: application/json
{ "context_token": "<signed-jwt>" }02
Context processing result
jsonKanyman docs
{
"context_status": "rejected",
"context_id": null,
"context_error_code": "context_expired"
}A context error does not cancel the chat session. The interface must continue ordinary chat and show a neutral message that technical information is temporarily unavailable.
03
Account API
textKanyman docs
GET /api/projects/{project_id}/external-integrations
POST /api/projects/{project_id}/external-integrations
GET /api/projects/{project_id}/external-integrations/{integration_id}
POST /api/projects/{project_id}/external-integrations/{integration_id}/test-token
GET /api/projects/{project_id}/external-integrations/{integration_id}/tools
POST /api/projects/{project_id}/external-integrations/{integration_id}/tools
POST /api/projects/{project_id}/external-integrations/{integration_id}/tools/{tool_id}/test
POST /api/projects/{project_id}/external-integrations/{integration_id}/tools/{tool_id}/hmac-credentials
GET /api/projects/{project_id}/external-integrations/{integration_id}/connector-catalog
GET /api/projects/{project_id}/external-integrations/{integration_id}/connectors/{connector_id}/versions/{version}/manifest
POST /api/projects/{project_id}/external-integrations/{integration_id}/connectors/{connector_id}/versions/{version}/provision-plan
POST /api/projects/{project_id}/external-integrations/{integration_id}/connectors/{connector_id}/versions/{version}/provision
GET /api/projects/{project_id}/external-integrations/{integration_id}/actions
POST /api/projects/{project_id}/external-integrations/{integration_id}/actions
GET /api/projects/{project_id}/external-integrations/{integration_id}/actions/{action_id}
POST /api/projects/{project_id}/external-integrations/{integration_id}/actions/{action_id}/confirm
POST /api/projects/{project_id}/external-integrations/{integration_id}/actions/{action_id}/cancel
POST /api/projects/{project_id}/external-integrations/{integration_id}/actions/{action_id}/reconcile
GET /api/projects/{project_id}/solution-packs/catalog
GET /api/projects/{project_id}/solution-packs
POST /api/projects/{project_id}/solution-packs/install
POST /api/projects/{project_id}/solution-packs/{installation_id}/refresh
POST /api/projects/{project_id}/solution-packs/{installation_id}/activate
POST /api/projects/{project_id}/solution-packs/{installation_id}/disable
POST /api/projects/{project_id}/solution-packs/{installation_id}/rollback
GET /api/projects/{project_id}/solution-packs/{installation_id}/scenarios
POST /api/projects/{project_id}/solution-packs/{installation_id}/scenarios/{scenario_key}/preview
POST /api/projects/{project_id}/solution-packs/{installation_id}/scenarios/{scenario_key}/drafts
POST /api/projects/{project_id}/solution-packs/{installation_id}/scenarios/versions/{version_id}/submit
POST /api/projects/{project_id}/solution-packs/{installation_id}/scenarios/versions/{version_id}/activate
POST /api/projects/{project_id}/solution-packs/{installation_id}/scenarios/versions/{version_id}/archive
POST /api/public/web-chat/{public_key}/sessions/{session_id}/actions/{action_id}/confirm
POST /api/public/web-chat/{public_key}/sessions/{session_id}/actions/{action_id}/cancelCreating and testing configuration requires an owner or admin role in the selected project. Every operation validates the workspace/project scope.
04