Skip to main content

Add one RSVP-TE traffic source or receiver to a running task

POST
/tasks/{id}/rsvp/stream/create

A complete stream with one RSVP LSP binding is validated by the Agent before durable admission. After dispatch, Core only queries the native create receipt; it never resends create after an ambiguous response. Only persisted confirms the task profile and exposes the local flow ID. A matching source must be saved before its remote receiver.

Contract

Parameter
Value
Sectiontasks
AuthenticationCookieAuth
Consumesapplication/json
Producesapplication/json

Parameters

2 parameters

Name
Location
Required
Type
Description
idpathyesintegerTask ID
requestbodyyesobjectComplete stream, LSP identity and current profile/runtime guards
  • {
      "agent": "<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>",
      "stream": {}
    }

Responses

8 responses

Status
Description
Type
202
Durable admission; poll stream/queryobject
400
Invalid stream, identity or guardobject
401
Session requiredobject
403
Agent is not registered for this task or license deniedobject
404
Task, agent or RSVP instance not foundobject
409
Profile, runtime or operation conflictobject
500
Database failureobject
502
Agent validation or response contract failureobject
  • {
      "agent": "<string>",
      "created-at": "<string>",
      "dispatched": true,
      "expected-create-operation-id": "<string>",
      "expires-at": "<string>",
      "flow-id": 0,
      "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
      },
      "mode": "<string>",
      "operation-id": "<string>",
      "reason": "<string>",
      "rsvp-wire-flow-id": 0,
      "runtime-generation": "<string>",
      "status": "<string>",
      "stream-name": "<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>"
    }
  • {
      "data": {},
      "error": "<string>"
    }