API 参考

Operations

Management API: GET /operations/{id}

本页只有英文版。API 参考、Webhook 事件和更新日志保持英文，与代码中的字段名称、错误码一致。

Base URL https://app.kanorio.com/api/v1Errors Pagination

Retrieve an operation

GET/operations/{id}

betaconsole:viewdefault (120/minute per token)

Get the status of an asynchronous business operation by operationId (returned by capabilities such as sites.create mode=brief or imports.create, or carried on webhook events). Poll until status is terminal (SUCCEEDED, FAILED, CANCELLED, EXPIRED); respect pollAfterSeconds. UNKNOWN means an external call timed out and Kanorio is reconciling it: keep polling, do not retry the original request. pendingEffects lists side effects still in flight after the main operation succeeded. Synchronous operations never create an operation; retry them with the same Idempotency-Key instead. import_job operations stay RUNNING with stage=review while the batch waits for a human (or imports.apply) to confirm which rows to write; result carries batchId, batchStatus and totals. Errors: OPERATION_NOT_FOUND, FORBIDDEN.

Parameters

idstring · pathrequired

Response 200

operationIdstringrequired
kind"site_job" | "page_job" | "outbox" | "external" | "import_job" | "automation_run"required
status"PENDING" | "RUNNING" | "SUCCEEDED" | "FAILED" | "CANCELLED" | "UNKNOWN" | "EXPIRED"required
PENDING / RUNNING / SUCCEEDED / FAILED / CANCELLED; UNKNOWN = an external call timed out and is being reconciled (not a failure); EXPIRED = the record passed its retention window.
stagestring | nullrequired
websiteIdstring | nullrequired
resultobject | nullrequired
errorobject | nullrequired
error.codestringrequired
error.messagestring | nullrequired
pendingEffectsobject[]required
pendingEffects[].kindstringrequired
Side effect still being processed after the main operation succeeded (e.g. entitlement_grant, invoice_issue, webhook_delivery).
pendingEffects[].status"PENDING" | "RUNNING" | "SUCCEEDED" | "FAILED" | "CANCELLED" | "UNKNOWN" | "EXPIRED"required
pollAfterSecondsinteger | nullrequired
Suggested wait before polling again; null when terminal.
createdAtstringrequired
finishedAtstring | nullrequired

Errors

OPERATION_NOT_FOUND 404
FORBIDDEN 403

MCP tool operations_get

curl -X GET "https://app.kanorio.com/api/v1/operations/{id}" \
  -H "Authorization: Bearer $KANORIO_TOKEN"

Response

{
  "operationId": "op_site_job_job_example01",
  "kind": "site_job",
  "status": "RUNNING",
  "stage": "generating_pages",
  "websiteId": "ws_example123",
  "result": null,
  "error": null,
  "pendingEffects": [],
  "pollAfterSeconds": 8,
  "createdAt": "2026-10-01T02:30:00.000Z",
  "finishedAt": null
}