---
title: "/api/stations/v1/stations/{stationId}/app-assignments/{appAssignmentId}"
slug: "apistationsv1stationsstationidapp-assignmentsappassignmentid-1"
updated: 2024-10-17T20:32:06Z
published: 2024-10-17T20:32:06Z
canonical: "support.tulip.co/apistationsv1stationsstationidapp-assignmentsappassignmentid-1"
---

> ## 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/stations/{stationId}/app-assignments/{appAssignmentId}

Put/api/stations/v1/stations/{stationId}/app-assignments/{appAssignmentId}

Updates a specific app assignment for a station.

Path parametersstationIdRequired

The id of the station to update.

Exampleg56RCoZCtzv7borvp
appAssignmentIdRequired

The id of the app assignment to update.

Exampleg56RCoZCtzv7borvp

Body parameters

The fields to update an app assignment.

<select class='api-response-data' aria-label='Media type'><option value='643d964a-8a8d-4b11-bd27-5b26b71a8d40'>application/json</option>
</select>object 

Represents the contents of a single app assignment.

Example{
  "type": "app",
  "tag": "development",
  "appId": "swM2aGebq5MjhKafN"
}#content#OneOfAllAppAssignmenttypestring    RequiredValid values[
  "all"
]Default"all"
tagstring    Required

The tag of an app assignment. Determines if the app assignment refers to the development version of an app or the latest production version.

Valid values[
  "development",
  "latest-published"
]

FolderAppAssignmenttypestring    RequiredValid values[
  "app-folder"
]Default"app-folder"
tagstring    Required

The tag of an app assignment. Determines if the app assignment refers to the development version of an app or the latest production version.

Valid values[
  "development",
  "latest-published"
]
appFolderIdExampleg56RCoZCtzv7borvp

SpecificAppAssignmenttypestring    RequiredValid values[
  "app"
]Default"app"
tagstring    Required

The tag of an app assignment. Determines if the app assignment refers to the development version of an app or the latest production version.

Valid values[
  "development",
  "latest-published"
]
appIdExampleg56RCoZCtzv7borvp

VersionAppAssignmenttypestring    RequiredValid values[
  "app-version"
]Default"app-version"
appVersionIdExampleg56RCoZCtzv7borvp

Responses200

The app assignment was successfully updated.

<select class='api-response-data' aria-label='Media type'><option value='7d9e739e-9e42-4c47-8bc0-80c5292de589'>application/json</option>
</select>object 

App assignments are added to stations and station groups to restrict what apps are allowed to run at respective stations.

Example{
  "id": "12M2aGebq5MjhKafN",
  "type": "app",
  "tag": "development",
  "appId": "swM2aGebq5MjhKafN"
}idExampleg56RCoZCtzv7borvp
OneOf

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='bb859b2c-eeac-448f-b3b1-edf4e0b5bec5'>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='e6aeea59-ee05-48c5-a5d1-73a6493b9609'>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='c3d7ad7e-2410-47e4-bc4b-e1321f7a91ef'>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

Conflicting app assignment detected. Only one app assignment can be specified for a specific app, app folder or all apps.

This error is not automatically retryable.

<select class='api-response-data' aria-label='Media type'><option value='5f49fa7d-5bb7-4e0d-9306-2547f3a0db24'>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 appAssignmentKindstring    

422

An error occurred. The Tulip error codes `generic.archivedResourceUnsupportedOperation` and `stations.invalidReferencedResourceId` both use the 422 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='b0f071d5-5d17-4037-9240-25e0cc258c40'>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.

details Array of object   

A list of invalid referenced resources.

object resourceIdstring    

The id of the invalid resource.

detailsstring    

Details about why the resource was invalid.

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='768a74ff-1245-4738-be60-608d43ce4632'>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='33b3ae08-cb35-4e7c-833b-787d5e742259'>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.