/api/stations/v1/interfaces/{interfaceId}/station-assignment
  • 22 Aug 2024
  • 3 Minutes to read
  • Contributors

/api/stations/v1/interfaces/{interfaceId}/station-assignment


Article summary

Delete
/api/stations/v1/interfaces/{interfaceId}/station-assignment

Unassigns an interface from a station by deleting its station assignment.

Path parameters
interfaceId
Required

The unique identifier for an interface.

Exampleg56RCoZCtzv7borvp
Responses
204

The interface was successfully unassigned from its station.

400

An error occurred. The Tulip error codes generic.customerIdRequired, generic.workspaceIdRequired, generic.invalidParams, http.invalidBodyJson, http.invalidHeaders, and http.multiValueHeader all use the 400 HTTP status code. See the documentation of the response content schema for details on these specific Tulip errors that could result in this status code.

Expand All
OneOf
object
errorCode
string

A machine-readable code identifying the type of error.

Pattern^[a-zA-Z0-9.]$
message
string

A human-readable description of the error intended for debugging purposes only.

The exact content of this message is not stable.

retryable
boolean

Whether the request can be automatically retried by the client.

errorCode
Valid values[ "generic.customerIdRequired" ]
retryable
Valid values[ "False" ]
object
errorCode
string

A machine-readable code identifying the type of error.

Pattern^[a-zA-Z0-9.]$
message
string

A human-readable description of the error intended for debugging purposes only.

The exact content of this message is not stable.

retryable
boolean

Whether the request can be automatically retried by the client.

errorCode
Valid values[ "generic.workspaceIdRequired" ]
retryable
Valid values[ "False" ]
object
errorCode
string

A machine-readable code identifying the type of error.

Pattern^[a-zA-Z0-9.]$
message
string

A human-readable description of the error intended for debugging purposes only.

The exact content of this message is not stable.

retryable
boolean

Whether the request can be automatically retried by the client.

errorCode
Valid values[ "generic.invalidParams" ]
retryable
Valid values[ "False" ]
object
errorCode
string

A machine-readable code identifying the type of error.

Pattern^[a-zA-Z0-9.]$
message
string

A human-readable description of the error intended for debugging purposes only.

The exact content of this message is not stable.

retryable
boolean

Whether the request can be automatically retried by the client.

errorCode
Valid values[ "http.invalidBodyJson" ]
retryable
Valid values[ "False" ]
object
errorCode
string

A machine-readable code identifying the type of error.

Pattern^[a-zA-Z0-9.]$
message
string

A human-readable description of the error intended for debugging purposes only.

The exact content of this message is not stable.

retryable
boolean

Whether the request can be automatically retried by the client.

errorCode
Valid values[ "http.invalidHeaders" ]
retryable
Valid values[ "False" ]
object
errorCode
string

A machine-readable code identifying the type of error.

Pattern^[a-zA-Z0-9.]$
message
string

A human-readable description of the error intended for debugging purposes only.

The exact content of this message is not stable.

retryable
boolean

Whether the request can be automatically retried by the client.

errorCode
Valid values[ "http.multiValueHeader" ]
details
object
headerName
string

The name of the given HTTP header which had multiple values.

retryable
Valid values[ "False" ]
401

The request was missing required authentication information.

This error is not automatically retryable.

object
errorCode
string

A machine-readable code identifying the type of error.

Pattern^[a-zA-Z0-9.]$
message
string

A human-readable description of the error intended for debugging purposes only.

The exact content of this message is not stable.

retryable
boolean

Whether the request can be automatically retried by the client.

errorCode
Valid values[ "generic.authRequired" ]
retryable
Valid values[ "False" ]
404

The requested resource was not found.

This error is not automatically retryable.

object
errorCode
string

A machine-readable code identifying the type of error.

Pattern^[a-zA-Z0-9.]$
message
string

A human-readable description of the error intended for debugging purposes only.

The exact content of this message is not stable.

retryable
boolean

Whether the request can be automatically retried by the client.

errorCode
Valid values[ "generic.notFound" ]
retryable
Valid values[ "False" ]
422

Attempts to unassign an interface that is already unassigned.

This error is not automatically retryable.

Expand All
object
errorCode
string

A machine-readable code identifying the type of error.

Pattern^[a-zA-Z0-9.]$
message
string

A human-readable description of the error intended for debugging purposes only.

The exact content of this message is not stable.

retryable
boolean

Whether the request can be automatically retried by the client.

errorCode
Valid values[ "stations.interfaceAlreadyUnassigned" ]
details
object
interfaceId
Exampleg56RCoZCtzv7borvp
retryable
Valid values[ "False" ]
429

Too many requests have been made to this endpoint in a short time period.

This error is not automatically retryable.

Expand All
object
errorCode
string

A machine-readable code identifying the type of error.

Pattern^[a-zA-Z0-9.]$
message
string

A human-readable description of the error intended for debugging purposes only.

The exact content of this message is not stable.

retryable
boolean

Whether the request can be automatically retried by the client.

errorCode
Valid values[ "http.endpointRateLimitExceeded" ]
details
object
details
string

Additional details about this endpoint's rate limits.

retryable
Valid values[ "False" ]
500

An internal server error occurred. Please contact support@tulip.co if the error persists.

This error is not automatically retryable.

object
errorCode
string

A machine-readable code identifying the type of error.

Pattern^[a-zA-Z0-9.]$
message
string

A human-readable description of the error intended for debugging purposes only.

The exact content of this message is not stable.

retryable
boolean

Whether the request can be automatically retried by the client.

errorCode
Valid values[ "generic.internal" ]
retryable
Valid values[ "False" ]

Was this article helpful?