Bindings
Create a new binding
Creates a binding that associates a service with a port or interface.
Binding Types
- Interface binding: Service is present at an interface (IP address) without a specific port. Used for non-port-bound services like gateways.
- Port binding (specific interface): Service listens on a specific port on a specific interface.
- Port binding (all interfaces): Service listens on a specific port on all interfaces
(
interface_id: null).
Validation and Deduplication Rules
- Conflict detection: Interface bindings conflict with port bindings on the same interface. A port binding on all interfaces conflicts with any interface binding for the same service.
- All-interfaces precedence: When creating a port binding with
interface_id: null, any existing specific-interface bindings for the same port are automatically removed, as they are superseded by the all-interfaces binding.
Authorization<token>
User API key (Bearer scp_u_...). Create in Platform > API Keys.
In: header
Request Body
application/json
interface_id*string
Format
uuidnetwork_id*string
Format
uuidservice_id*string
Format
uuidtype*string
Value in
"Interface"Response Body
application/json
application/json
application/json
curl -X POST "https://loading/api/v1/bindings" \ -H "Content-Type: application/json" \ -d '{ "created_at": "2026-01-12T14:59:13.659385Z", "id": "1debd424-12b4-4433-9923-1700e080c4b4", "interface_id": "550e8400-e29b-41d4-a716-446655440005", "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-01-12T14:59:13.659385Z" }'{
"meta": {
"api_version": 1,
"server_version": "0.13.5"
},
"success": true,
"data": {
"created_at": "2026-01-12T14:59:13.668219Z",
"id": "e21ae17b-95a0-4b2f-a653-9c3032022074",
"interface_id": "550e8400-e29b-41d4-a716-446655440005",
"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-01-12T14:59:13.668219Z"
},
"error": "string"
}{
"success": true,
"error": "string"
}{
"success": true,
"error": "string"
}Bulk delete bindings
Previous Page
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.