# Jira Service Management REST API

**Canonical:** https://apis.io/apis/atlassian-jira/atlassian-jira-service-management-api/  
**Provider:** Atlassian Jira — https://apis.io/providers/atlassian-jira/  
**Base URL:** https://your-domain.atlassian.net  
**Documentation:** https://developer.atlassian.com/cloud/jira/service-desk/rest/intro/

Jira Service Management REST API is one of 12 APIs that [Atlassian Jira](https://apis.io/providers/atlassian-jira/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include ITSM and Service Desk. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

The first-party Jira Service Management REST API at /rest/servicedeskapi — 75 operations covering service desks, customer requests, request types, queues, SLAs, organizations, customers and the knowledge base. Harvested verbatim from Atlassian.

## Operations (60 of 75)

| Method | Path | Summary |
|---|---|---|
| GET | `/rest/servicedeskapi/assets/workspace` | Get assets workspaces |
| POST | `/rest/servicedeskapi/customer` | Create customer |
| POST | `/rest/servicedeskapi/customer/skip-permission-check` | Create customer |
| PUT | `/rest/servicedeskapi/customer/user/{accountId}/revoke-portal-only-access` | Revoke portal only access for user |
| GET | `/rest/servicedeskapi/info` | Get info |
| GET | `/rest/servicedeskapi/insight/workspace` | Get insight workspaces |
| GET | `/rest/servicedeskapi/knowledgebase/article` | Get articles |
| GET | `/rest/servicedeskapi/knowledgebase/article/view/{pageId}` | View knowledge base article |
| GET | `/rest/servicedeskapi/organization` | Get organizations |
| POST | `/rest/servicedeskapi/organization` | Create organization |
| DELETE | `/rest/servicedeskapi/organization/{organizationId}` | Delete organization |
| GET | `/rest/servicedeskapi/organization/{organizationId}` | Get organization |
| GET | `/rest/servicedeskapi/organization/{organizationId}/property` | Get properties keys |
| DELETE | `/rest/servicedeskapi/organization/{organizationId}/property/{propertyKey}` | Delete property |
| GET | `/rest/servicedeskapi/organization/{organizationId}/property/{propertyKey}` | Get property |
| PUT | `/rest/servicedeskapi/organization/{organizationId}/property/{propertyKey}` | Set property |
| DELETE | `/rest/servicedeskapi/organization/{organizationId}/user` | Remove users from organization |
| GET | `/rest/servicedeskapi/organization/{organizationId}/user` | Get users in organization |
| POST | `/rest/servicedeskapi/organization/{organizationId}/user` | Add users to organization |
| GET | `/rest/servicedeskapi/request` | Get customer requests |
| POST | `/rest/servicedeskapi/request` | Create customer request |
| POST | `/rest/servicedeskapi/request/validate` | Validate customer request |
| GET | `/rest/servicedeskapi/request/{issueIdOrKey}` | Get customer request by id or key |
| GET | `/rest/servicedeskapi/request/{issueIdOrKey}/approval` | Get approvals |
| GET | `/rest/servicedeskapi/request/{issueIdOrKey}/approval/{approvalId}` | Get approval by id |
| POST | `/rest/servicedeskapi/request/{issueIdOrKey}/approval/{approvalId}` | Answer approval |
| GET | `/rest/servicedeskapi/request/{issueIdOrKey}/attachment` | Get attachments for request |
| POST | `/rest/servicedeskapi/request/{issueIdOrKey}/attachment` | Create comment with attachment |
| GET | `/rest/servicedeskapi/request/{issueIdOrKey}/attachment/{attachmentId}` | Get attachment content |
| GET | `/rest/servicedeskapi/request/{issueIdOrKey}/attachment/{attachmentId}/thumbnail` | Get attachment thumbnail |
| GET | `/rest/servicedeskapi/request/{issueIdOrKey}/comment` | Get request comments |
| POST | `/rest/servicedeskapi/request/{issueIdOrKey}/comment` | Create request comment |
| GET | `/rest/servicedeskapi/request/{issueIdOrKey}/comment/{commentId}` | Get request comment by id |
| GET | `/rest/servicedeskapi/request/{issueIdOrKey}/comment/{commentId}/attachment` | Get comment attachments |
| DELETE | `/rest/servicedeskapi/request/{issueIdOrKey}/notification` | Unsubscribe |
| GET | `/rest/servicedeskapi/request/{issueIdOrKey}/notification` | Get subscription status |
| PUT | `/rest/servicedeskapi/request/{issueIdOrKey}/notification` | Subscribe |
| DELETE | `/rest/servicedeskapi/request/{issueIdOrKey}/participant` | Remove request participants |
| GET | `/rest/servicedeskapi/request/{issueIdOrKey}/participant` | Get request participants |
| POST | `/rest/servicedeskapi/request/{issueIdOrKey}/participant` | Add request participants |
| GET | `/rest/servicedeskapi/request/{issueIdOrKey}/sla` | Get sla information |
| GET | `/rest/servicedeskapi/request/{issueIdOrKey}/sla/{slaMetricId}` | Get sla information by id |
| GET | `/rest/servicedeskapi/request/{issueIdOrKey}/status` | Get customer request status |
| GET | `/rest/servicedeskapi/request/{issueIdOrKey}/transition` | Get customer transitions |
| POST | `/rest/servicedeskapi/request/{issueIdOrKey}/transition` | Perform customer transition |
| DELETE | `/rest/servicedeskapi/request/{requestIdOrKey}/feedback` | Delete feedback |
| GET | `/rest/servicedeskapi/request/{requestIdOrKey}/feedback` | Get feedback |
| POST | `/rest/servicedeskapi/request/{requestIdOrKey}/feedback` | Post feedback |
| GET | `/rest/servicedeskapi/requesttype` | Get all request types |
| GET | `/rest/servicedeskapi/servicedesk` | Get service desks |
| GET | `/rest/servicedeskapi/servicedesk/{serviceDeskId}` | Get service desk by id |
| POST | `/rest/servicedeskapi/servicedesk/{serviceDeskId}/attachTemporaryFile` | Attach temporary file |
| DELETE | `/rest/servicedeskapi/servicedesk/{serviceDeskId}/customer` | Remove customers |
| GET | `/rest/servicedeskapi/servicedesk/{serviceDeskId}/customer` | Get customers |
| POST | `/rest/servicedeskapi/servicedesk/{serviceDeskId}/customer` | Add customers |
| POST | `/rest/servicedeskapi/servicedesk/{serviceDeskId}/customer/invite` | Invite customer |
| POST | `/rest/servicedeskapi/servicedesk/{serviceDeskId}/customer/skip-permission-check` | Add customers |
| GET | `/rest/servicedeskapi/servicedesk/{serviceDeskId}/knowledgebase/article` | Get articles |
| DELETE | `/rest/servicedeskapi/servicedesk/{serviceDeskId}/organization` | Remove organization |
| GET | `/rest/servicedeskapi/servicedesk/{serviceDeskId}/organization` | Get organizations |

…and 15 more operations. They are listed in full on the page.

## Machine-readable artifacts (3)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/atlassian-jira/refs/heads/main/openapi/atlassian-jira-service-management-openapi.json
- **Overlay** — https://raw.githubusercontent.com/api-evangelist/atlassian-jira/refs/heads/main/overlays/atlassian-jira-service-management-overlay.yaml
- **Documentation** — https://developer.atlassian.com/cloud/jira/service-desk/rest/intro/

## Other Atlassian Jira APIs (11)

- [Atlassian Jira Fields API](https://apis.io/apis/atlassian-jira/atlassian-jira-fields-api/)
- [Atlassian Jira Issue Comments API](https://apis.io/apis/atlassian-jira/atlassian-jira-issue-comments-api/)
- [Atlassian Jira Issue Search API](https://apis.io/apis/atlassian-jira/atlassian-jira-issue-search-api/)
- [Atlassian Jira Issue Transitions API](https://apis.io/apis/atlassian-jira/atlassian-jira-issue-transitions-api/)
- [Atlassian Jira Issue Worklogs API](https://apis.io/apis/atlassian-jira/atlassian-jira-issue-worklogs-api/)
- [Atlassian Jira Issues API](https://apis.io/apis/atlassian-jira/atlassian-jira-issues-api/)
- [Atlassian Jira Projects API](https://apis.io/apis/atlassian-jira/atlassian-jira-projects-api/)
- [Atlassian Jira Users API](https://apis.io/apis/atlassian-jira/atlassian-jira-users-api/)
- [Atlassian Jira Cloud Platform REST API v3](https://apis.io/apis/atlassian-jira/atlassian-jira-cloud-platform-api/)
- [Jira Software Cloud API](https://apis.io/apis/atlassian-jira/atlassian-jira-software-cloud-api/)
- [Atlassian Remote MCP Server](https://apis.io/apis/atlassian-jira/atlassian-jira-remote-mcp-server/)

## Tags

ITSM, Service Desk

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/atlassian-jira/atlassian-jira-service-management-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/atlassian-jira/.