Sign in

v62

latestOpenAPI 3.1.0Dual (AGPL3.0, Commercial License Available)raw.githubusercontent.com2026-08-03211303932.5 KB
Bindings

Update a Binding

Updates an existing binding. The same conflict detection rules from binding creation apply.

Validation Rules

  • Conflict detection: The updated binding must not conflict with other bindings on the same service. Interface bindings conflict with port bindings on the same interface.
put/api/v1/bindings/{id}

Path parameters

idstring uuid required

Binding ID

Request body

OR

Example request

{
  "created_at": "2026-07-29T15:23:06.660397Z",
  "first_discovery_id": null,
  "id": "bdb8981f-4fca-4ed5-a9f6-0ee40dfa6ca7",
  "ip_address_id": "550e8400-e29b-41d4-a716-446655440005",
  "last_discovery_id": null,
  "last_seen_at": "2026-07-29T15:23:06.660397Z",
  "lineage_id": null,
  "network_id": "550e8400-e29b-41d4-a716-446655440002",
  "port_id": "550e8400-e29b-41d4-a716-446655440006",
  "service_id": "550e8400-e29b-41d4-a716-446655440007",
  "type": "Port",
  "updated_at": "2026-07-29T15:23:06.660397Z",
  "valid_from": "2026-07-29T15:23:06.660397Z",
  "valid_to": null
}

Response

Binding updated

errorstring nullable

Human-readable failure message. Omitted on success.

successboolean required

true when the request succeeded. false responses carry error instead of data.

Example response

{
  "data": {
    "created_at": "2026-07-29T15:23:06.672964Z",
    "first_discovery_id": null,
    "id": "93be57ee-b9bd-4938-b65c-f9f7d4caa974",
    "ip_address_id": "550e8400-e29b-41d4-a716-446655440005",
    "last_discovery_id": null,
    "last_seen_at": "2026-07-29T15:23:06.672964Z",
    "lineage_id": null,
    "network_id": "550e8400-e29b-41d4-a716-446655440002",
    "port_id": "550e8400-e29b-41d4-a716-446655440006",
    "service_id": "550e8400-e29b-41d4-a716-446655440007",
    "type": "Port",
    "updated_at": "2026-07-29T15:23:06.672964Z",
    "valid_from": "2026-07-29T15:23:06.672964Z",
    "valid_to": null
  },
  "meta": {
    "api_version": 1,
    "server_version": "0.17.7"
  }
}