Skip to main content

Cancel one RSVP-TE measurement

POST
/tasks/{id}/rsvp/measurement/cancel

Forwards cancellation only to the same registered agent of a RUNNING task. The agent checks the exact task and runtime generation and persists cancellation intent. A saved terminal measurement is returned without mutation. Cancellation is asynchronous; query until terminal.

Contract

Parameter
Value
Sectiontasks
AuthenticationCookieAuth
Consumesapplication/json
Producesapplication/json

Parameters

2 parameters

Name
Location
Required
Type
Description
idpathyesintegerPositive task ID
requestbodyyesobjectNamed agent and sealed measurement identity; at most 64 KiB
  • {
      "agent": "<string>",
      "measurement-id": "<string>",
      "runtime-generation": "<string>"
    }

Responses

11 responses

Status
Description
Type
200
Persisted record; sync-error means saved nonterminal status may be staleobject
202
Accepted asynchronously; record saved before this responseobject
400
Invalid JSON, identity, ID or timingobject
401
Session requiredobject
403
Agent is not a routing agent of this task, or agent license deniedobject
404
Task or measurement not foundobject
409
Task, process, agent registration or idempotency conflictobject
500
Database error; post-dispatch persistence failure explicitly requires queryobject
502
Agent authentication, address, transport, redirect, bounded response or contract errorobject
504
Mutation deadline exceeded; outcome uncertain, query the same IDobject
default
Other validated agent HTTP errors are preserved on mutationobject
  • {
      "agent": "<string>",
      "measurement-id": "<string>",
      "record": {},
      "runtime-generation": "<string>",
      "saved": true,
      "status": "<string>",
      "sync-error": "<string>",
      "terminal": true,
      "updated-at": "<string>"
    }
  • {
      "agent": "<string>",
      "measurement-id": "<string>",
      "record": {},
      "runtime-generation": "<string>",
      "saved": true,
      "status": "<string>",
      "sync-error": "<string>",
      "terminal": true,
      "updated-at": "<string>"
    }
  • {
      "data": {},
      "error": "<string>"
    }
  • {
      "data": {},
      "error": "<string>"
    }
  • {
      "data": {},
      "error": "<string>"
    }
  • {
      "data": {},
      "error": "<string>"
    }
  • {
      "data": {},
      "error": "<string>"
    }
  • {
      "data": {},
      "error": "<string>"
    }
  • {
      "data": {},
      "error": "<string>"
    }
  • {
      "data": {},
      "error": "<string>"
    }
  • {}