---
title: "/api/stations/v1/interfaces/{interfaceId}/station-assignment"
slug: "apistationsv1interfacesinterfaceidstation-assignment-1"
updated: 2024-10-17T20:32:06Z
published: 2024-10-17T20:32:06Z
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.tulip.co/llms.txt
> Use this file to discover all available pages before exploring further.

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

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

Updates which station this interface is assigned to.

Path parametersinterfaceIdRequired

The unique identifier for an interface.

Exampleg56RCoZCtzv7borvp

Query parametersreplaceInterfaceAtStationboolean

If set to true, indicates that if there is already an interface assigned to the station it will be replaced.

Body parameters

The information about the station to assign this interface to.

<select class='api-response-data' aria-label='Media type'><option value='d503ec2a-87df-4955-88b7-7b1d4b0957bd'>application/json</option>
</select>object 

Station assignment for an interface.

Example{
  "stationId": "78M2aGebq5MjhKafN"
}stationIdExampleg56RCoZCtzv7borvp

Responses200

The interface was successfully assigned to the given station.

<select class='api-response-data' aria-label='Media type'><option value='82a78f3b-e13d-4488-9175-9927adee820c'>application/json</option>
</select>object 

Station assignment for an interface.

Example{
  "stationId": "78M2aGebq5MjhKafN"
}stationIdExampleg56RCoZCtzv7borvp

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.

<select class='api-response-data' aria-label='Media type'><option value='09de7368-024a-4360-86ad-481b1c6b7d59'>application/json</option>
</select>Expand AllOneOfobjecterrorCodestring    

A machine-readable code identifying the type of error.

Pattern^[a-zA-Z0-9.]$
messagestring    

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

The exact content of this message is not stable.

retryableboolean    

Whether the request can be automatically retried by the client.

objecterrorCodestring    

A machine-readable code identifying the type of error.

Pattern^[a-zA-Z0-9.]$
messagestring    

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

The exact content of this message is not stable.

retryableboolean    

Whether the request can be automatically retried by the client.

objecterrorCodestring    

A machine-readable code identifying the type of error.

Pattern^[a-zA-Z0-9.]$
messagestring    

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

The exact content of this message is not stable.

retryableboolean    

Whether the request can be automatically retried by the client.

objecterrorCodestring    

A machine-readable code identifying the type of error.

Pattern^[a-zA-Z0-9.]$
messagestring    

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

The exact content of this message is not stable.

retryableboolean    

Whether the request can be automatically retried by the client.

objecterrorCodestring    

A machine-readable code identifying the type of error.

Pattern^[a-zA-Z0-9.]$
messagestring    

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

The exact content of this message is not stable.

retryableboolean    

Whether the request can be automatically retried by the client.

objecterrorCodestring    

A machine-readable code identifying the type of error.

Pattern^[a-zA-Z0-9.]$
messagestring    

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

The exact content of this message is not stable.

retryableboolean    

Whether the request can be automatically retried by the client.

detailsobject headerNamestring    

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

401

The request was missing required authentication information.

This error is not automatically retryable.

<select class='api-response-data' aria-label='Media type'><option value='7709b11f-9f8d-4411-b9ea-109d5c85ff8d'>application/json</option>
</select>object errorCodestring    

A machine-readable code identifying the type of error.

Pattern^[a-zA-Z0-9.]$
messagestring    

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

The exact content of this message is not stable.

retryableboolean    

Whether the request can be automatically retried by the client.

404

The requested resource was not found.

This error is not automatically retryable.

<select class='api-response-data' aria-label='Media type'><option value='f6ee04c6-22af-4c87-8c2d-f6d9c2ab3022'>application/json</option>
</select>object errorCodestring    

A machine-readable code identifying the type of error.

Pattern^[a-zA-Z0-9.]$
messagestring    

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

The exact content of this message is not stable.

retryableboolean    

Whether the request can be automatically retried by the client.

409

Attempts to assign an interface to a station that already has an interface. Please specify replaceInterfaceAtStation parameter if you wish to replace the existing interface.

This error is not automatically retryable.

<select class='api-response-data' aria-label='Media type'><option value='850a3335-a2ca-41bc-a795-07ef3b8ef801'>application/json</option>
</select>Expand Allobject errorCodestring    

A machine-readable code identifying the type of error.

Pattern^[a-zA-Z0-9.]$
messagestring    

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

The exact content of this message is not stable.

retryableboolean    

Whether the request can be automatically retried by the client.

detailsobject stationIdExampleg56RCoZCtzv7borvp

422

Station referenced in this request does not exist

This error is not automatically retryable.

<select class='api-response-data' aria-label='Media type'><option value='bb7fc5ab-53d4-4c5b-b8ab-19bd25459dfc'>application/json</option>
</select>Expand Allobject errorCodestring    

A machine-readable code identifying the type of error.

Pattern^[a-zA-Z0-9.]$
messagestring    

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

The exact content of this message is not stable.

retryableboolean    

Whether the request can be automatically retried by the client.

detailsobject stationIdExampleg56RCoZCtzv7borvp

429

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

This error is not automatically retryable.

<select class='api-response-data' aria-label='Media type'><option value='c9136621-a921-48a8-b77c-93c297fe6217'>application/json</option>
</select>Expand Allobject errorCodestring    

A machine-readable code identifying the type of error.

Pattern^[a-zA-Z0-9.]$
messagestring    

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

The exact content of this message is not stable.

retryableboolean    

Whether the request can be automatically retried by the client.

detailsobject detailsstring    

Additional details about this endpoint's rate limits.

500

An internal server error occurred. Please contact [support@tulip.co](mailto:support@tulip.co) if the error persists.

This error is not automatically retryable.

<select class='api-response-data' aria-label='Media type'><option value='eb99665f-44fe-401c-9704-20e17a779bd1'>application/json</option>
</select>object errorCodestring    

A machine-readable code identifying the type of error.

Pattern^[a-zA-Z0-9.]$
messagestring    

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

The exact content of this message is not stable.

retryableboolean    

Whether the request can be automatically retried by the client.