MENU
    /api/stations/v1/stations/{stationId}/app-assignments
    • 17 Oct 2024
    • 4 Minutes to read
    • Contributors

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


    Article summary

    Get
    /api/stations/v1/stations/{stationId}/app-assignments

    Gets a paginated list of station app assignments.

    Path parameters
    stationId
    Required

    The id of the station to update.

    Exampleg56RCoZCtzv7borvp
    Query parameters
    limit
    integer

    Limits the number of documents listed.

    Minimum0
    Example1
    offset
    integer

    Returns documents after a certain offset. Use with limit to paginate the response.

    Minimum0
    Example0
    Responses
    200

    A paginated list of app assignments.

    Collapse all
    object
    items
    Array of object (AppAssignment)
    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" }
    id
    Exampleg56RCoZCtzv7borvp
    OneOf
    count
    number

    The total number of items that matched the list parameters.

    Example10
    nextPage
    string (url)

    A URL at which the next page of results can be fetched.

    prevPage
    string (url)

    A URL at which the previous page of results can be fetched.

    errors
    Array of object (PaginatedItemError)

    A list of errors per item that is omitted from the paginated response, if any.

    object
    Example{ "errorCode": "generic.internal", "message": "Something went wrong.", "retryable": false, "details": { "id": "invalidRecordId" } }
    400

    An error occurred. The Tulip error codes generic.customerIdRequired, generic.workspaceIdRequired, generic.invalidParams, http.invalidBodyJson, http.invalidHeaders, http.multiValueHeader, generic.limitParamNonNegativeInt, generic.limitParamBounds, and generic.offsetParamNonNegativeInt 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.

    Collapse 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.

    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.

    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.

    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.

    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.

    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.

    details
    object
    headerName
    string

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

    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.

    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.

    details
    object
    upperBound
    integer

    The maximum allowed value for the limit parameter.

    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.

    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.

    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.

    429

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

    This error is not automatically retryable.

    Collapse 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.

    details
    object
    details
    string

    Additional details about this endpoint's rate limits.

    500

    An error occurred. The Tulip error codes generic.internal and stations.internalTypeValidationError both use the 500 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.

    Collapse 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.

    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.

    details
    object
    resourceName
    string

    The name of the resource that failed validation.

    resourceId
    string

    The id of the resource that failed validation.


    Was this article helpful?