---
title: "/api/stations/v1/station-groups/{stationGroupId}/archive"
slug: "apistationsv1station-groupsstationgroupidarchive"
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/station-groups/{stationGroupId}/archive

Post/api/stations/v1/station-groups/{stationGroupId}/archive

Archives a station group. Stations and station groups within the group are archived as well. Restore is not supported at the moment.

Path parametersstationGroupIdRequired

The id of the station group to archive.

Exampleg56RCoZCtzv7borvp

Responses200

The station group was successfully archived.

<select class='api-response-data' aria-label='Media type'><option value='d85257a2-5c80-4a82-b863-a5502c8e6383'>application/json</option>
</select>Expand Allobject 

Represents a station group.

Example{
  "id": "swM2aGebq5MjhKafN",
  "name": "Boston",
  "description": "Contains all the stations in the Boston factory.",
  "appAssignments": [
    {
      "id": "78M2aGebq5MjhKafN",
      "type": "app-folder",
      "tag": "latest-published",
      "appFolderId": "12M2aGebq5MjhKafN"
    }
  ],
  "created": {
    "at": "2023-03-08T12:17:24Z",
    "by": {
      "id": "90M2aGebq5MjhKafN",
      "type": "user"
    }
  },
  "lastModified": {
    "at": "2023-03-08T12:17:24Z",
    "by": {
      "id": "90M2aGebq5MjhKafN",
      "type": "user"
    }
  },
  "workspaces": {
    "scope": "specific",
    "workspaceIds": [
      "56M2aGebq5MjhKafN"
    ]
  }
}idExampleg56RCoZCtzv7borvp
namestring    

The name of the station group.

parentIdExampleg56RCoZCtzv7borvp
descriptionstring    

A short description of the station group.

createdatstring  (date-time)    

A date-time string as defined by [RFC 3339 §5.6](https://tools.ietf.org/html/rfc3339#section-5.6).

Example2022-11-21T07:59:10Z
byobject (ActorMetadata) 

Represents a user, api-token, or device.

typestring    Valid values[
  "user",
  "client",
  "api-token",
  "app-exchange-api-token",
  "celosx-api-token",
  "automation",
  "instance-init"
]
idExampleg56RCoZCtzv7borvp

lastModifiedatstring  (date-time)    

A date-time string as defined by [RFC 3339 §5.6](https://tools.ietf.org/html/rfc3339#section-5.6).

Example2022-11-21T07:59:10Z
byobject (ActorMetadata) 

Represents a user, api-token, or device.

typestring    Valid values[
  "user",
  "client",
  "api-token",
  "app-exchange-api-token",
  "celosx-api-token",
  "automation",
  "instance-init"
]
idExampleg56RCoZCtzv7borvp

archivedatstring  (date-time)    

A date-time string as defined by [RFC 3339 §5.6](https://tools.ietf.org/html/rfc3339#section-5.6).

Example2022-11-21T07:59:10Z
byobject (ActorMetadata) 

Represents a user, api-token, or device.

typestring    Valid values[
  "user",
  "client",
  "api-token",
  "app-exchange-api-token",
  "celosx-api-token",
  "automation",
  "instance-init"
]
idExampleg56RCoZCtzv7borvp

workspacesobject (WorkspaceMembership) 

A description of the workspaces of which a resource is a member. Workspace membership can have one of two `scope` values. A `scope` of `all` means that a resource is a member of all current and future workspaces. A `scope` of the value `specific` means that a resource is a member of a set of particular workspaces as described by the `workspaceIds` property.

Example{
  "scope": "specific",
  "workspaceIds": [
    "DEFAULT"
  ]
}#content#OneOfAllWorkspacesMembershipscopestring    

Describes a resource as a member of all current and future workspaces.

Valid values[
  "all"
]Exampleall

SpecificWorkspacesMembershipscopestring    

Describes a resource as a member of a set of specific workspaces.

Valid values[
  "specific"
]Examplespecific
workspaceIds Array of string (WorkspaceId)   

The workspaces in which a resource is a member.

string    ExampleDEFAULT

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='16e6157a-9311-41ce-a772-2ff636ce6f5a'>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='55fe28f1-d7f8-4347-89ef-0ca41a4783d9'>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='18fdef6b-cab1-4ddd-9fa7-d5370a3f590d'>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.

422

This operation is not permitted on the requested resource because it is archived.

This error is not automatically retryable.

<select class='api-response-data' aria-label='Media type'><option value='3dc47bec-cfca-4420-9dc5-4d410a09a5ad'>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.

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='7e5a48a2-3e54-483b-a23d-4740a35dff74'>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 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.

<select class='api-response-data' aria-label='Media type'><option value='86576bd5-4133-4b29-8615-2eb449f788b3'>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.

detailsobject resourceNamestring    

The name of the resource that failed validation.

resourceIdstring    

The id of the resource that failed validation.
