Agents/Linc

Cancel native Linc session turn

Changed on

Sends an abort RPC to the session runtime, ending the current turn while keeping the session alive. Body handling is intentionally lenient — cancel is a stop control, so unknown fields are ignored and an invalid or missing body is treated as empty rather than rejected.

post/linc/v1/sessions/{id}/cancel

Request

  • Base URL
    https://api.case.dev
  • URL
    https://api.case.dev/linc/v1/sessions/{id}/cancel
  • Auth
    HTTP bearer

Path parameters

idstring required

Request body

clearQueueboolean

Also clear queued steering/follow-up messages so the abort leaves the agent fully idle. Cleared texts are returned in the response.data.clearedQueue field of the response body. Without it, messages still queued when the abort settles are auto-continued as a new run. Runtimes older than the Linc release that supports this flag ignore it: the abort still happens but the queue is left untouched.

Response

Cancel accepted. Includes the native Pi RPC abort response as response (with response.data.clearedQueue when clearQueue was requested and the runtime supports it).

Changes