AimableDocs
DocsAPI Reference
POST/v1/spaces/{space_id}/skills/executions/{execution_id}/cancel

Cancel Execution Route

T074 — cancel a running execution. RBAC: the invoking principal OR a caller with ``skills.execution.cancel.any``.

Path Parameters

NameTypeRequiredDescription
space_idstring (uuid)Required
execution_idstring (uuid)Required

Headers

NameTypeRequiredDescription
X-API-KeystringOptional

Request

curl -X POST '/api-proxy/v1/spaces/{space_id}/skills/executions/{execution_id}/cancel' \
  -H 'Authorization: Bearer <YOUR_TOKEN>'

Response

200(generated)
{
  "data": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "tenant_id": "550e8400-e29b-41d4-a716-446655440000",
    "space_id": "550e8400-e29b-41d4-a716-446655440000",
    "principal_id": "550e8400-e29b-41d4-a716-446655440000",
    "skill_slug": "string",
    "skill_version": {},
    "source": "standalone",
    "state": "queued",
    "parent_execution_id": {},
    "created_at": "2024-01-01T00:00:00Z",
    "started_at": {},
    "finished_at": {},
    "failure_reason": {},
    "resource_usage": {
      "input_tokens": 0,
      "output_tokens": 0,
      "cost_usd": "string",
      "wallclock_ms": {},
      "iteration_count": 0
    },
    "inputs": {},
    "outputs": {},
    "error": {},
    "artifacts": [
      {
        "artifact_id": "550e8400-e29b-41d4-a716-446655440000",
        "relpath_in_workspace": {},
        "document_type": {},
        "download_url": "string",
        "size_bytes": {}
      }
    ],
    "sub_executions": [
      {
        "id": "550e8400-e29b-41d4-a716-446655440000",
        "tenant_id": "550e8400-e29b-41d4-a716-446655440000",
        "space_id": "550e8400-e29b-41d4-a716-446655440000",
        "principal_id": "550e8400-e29b-41d4-a716-446655440000",
        "skill_slug": "string",
        "skill_version": {},
        "source": "standalone",
        "state": "queued",
        "parent_execution_id": {},
        "created_at": "2024-01-01T00:00:00Z",
        "started_at": {},
        "finished_at": {},
        "failure_reason": {},
        "resource_usage": {
          "input_tokens": 0,
          "output_tokens": 0,
          "cost_usd": "string",
          "wallclock_ms": {},
          "iteration_count": 0
        }
      }
    ],
    "chat_thread_id": {},
    "chat_message_id": {},
    "chat_tool_call_id": {},
    "workspace_archive_id": {},
    "langfuse_trace_id": {},
    "idempotency_key": {}
  }
}

Error Responses