Creates an external linked team, and membership will be synced with the external reference.
Forge and OAuth2 apps cannot access this REST resource.
string
RequiredDetails of the team to be created.
string
RequiredPublicApiExternalReference
Requiredstring
Team created successfully. The details of the team are in the response, including the team ID, which can be used to reference the team for other operations.
1
2
3
4
5
6
7
8
9
10
11
12
curl --request POST \
--url 'https://api.atlassian.com/public/teams/v1/org/{orgId}/teams/external' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"description": "<string>",
"externalReference": {
"id": "<string>",
"source": "ATLASSIAN_GROUP"
},
"siteId": "<string>"
}'1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
{
"creatorId": "<string>",
"description": "<string>",
"displayName": "<string>",
"externalReference": {
"id": "<string>",
"source": "ATLASSIAN_GROUP"
},
"organizationId": "<string>",
"state": "ACTIVE",
"teamId": "<string>",
"teamType": "OPEN",
"userPermissions": {
"ADD_MEMBERS": true,
"DELETE_TEAM": true,
"REMOVE_MEMBERS": true,
"UPDATE_TEAM": true
}
}Unlinks managed teams from their external references in bulk. Each team's membership setting will be transitioned from EXTERNAL to ORG_ADMIN_MANAGED.
Forge and OAuth2 apps cannot access this REST resource.
string
RequiredThe list of team IDs to unlink from their external references. All IDs must belong to the organisation specified in the path.
array<string>
RequiredBulk unlink processed. Completed team IDs appear in 'successfulTeamIds'; any failures are listed in 'errors'.
1
2
3
4
5
6
7
8
9
curl --request POST \
--url 'https://api.atlassian.com/public/teams/v1/org/{orgId}/teams/external/bulk/unlink' \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{
"teamIds": [
"<string>"
]
}'1
2
3
4
5
6
7
8
9
10
11
12
{
"errors": [
{
"code": "<string>",
"message": "<string>",
"teamId": "<string>"
}
],
"successfulTeamIds": [
"<string>"
]
}Links an existing team to an external reference, and membership and team name will be synced with the external reference.
Forge and OAuth2 apps cannot access this REST resource.
string
Requiredstring
RequiredPublicApiExternalReference
Requiredstring
Team linked to external reference successfully.
1
2
3
4
5
6
7
8
9
10
curl --request POST \
--url 'https://api.atlassian.com/public/teams/v1/org/{orgId}/teams/{teamId}/external/link' \
--header 'Content-Type: application/json' \
--data '{
"externalReference": {
"id": "<string>",
"source": "ATLASSIAN_GROUP"
},
"siteId": "<string>"
}'Rate this page: