Runtime

Batch operations

Up to 100 sub-ops, each billed individually; nested execute is rejected. The gateway wraps the body in Kairos's {op,args} dispatch envelope — clients send the bare {operations} shape documented here. The response is the NATIVE OpResult envelope ({ok,payload:{results:[…]}}), one result per sub-op in order. Class A — accepts a session JWT, an il_live_/il_test_ API key, or an il_oauth_ token. On the il_* lanes the bearer is forwarded to Kairos verbatim and Kairos enforces the credential's grant on this workspace (its 401/403 is surfaced in the v2 envelope). The response body is Kairos's, passed through unchanged; X-InfoLang-Tokens-Saved / X-InfoLang-Overage are echoed when set.

Requires the memories:write scope. Accepts all three lanes: a session JWT (bounded by the caller's role on this workspace) or an il_* machine credential whose own scope set, workspace set and validity window cover it — both ceilings apply and neither can raise the other, so a credential carrying memories:write is still refused where the role does not permit it.

A credential with no scope record resolves to LEGACY_DEFAULT, which INCLUDES memories:write — every key minted before scoping keeps working here.

post/v2/workspaces/{id}/execute

Request

  • Base URL: https://api.infolang.ai
  • URL: https://api.infolang.ai/v2/workspaces/{id}/execute
  • Auth: one of:
    • HTTP bearer
    • HTTP bearer
    • HTTP bearer

Path parameters

idstring required

Request body

Response

Per-operation results (native envelope)

okboolean required
payloadobject nullable

Changes

No recorded changes to this operation across all 1 revision of this API.