Jira

Jira Organization API

The Organization API from Jira — 6 operation(s) for organization.

GitHub OpenAPI

Operations 14

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /rest/servicedeskapi/organization List all organizations in Service Management · Get organizations #
Ask an LLM
“What customer organizations exist across my whole Jira Service Management instance?”
“Can I find which organizations a particular customer account belongs to?”
Tell an agent
List every organization in the Service Management instance.
Show the organizations that user {accountId} belongs to, instance-wide.
POST /rest/servicedeskapi/organization Create a customer organization · Create organization #
Ask an LLM
“How do I create a new customer organization in the service desk?”
“Is there a length limit on an organization's name?”
Tell an agent
Create an organization called {name}.
Set up a new customer organization named {name}.
DELETE /rest/servicedeskapi/organization/{organizationId} Delete a customer organization · Delete organization #
Ask an LLM
“How do I delete a customer organization entirely?”
“Does deleting an organization also remove its links to service desks?”
Tell an agent destructive · confirm first
Delete organization {organizationId}.
Permanently remove customer organization {organizationId} from the instance.
GET /rest/servicedeskapi/organization/{organizationId} Get an organization's details · Get organization #
Ask an LLM
“What are the details of a specific customer organization?”
“Can I look up an organization's name from its ID?”
Tell an agent
Show the details of organization {organizationId}.
Get the name of organization {organizationId}.
GET /rest/servicedeskapi/organization/{organizationId}/property List an organization's property keys · Get properties keys #
Ask an LLM
“What custom properties has my app stored against an organization?”
“Can I list the property keys set on an organization?”
Tell an agent
List the property keys on organization {organizationId}.
Show which entity properties are stored for organization {organizationId}.
DELETE /rest/servicedeskapi/organization/{organizationId}/property/{propertyKey} Remove an organization property · Delete property #
Ask an LLM
“How do I delete custom data stored on an organization?”
“Can I remove one property key from an organization?”
Tell an agent destructive · confirm first
Delete property {propertyKey} from organization {organizationId}.
Remove the {propertyKey} entity property on organization {organizationId}.
GET /rest/servicedeskapi/organization/{organizationId}/property/{propertyKey} Read an organization property value · Get property #
Ask an LLM
“How do I read the JSON stored in one organization property?”
“What value does a given property key hold for an organization?”
Tell an agent
Get property {propertyKey} of organization {organizationId}.
Show the JSON value of {propertyKey} on organization {organizationId}.
PUT /rest/servicedeskapi/organization/{organizationId}/property/{propertyKey} Store custom data on an organization · Set property #
Ask an LLM
“How can my app store custom data against a customer organization?”
“What's the maximum length of an organization property key?”
Tell an agent
Set property {propertyKey} on organization {organizationId}.
Save custom data under key {propertyKey} for organization {organizationId}.
DELETE /rest/servicedeskapi/organization/{organizationId}/user Remove customers from an organization · Remove users from organization #
Ask an LLM
“How do I take a customer out of an organization?”
“Can I remove multiple users from an organization at once?”
Tell an agent destructive · confirm first
Remove users {accountIds} from organization {organizationId}.
Take customer {accountIds} out of organization {organizationId}.
GET /rest/servicedeskapi/organization/{organizationId}/user List users in an organization · Get users in organization #
Ask an LLM
“Which customers belong to a given organization?”
“Can I check whether a user is part of an organization?”
Tell an agent
List the users in organization {organizationId}.
Show up to {limit} members of organization {organizationId}.
POST /rest/servicedeskapi/organization/{organizationId}/user Add customers to an organization · Add users to organization #
Ask an LLM
“How do I add customers to an organization?”
“Can I add several users to an organization by account ID in one go?”
Tell an agent
Add users {accountIds} to organization {organizationId}.
Put customer {accountIds} into organization {organizationId}.
DELETE /rest/servicedeskapi/servicedesk/{serviceDeskId}/organization Remove an organization from a service desk · Remove organization #
Ask an LLM
“How do I detach an organization from a service desk without deleting it?”
“Does removing an unlinked organization from a service desk cause an error?”
Tell an agent destructive · confirm first
Remove organization {organizationId} from service desk {serviceDeskId}.
Unlink customer organization {organizationId} from service desk {serviceDeskId}.
GET /rest/servicedeskapi/servicedesk/{serviceDeskId}/organization List organizations linked to a service desk · Get organizations #
Ask an LLM
“Which organizations are associated with one particular service desk?”
“Can I see which of a service desk's organizations a user belongs to?”
Tell an agent
List the organizations on service desk {serviceDeskId}.
Show organizations on service desk {serviceDeskId} that include user {accountId}.
POST /rest/servicedeskapi/servicedesk/{serviceDeskId}/organization Add an organization to a service desk · Add organization #
Ask an LLM
“How do I give an organization access to a service desk?”
“What happens if the organization is already on that service desk?”
Tell an agent
Add organization {organizationId} to service desk {serviceDeskId}.
Link service desk {serviceDeskId} with customer organization {organizationId}.

Documentation

📖
Documentation
https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/
📖
Authentication
https://developer.atlassian.com/cloud/jira/platform/rest/v3/intro/#authentication
📖
Documentation
https://developer.atlassian.com/cloud/jira/software/rest/intro/
📖
Documentation
https://developer.atlassian.com/cloud/jira/service-desk/rest/intro/
📖
APIReference
https://developer.atlassian.com/cloud/jira/platform/rest/v3/api-group-issues/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/jira/refs/heads/main/openapi/jira-organization-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/jira:jira-organization-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

jira-organization-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  description: Public REST API for Jira Service Management
  termsOfService: https://www.atlassian.com/legal/customer-agreement
  title: Service Management Public REST Organization API
  version: 1001.0.0-SNAPSHOT-82b018affa468e58f284fbe4df33536469d757df
servers:
- url: https://your-domain.atlassian.net
tags:


# --- truncated at 32 KB (79 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/jira/refs/heads/main/openapi/jira-organization-api-openapi.yml