Skip to main content

Read one saved RSVP-TE topology create operation

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

Reads the durable admission by task, agent and operation ID, including after Core restart. Only terminal persisted means the task profile was saved. confirming and uncertain require observing the runtime before any further topology edit. This route never sends or retries native mutations and hides private request bodies and agent addresses.

Contract

Parameter
Value
Sectiontasks
AuthenticationCookieAuth
Consumesapplication/json
Producesapplication/json

Parameters

2 parameters

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

Responses

5 responses

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