Apply and persist one RSVP-TE Path

POST

/tasks/{id}/rsvp/path/apply

Validates one complete configured ingress LSP on a registered RUNNING routing agent. Requires the profile hash from query, current native generation/active ID/Path revision and a client operation ID (32 lowercase hex digits). Omit mbb for an in-place Path update. With mbb, supply all Path parameters, P2P ERO or the complete P2MP leaf-routes, current attempts and candidate ID/range; topology/interface changes are not supported. MBB dry-run selects a candidate and returns its effective P2P ERO or P2MP leaf routes, sealed before one explicit-ID dispatch. User input routes remain in the saved profile; normalized native routes are used only for completion proof. 202 is admission, not success: poll path/query until terminal. MBB persisted requires matching operation ID, attempt, completed retirement and requested parameters in two native observations, followed by an atomic task-profile CAS. Rollback/Stop does not save the new profile. Recovery only queries and never replays actions. Neighbour range identities/session names and product port bindings are preserved; the configured anchor LSP ID remains unchanged after MBB.

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	Sealed Path Apply request, at most 64 KiB

Parameter request: object

{
  "agent": "<string>",
  "expected-active-lsp-id": 0,
  "expected-path-revision": 0,
  "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
  },
  "mbb": {
    "expected-mbb-attempts": 0,
    "lsp-id-end": 0,
    "lsp-id-start": 0,
    "new-lsp-id": 0,
    "retire-delay-ms": 0,
    "setup-timeout-ms": 0,
    "switch-delay-ms": 0
  },
  "operation-id": "<string>",
  "path": {},
  "runtime-generation": "<string>"
}

Responses

9 responses

Status	Description	Type
202	Saved operation; query terminal status	object
400	Invalid identity, guards, Path or configured range	object
401	Session required	object
403	Agent is not registered for the task or license denied	object
404	Task, agent or LSP not found	object
409	Task, runtime, profile or operation conflicts	object
500	Database failure	object
502	Agent transport, redirect or response contract failure before admission	object
default	Other native validation HTTP errors are preserved	object

Response 202: object

{
  "active-lsp-id": 0,
  "agent": "<string>",
  "created-at": "<string>",
  "dispatched": true,
  "expires-at": "<string>",
  "identity": {},
  "mbb": {
    "before-completed": 0,
    "before-rollbacks": 0,
    "previous-active-lsp-id": 0,
    "target-attempt": 0
  },
  "mode": "path",
  "operation-id": "<string>",
  "reason": "<string>",
  "runtime-generation": "<string>",
  "status": "<string>",
  "target-path-revision": 0,
  "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>" }
{ "data": {}, "error": "<string>" }
{}