Skip to main content

Read a saved RSVP-TE Path operation

POST
/tasks/{id}/rsvp/path/query

Reads the durable operation scoped to task, agent and operation ID. Available after core restart and task stop, without a live tracker. Only terminal status persisted confirms the task profile was saved. admitted/confirming are not completion; uncertain requires a fresh runtime query before any new operation. Does not dispatch or retry native actions and hides private requests, addresses and profiles.

Contract

Parameter
Value
Sectiontasks
AuthenticationCookieAuth
Consumesapplication/json
Producesapplication/json

Parameters

2 parameters

Name
Location
Required
Type
Description
idpathyesintegerTask ID
requestbodyyesobjectAgent and 32 lowercase hex digit operation ID
  • {
      "agent": "<string>",
      "operation-id": "<string>"
    }

Responses

5 responses

Status
Description
Type
200
OKobject
400
Invalid task ID or referenceobject
401
Session requiredobject
404
Task or operation not foundobject
500
Database failureobject
  • {
      "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>"
    }