A policy is a set of rules that apply to a specific area and a particular group, allowing an organization to ensure a basic level of compliance, security, and behavior. All policies have their own distinct set of rules and specifies the types of resources that can be associated with it. All APIs marked as deprecated will be temporarily disabled while we make updates to them.
Returns comprehensive details on organizational policies, including both rules and resources.
OAuth 2.0 scopes required: read:policies:admin
Forge and OAuth2 apps cannot access this REST resource.
string
Requiredstring
Models.PolicyType
The request has succeeded.
1
2
3
4
curl --request GET \
--url 'https://api.atlassian.com/admin/control/v1/orgs/{orgId}/policies' \
--header 'Authorization: Bearer <access_token>' \
--header 'Accept: application/json'1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
{
"data": [
{}
],
"meta": {
"next": "<string>",
"page_size": 25
},
"links": {
"self": "<string>",
"prev": "<string>",
"next": "<string>",
"page_size": "<string>"
}
}Create a policy aligned with your organization's standards.
OAuth 2.0 scopes required: write:policies:admin
Forge and OAuth2 apps cannot access this REST resource.
string
RequiredoneOf [object, object, object]
RequiredThe request has been accepted for processing, but processing has not yet completed.
1
2
3
4
5
6
7
8
curl --request POST \
--url 'https://api.atlassian.com/admin/control/v1/orgs/{orgId}/policies' \
--header 'Authorization: Bearer <access_token>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"data": {}
}'1
2
3
{
"data": {}
}Returns information about a policy by policyId.
OAuth 2.0 scopes required: read:policies:admin
Forge and OAuth2 apps cannot access this REST resource.
string
Requiredstring
RequiredThe request has succeeded.
1
2
3
4
curl --request GET \
--url 'https://api.atlassian.com/admin/control/v1/orgs/{orgId}/policies/{policyId}' \
--header 'Authorization: Bearer <access_token>' \
--header 'Accept: application/json'1
2
3
{
"data": {}
}Update a policy with a policyId.
OAuth 2.0 scopes required: write:policies:admin
Forge and OAuth2 apps cannot access this REST resource.
string
Requiredstring
RequiredoneOf [object, object, Models.DataSecurityPolicy]
RequiredThe request has been accepted for processing, but processing has not yet completed.
1
2
3
4
5
6
7
8
curl --request PUT \
--url 'https://api.atlassian.com/admin/control/v1/orgs/{orgId}/policies/{policyId}' \
--header 'Authorization: Bearer <access_token>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"data": {}
}'1
2
3
{
"data": {}
}Delete a policy with a policyId
OAuth 2.0 scopes required: delete:policies:admin
Forge and OAuth2 apps cannot access this REST resource.
string
Requiredstring
RequiredThe request has been accepted for processing, but processing has not yet completed.
1
2
3
curl --request DELETE \
--url 'https://api.atlassian.com/admin/control/v1/orgs/{orgId}/policies/{policyId}' \
--header 'Authorization: Bearer <access_token>'Returns comprehensive details on organizational policies, including both rules and status.
OAuth 2.0 scopes required: read:policies:admin
Forge and OAuth2 apps cannot access this REST resource.
string
Requiredstring
Models.PolicyType
The request has succeeded.
1
2
3
4
curl --request GET \
--url 'https://api.atlassian.com/admin/control/v2/orgs/{orgId}/policies' \
--header 'Authorization: Bearer <access_token>' \
--header 'Accept: application/json'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
32
33
34
35
36
37
38
39
40
41
{
"data": [
{
"id": "<string>",
"type": "policy",
"attributes": {
"id": "358d916a-aed3-474a-9ae0-17def3bad866",
"ownerId": "706c6425-3967-42b3-a070-53ffba3102b3",
"type": "data-security",
"name": "test policy",
"rule": {
"export": {
"effect": "block"
}
},
"status": "draft",
"metadata": {
"lastUpdatedBy": "ari:cloud:identity::user/8044ac9ff568615bdc7ea094",
"createdBy": "ari:cloud:identity::user/8044ac9ff568615bdc7ea094",
"hasHadCoverage": true,
"systemTag": "<string>",
"policyCoverageLevel": "UNASSIGNED",
"description": "Some description"
},
"createdAt": "2024-04-06T02:46:56.707Z",
"updatedAt": "2024-04-06T02:46:56.707Z",
"queryData": {}
}
}
],
"meta": {
"next": "<string>",
"page_size": 25
},
"links": {
"self": "<string>",
"prev": "<string>",
"next": "<string>",
"page_size": "<string>"
}
}Create a policy aligned with your organization's standards.
OAuth 2.0 scopes required: write:policies:admin
Forge and OAuth2 apps cannot access this REST resource.
string
Requiredobject
RequiredThe request has been accepted for processing, but processing has not yet completed.
1
2
3
4
5
6
7
8
curl --request POST \
--url 'https://api.atlassian.com/admin/control/v2/orgs/{orgId}/policies' \
--header 'Authorization: Bearer <access_token>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"data": {}
}'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
{
"data": {
"id": "<string>",
"type": "policy",
"attributes": {
"id": "358d916a-aed3-474a-9ae0-17def3bad866",
"ownerId": "706c6425-3967-42b3-a070-53ffba3102b3",
"type": "data-security",
"name": "test policy",
"rule": {
"export": {
"effect": "block"
}
},
"status": "draft",
"metadata": {
"lastUpdatedBy": "ari:cloud:identity::user/8044ac9ff568615bdc7ea094",
"createdBy": "ari:cloud:identity::user/8044ac9ff568615bdc7ea094",
"hasHadCoverage": true,
"systemTag": "<string>",
"policyCoverageLevel": "UNASSIGNED",
"description": "Some description"
},
"createdAt": "2024-04-06T02:46:56.707Z",
"updatedAt": "2024-04-06T02:46:56.707Z",
"queryData": {}
}
}
}Returns information about a policy by policyId.
OAuth 2.0 scopes required: read:policies:admin
Forge and OAuth2 apps cannot access this REST resource.
string
Requiredstring
RequiredThe request has succeeded.
1
2
3
4
curl --request GET \
--url 'https://api.atlassian.com/admin/control/v2/orgs/{orgId}/policies/{policyId}' \
--header 'Authorization: Bearer <access_token>' \
--header 'Accept: application/json'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
{
"data": {
"id": "<string>",
"type": "policy",
"attributes": {
"id": "358d916a-aed3-474a-9ae0-17def3bad866",
"ownerId": "706c6425-3967-42b3-a070-53ffba3102b3",
"type": "data-security",
"name": "test policy",
"rule": {
"export": {
"effect": "block"
}
},
"status": "draft",
"metadata": {
"lastUpdatedBy": "ari:cloud:identity::user/8044ac9ff568615bdc7ea094",
"createdBy": "ari:cloud:identity::user/8044ac9ff568615bdc7ea094",
"hasHadCoverage": true,
"systemTag": "<string>",
"policyCoverageLevel": "UNASSIGNED",
"description": "Some description"
},
"createdAt": "2024-04-06T02:46:56.707Z",
"updatedAt": "2024-04-06T02:46:56.707Z",
"queryData": {}
}
}
}Update a policy with a policyId.
OAuth 2.0 scopes required: write:policies:admin
Forge and OAuth2 apps cannot access this REST resource.
string
Requiredstring
RequiredoneOf [object, object, Models.DataSecurityPolicy]
RequiredThe request has been accepted for processing, but processing has not yet completed.
1
2
3
4
5
6
7
8
curl --request PUT \
--url 'https://api.atlassian.com/admin/control/v2/orgs/{orgId}/policies/{policyId}' \
--header 'Authorization: Bearer <access_token>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"data": {}
}'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
{
"data": {
"id": "<string>",
"type": "policy",
"attributes": {
"id": "358d916a-aed3-474a-9ae0-17def3bad866",
"ownerId": "706c6425-3967-42b3-a070-53ffba3102b3",
"type": "data-security",
"name": "test policy",
"rule": {
"export": {
"effect": "block"
}
},
"status": "draft",
"metadata": {
"lastUpdatedBy": "ari:cloud:identity::user/8044ac9ff568615bdc7ea094",
"createdBy": "ari:cloud:identity::user/8044ac9ff568615bdc7ea094",
"hasHadCoverage": true,
"systemTag": "<string>",
"policyCoverageLevel": "UNASSIGNED",
"description": "Some description"
},
"createdAt": "2024-04-06T02:46:56.707Z",
"updatedAt": "2024-04-06T02:46:56.707Z",
"queryData": {}
}
}
}Publishes policies by a bulk request for a specific ruleName. This is the only way to create or modify published policies.
OAuth 2.0 scopes required: write:policies:admin
Forge and OAuth2 apps cannot access this REST resource.
string
Requiredstring
Requiredstring
Requiredarray<Models.PolicyOperation>
RequiredThe request has been accepted for processing, but processing has not yet completed.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
curl --request POST \
--url 'https://api.atlassian.com/admin/control/v2/orgs/{orgId}/policies/publishDraftPolicies' \
--header 'Authorization: Bearer <access_token>' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"type": "data-security",
"ruleName": "appAccess",
"policyOperations": [
{
"policyId": "6d338cb1-501a-4017-bafd-d1ddcbb9f0aa",
"action": "UPDATE",
"policyCoverageLevel": "WORKSPACE"
}
]
}'1
2
3
4
5
6
7
8
9
10
11
12
{
"messages": [
{
"messageId": "b9045023-9f4a-4448-9f3f-04a987186de1",
"ticket": {
"id": "b9045023-9f4a-4448-9f3f-04a987186de1",
"containerAri": "ari:cloud:platform::org/185b5ad5-3c85-45f2-abe4-91e7b4ecd5c8",
"scope": "USER"
}
}
]
}Validate a policy to view potential issues in your policy
OAuth 2.0 scopes required: read:policies:admin
Forge and OAuth2 apps cannot access this REST resource.
string
Requiredstring
RequiredThe request has been accepted for processing, but processing has not yet completed.
1
2
3
curl --request GET \
--url 'https://api.atlassian.com/admin/control/v1/orgs/{orgId}/policies/{policyId}/validate' \
--header 'Authorization: Bearer <access_token>'Rate this page: