GET

Get users in organization

Returns all the users of a specified organization.

Request

Path parameters

organizationId

string

Required

Query parameters

start

number

limit

number

Responses

Returns a paged list of users of the organization

application/json

object
GET/servicedeskapi/organization/{organizationId}/user
1 2 3 curl --request GET \ --url 'http://{baseurl}/rest/servicedeskapi/organization/{organizationId}/user' \ --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 25 26 27 28 29 30 31 { "_expands": [ "<string>" ], "size": 1, "start": 0, "limit": 50, "isLastPage": true, "_links": { "base": "<string>", "context": "<string>", "next": "<string>", "prev": "<string>", "self": "<string>" }, "values": [ { "name": "<string>", "key": "<string>", "emailAddress": "<string>", "displayName": "<string>", "active": true, "timeZone": "<string>", "_links": { "jiraRest": "<string>", "avatarUrls": {}, "self": "<string>" } } ] }
POST

Add users to organization

Adds users to an organization.

Request

Path parameters

organizationId

string

Required

Request bodyapplication/json

The DTO of the users to add.

usernames

array<string>

Responses

Add User to organization was successful

POST/servicedeskapi/organization/{organizationId}/user
1 2 3 4 5 6 7 8 curl --request POST \ --url 'http://{baseurl}/rest/servicedeskapi/organization/{organizationId}/user' \ --header 'Content-Type: application/json' \ --data '{ "usernames": [ "<string>" ] }'
DEL

Remove users from organization

Removes users from an organization.

Request

Path parameters

organizationId

string

Required

Request bodyapplication/json

The DTO of the users to add.

usernames

array<string>

Responses

Remove User from organization was successful

DEL/servicedeskapi/organization/{organizationId}/user
1 2 3 4 5 6 7 8 curl --request DELETE \ --url 'http://{baseurl}/rest/servicedeskapi/organization/{organizationId}/user' \ --header 'Content-Type: application/json' \ --data '{ "usernames": [ "<string>" ] }'
GET

Preview the clean up of organizations

Preview the cleanup of empty organizations, with the same support parameters.

Request

Query parameters

deleteDetachedOrganizations

string

deleteOrganizationsWithInactiveUsers

string

Responses

Returns a list of organizations that will be deleted, given the parameter.

application/json

array<CustomerOrganization>

GET/servicedeskapi/organization/cleanup
1 2 3 curl --request GET \ --url 'http://{baseurl}/rest/servicedeskapi/organization/cleanup' \ --header 'Accept: application/json'
200Response
1 2 3 4 5 6 [ { "name": "<string>", "id": 2154 } ]
DEL

Clean up organizations

Deletes empty organizations, optionally delete organizations that have no active users, or are not attached to any projects.

Request

Query parameters

deleteDetachedOrganizations

string

deleteOrganizationsWithInactiveUsers

string

Responses

Clean up organizations was successful. The number of deleted organizations is returned.

application/json

integer

DEL/servicedeskapi/organization/cleanup
1 2 3 curl --request DELETE \ --url 'http://{baseurl}/rest/servicedeskapi/organization/cleanup' \ --header 'Accept: application/json'
GET

Get all organizations

Returns a list of organizations in the Jira instance.If the user is not an agent, the resource returns a list of organizations the user is a member of.

Request

Query parameters

start

number

limit

number

Responses

Returns paginated list of organizations

application/json

object
GET/servicedeskapi/organization
1 2 3 curl --request GET \ --url 'http://{baseurl}/rest/servicedeskapi/organization' \ --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 25 { "_expands": [ "<string>" ], "size": 1, "start": 0, "limit": 50, "isLastPage": true, "_links": { "base": "<string>", "context": "<string>", "next": "<string>", "prev": "<string>", "self": "<string>" }, "values": [ { "id": "<string>", "name": "<string>", "_links": { "self": "<string>" } } ] }
POST

Create organization

To create an organization Jira administrator global permission or agent permission is required depending on the settings

Request

Request bodyapplication/json

The DTO of the organization to create.

name

string

Responses

Return the newly created organization.

application/json

OrganizationDTO
POST/servicedeskapi/organization
1 2 3 4 5 6 7 curl --request POST \ --url 'http://{baseurl}/rest/servicedeskapi/organization' \ --header 'Accept: application/json' \ --header 'Content-Type: application/json' \ --data '{ "name": "<string>" }'
200Response
1 2 3 4 5 6 7 { "id": "<string>", "name": "<string>", "_links": { "self": "<string>" } }
GET

Get organization

Returns an organization for a given organization ID.

Request

Path parameters

organizationId

string

Required

Responses

Returns the requested organization

application/json

OrganizationDTO
GET/servicedeskapi/organization/{organizationId}
1 2 3 curl --request GET \ --url 'http://{baseurl}/rest/servicedeskapi/organization/{organizationId}' \ --header 'Accept: application/json'
200Response
1 2 3 4 5 6 7 { "id": "<string>", "name": "<string>", "_links": { "self": "<string>" } }
DEL

Delete organization

Deletes an organization for a given organization ID.

Request

Path parameters

organizationId

string

Required

Responses

Delete organization was successful.

DEL/servicedeskapi/organization/{organizationId}
1 2 curl --request DELETE \ --url 'http://{baseurl}/rest/servicedeskapi/organization/{organizationId}'

Rate this page: