Remove one RSVP-TE ingress P2P LSP or P2MP tree

POST

/tasks/{id}/rsvp/topology/delete

Applies deletion to a RUNNING routing agent for one materialized P2P ingress member or one complete P2MP ingress tree. P2P send-detour=true selects the detached ingress detour without deleting its protected primary; the native receipt must retain that role. Requires the current task profile revision, runtime generation, full wire identity, native create receipt or the all-zero startup origin, and a unique 32-digit lowercase hexadecimal delete operation ID. Native dry-run precedes durable admission. After dispatch, recovery only reads the native delete receipt; it never replays the mutation. P2MP completion requires local PathTear TX for every previously sent subgroup. Only terminal persisted means the task profile was saved. Bound streams/PWs and MBB/protection state are rejected by native.

Contract

Parameter	Value
Section	tasks
Authentication	CookieAuth
Consumes	application/json
Produces	application/json

Parameters

2 parameters

Name	Location	Required	Type	Description
id	path	yes	integer	Task ID
request	body	yes	object	P2P or P2MP identity and current guards

Parameter request: object

{
  "agent": "<string>",
  "expected-create-operation-id": "<string>",
  "expected-profile-revision": "<string>",
  "identity": {
    "accept-detour": true,
    "endpoint": "<string>",
    "ext-tunnel-id": "<string>",
    "instance": 0,
    "kind": "p2p",
    "lsp-id": 0,
    "p2mp-id": 0,
    "send-detour": true,
    "sender": "<string>",
    "tunnel-id": 0
  },
  "operation-id": "<string>",
  "runtime-generation": "<string>"
}

Responses

7 responses

Status	Description	Type
202	Durable admission; poll delete/query	object
400	Invalid identity or guard	object
401	Session required	object
403	Agent is not registered for this task or license denied	object
404	Task, agent or LSP not found	object
409	Profile, runtime, binding or operation conflict	object
502	Agent preflight failed	object

Response 202: object

{
  "agent": "<string>",
  "created-at": "<string>",
  "dispatched": true,
  "expires-at": "<string>",
  "identity": {
    "accept-detour": true,
    "endpoint": "<string>",
    "ext-tunnel-id": "<string>",
    "instance": 0,
    "kind": "p2p",
    "lsp-id": 0,
    "p2mp-id": 0,
    "send-detour": true,
    "sender": "<string>",
    "tunnel-id": 0
  },
  "operation-id": "<string>",
  "reason": "<string>",
  "runtime-generation": "<string>",
  "status": "<string>",
  "task-id": 0,
  "terminal": true,
  "updated-at": "<string>"
}

{ "data": {}, "error": "<string>" }
{ "data": {}, "error": "<string>" }
{ "data": {}, "error": "<string>" }
{ "data": {}, "error": "<string>" }
{ "data": {}, "error": "<string>" }
{ "data": {}, "error": "<string>" }