ATatlassian
Maintenances

List team maintenances

This endpoint is used to retrieve a list of maintenance associated with a specific team in the Jira Service Management system. It optionally takes three parameters - offset, size and type.

get/api/{cloudId}/v1/teams/{teamId}/maintenances

Request

  • Base URL
    https://api.atlassian.com/jsm/ops
  • URL
    https://api.atlassian.com/jsm/ops/api/{cloudId}/v1/teams/{teamId}/maintenances
  • Auth
    • HTTP basic
    • or OAuth 2
      Authorization code: https://auth.stg.atlassian.com/authorize
      Token URL: https://auth.stg.atlassian.com/oauth/token scopes: read:ops-config:jira-service-management

Path parameters

teamIdstring required

Identifier of the maintenance owning team.

Query parameters

type'all' | 'non-expired' | 'past'

Defines which maintenance will be listed according to maintenance status.

offsetinteger

The offset parameter controls the starting point within the collection of resource results.

sizeinteger

The limit parameter controls the maximum number of items that may be returned for a single request.

Response

Returned if the request is successful.

Example response

{
  "values": [
    {
      "teamId": "77b933c9-92bb-46e7-a73c-764b8d7c3c25",
      "id": "0762db96-f795-4246-90be-edd295af8fca",
      "status": "cancelled",
      "description": "Maintenance Plan",
      "startDate": "2023-12-11T11:37:40.501Z",
      "endDate": "2023-12-11T11:42:40.501Z",
      "rules": [
        {
          "state": "disabled",
          "entity": {
            "id": "51e9e162-767b-47a6-a00a-4cd8b6f94829",
            "type": "integration"
          }
        }
      ]
    }
  ],
  "links": {
    "next": "/v1/maintenances?offset=50&size=25"
  }
}

Changes

No recorded changes to this operation across all 5 revisions of this API.