• Organization
  • Customer
Cloud
Customer Service Management / / REST API

Organization

Postman Collection
OpenAPI
GET

Get an organization by id

Returns an organization, including its details.

read:organization:jira-service-management
,
read:organization.detail:jira-service-management

Request

Path parameters

organizationId

OrganizationId

Required

Responses

Returns the requested organization along with its details.

application/json

Organization
GET/api/v1/organization/{organizationId}
1 2 3 4 curl --request GET \ --url '{host}/{basePath}/api/v1/organization/{organizationId}' \ --header 'Authorization: Bearer <access_token>' \ --header 'Accept: application/json'
200Response
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 { "id": "123", "name": "Atlassian", "details": [ { "id": "321", "name": "Region", "type": { "name": "SELECT", "options": [ "AU", "EU", "US" ] }, "values": [ "EU" ], "configuration": { "position": 41 } } ] }
PUT

Update the value of a detail field for a given organization

Updates and returns the new value(s) of the updated field, along with its general configuration (such as ID and Type).

write:organization.detail-field:jira-service-management

Request

Path parameters

organizationId

OrganizationId

Required

Query parameters

fieldName

string

Required

Request bodyapplication/json

The value(s) of the field to update.

Min properties: 1
values

array<string>

Responses

On success, returns the updated field value(s).

application/json

UpdateDetailFieldResponse
PUT/api/v1/organization/{organizationId}/details
1 2 3 4 5 6 7 8 9 10 curl --request PUT \ --url '{host}/{basePath}/api/v1/organization/{organizationId}/details?fieldName=Region' \ --header 'Authorization: Bearer <access_token>' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --data '{ "values": [ "EU" ] }'
200Response
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 { "id": "321", "name": "Region", "type": { "name": "SELECT", "options": [ "AU", "EU", "US" ] }, "values": [ "EU" ] }

Rate this page: