SCscanopy
Bindings

Update binding

Changed on

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}

Request

  • Base URL
    https://app.scanopy.net
  • URL
    https://app.scanopy.net/api/v1/bindings/{id}
  • Auth
    • API key in header Authorization
    • or API key in cookie session_id

Path parameters

idstring uuid required

Binding ID

Request body

OR

Example request

{
  "created_at": "2026-10-30T13:27:50.744872Z",
  "first_discovery_id": null,
  "id": "3603dc76-ffb6-47f1-ba9d-a903cb048663",
  "ip_address_id": "550e8400-e29b-41d4-a716-446655440005",
  "last_discovery_id": null,
  "last_seen_at": "2026-10-30T13:27:50.744872Z",
  "lineage_id": null,
  "port_id": "550e8400-e29b-41d4-a716-446655440006",
  "service_id": "550e8400-e29b-41d4-a716-446655440007",
  "site_id": "550e8400-e29b-41d4-a716-446655440002",
  "type": "Port",
  "updated_at": "2026-10-30T13:27:50.744872Z",
  "valid_from": "2026-10-30T13:27:50.744872Z",
  "valid_to": null
}

Response

Binding updated

errorstring nullable

Not sent on a successful response. Failure messages arrive in an ApiErrorResponse.

successboolean required

Always true on a successful response.

Example response

{
  "data": {
    "created_at": "2026-10-30T13:27:50.781197Z",
    "first_discovery_id": null,
    "id": "1197e35a-b113-4b09-af4b-58ac52b5a228",
    "ip_address_id": "550e8400-e29b-41d4-a716-446655440005",
    "last_discovery_id": null,
    "last_seen_at": "2026-10-30T13:27:50.781197Z",
    "lineage_id": null,
    "port_id": "550e8400-e29b-41d4-a716-446655440006",
    "service_id": "550e8400-e29b-41d4-a716-446655440007",
    "site_id": "550e8400-e29b-41d4-a716-446655440002",
    "type": "Port",
    "updated_at": "2026-10-30T13:27:50.781197Z",
    "valid_from": "2026-10-30T13:27:50.781197Z",
    "valid_to": null
  },
  "meta": {
    "api_version": 1,
    "server_version": "0.19.4"
  }
}

Changes

  • a6ea2ab6fbb9Revision changes
    • breaking

      added the new required request property /////

    • breaking

      removed the required property ////// from the response with the status

    • warning

      removed the request property /////

    • info

      added the required property ////// to the response with the status

  • d38c20597ec1Revision changes
    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status

    • info

      added the optional property // to the response with the status