Confluence Cloud Developer

Confluence Cloud Developer

Rate this page:

Group

Get groups

GET /wiki/rest/api/group

Returns all user groups. The returned groups are ordered alphabetically in ascending order by group name.

Permissions required: Permission to access the Confluence site ('Can use' global permission).

App scope requiredREAD

OAuth scopes required
read:confluence-groups

Request

Query parameters
start

integer

The starting index of the returned groups.

Default: 0, Minimum: 0, Format: int32
limit

integer

The maximum number of groups to return per page. Note, this may be restricted by fixed system limits.

Default: 200, Minimum: 0, Format: int32

Example

1
2
3
curl --request GET \
  --url 'https://your-domain.atlassian.net/wiki/rest/api/group' \
  --header 'Accept: application/json'

Responses

Returned if the requested groups are returned.

Content typeValue
application/json

allOf [GroupArray, object]

Create new user group

POST /wiki/rest/api/group

Creates a new user group.

Permissions required: User must be a site admin.

Apps cannot access this REST resource.

OAuth scopes required
write:confluence-groups

Request

Body parameters
name Required

string

Example

1
2
3
4
5
6
7
curl --request POST \
  --url 'https://your-domain.atlassian.net/wiki/rest/api/group' \
  --header 'Accept: application/json' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "<string>"
}'

Responses

Returned if the group was created successfully.

Content typeValue
application/json

Group

Delete user group

DELETE /wiki/rest/api/group

Delete user group.

Permissions required: User must be a site admin.

Apps cannot access this REST resource.

OAuth scopes required
write:confluence-groups

Request

Query parameters
name Required

string

Name of the group to delete.

Example

1
2
curl --request DELETE \
  --url 'https://your-domain.atlassian.net/wiki/rest/api/group?name={name}'

Responses

Returned if the group was removed successfully.

Get group

GET /wiki/rest/api/group/by-name

Returns a user group for a given group name.

Permissions required: Permission to access the Confluence site ('Can use' global permission).

App scope requiredREAD

OAuth scopes required
read:confluence-groups

Request

Query parameters
name Required

string

The name of the group. This is the same as the group name shown in the Confluence administration console.

Example

1
2
3
curl --request GET \
  --url 'https://your-domain.atlassian.net/wiki/rest/api/group/by-name?name={name}' \
  --header 'Accept: application/json'

Responses

Returned if the requested group is returned.

Content typeValue
application/json

Group

Get group

GET /wiki/rest/api/group/by-id

Returns a user group for a given group id.

Permissions required: Permission to access the Confluence site ('Can use' global permission).

App scope requiredREAD

Request

Query parameters
id Required

string

The id of the group.

Example

1
2
3
curl --request GET \
  --url 'https://your-domain.atlassian.net/wiki/rest/api/group/by-id?id={id}' \
  --header 'Accept: application/json'

Responses

Returned if the requested group is returned.

Content typeValue
application/json

Group

Get group

Deprecated

GET /wiki/rest/api/group/{groupName}

Returns a user group for a given group name.

Use updated Get group API

Permissions required: Permission to access the Confluence site ('Can use' global permission).

App scope requiredREAD

Request

Path parameters
groupName Required

string

The name of the group. This is the same as the group name shown in the Confluence administration console.

Example

1
2
3
curl --request GET \
  --url 'https://your-domain.atlassian.net/wiki/rest/api/group/{groupName}' \
  --header 'Accept: application/json'

Responses

Returned if the requested group is returned.

Content typeValue
application/json

Group

Get group members

GET /wiki/rest/api/group/member

Returns the users that are members of a group.

Permissions required: Permission to access the Confluence site ('Can use' global permission).

App scope requiredREAD

OAuth scopes required
read:confluence-groups

Request

Query parameters
name Required

string

The name of the group to be queried for its members.

start

integer

The starting index of the returned users.

Default: 0, Minimum: 0, Format: int32
limit

integer

The maximum number of users to return per page. Note, this may be restricted by fixed system limits.

Default: 200, Minimum: 0, Format: int32

Example

1
2
3
curl --request GET \
  --url 'https://your-domain.atlassian.net/wiki/rest/api/group/member?name={name}' \
  --header 'Accept: application/json'

Responses

Returned if the requested users are returned.

Content typeValue
application/json

allOf [UserArray, object]

Get group members

Deprecated

GET /wiki/rest/api/group/{groupName}/member

Returns the users that are members of a group.

Use updated Get group API

Permissions required: Permission to access the Confluence site ('Can use' global permission).

App scope requiredREAD

Request

Path parameters
groupName Required

string

The name of the group to be queried for its members.

Query parameters
start

integer

The starting index of the returned users.

Default: 0, Minimum: 0, Format: int32
limit

integer

The maximum number of users to return per page. Note, this may be restricted by fixed system limits.

Default: 200, Minimum: 0, Format: int32

Example

1
2
3
curl --request GET \
  --url 'https://your-domain.atlassian.net/wiki/rest/api/group/{groupName}/member' \
  --header 'Accept: application/json'

Responses

Returned if the requested users are returned.

Content typeValue
application/json

allOf [UserArray, object]

Add member to group by groupId

POST /wiki/rest/api/group/userByGroupId

Adds a user as a member in a group represented by its groupId

Permissions required: User must be a site admin.

Apps cannot access this REST resource.

OAuth scopes required
write:confluence-groups

Request

Query parameters
groupId Required

string

GroupId of the group whose membership is updated

Body parameters
accountId Required

string

Example

1
2
3
4
5
6
curl --request POST \
  --url 'https://your-domain.atlassian.net/wiki/rest/api/group/userByGroupId?groupId={groupId}' \
  --header 'Content-Type: application/json' \
  --data '{
  "accountId": "<string>"
}'

Responses

Returned if the group was created successfully.

A schema has not been defined for this response code.

Get group members

GET /wiki/rest/api/group/{groupId}/membersByGroupId

Returns the users that are members of a group.

Use updated Get group API

Permissions required: Permission to access the Confluence site ('Can use' global permission).

App scope requiredREAD

Request

Path parameters
groupId Required

string

The id of the group to be queried for its members.

Query parameters
start

integer

The starting index of the returned users.

Default: 0, Minimum: 0, Format: int32
limit

integer

The maximum number of users to return per page. Note, this may be restricted by fixed system limits.

Default: 200, Minimum: 0, Format: int32

Example

1
2
3
curl --request GET \
  --url 'https://your-domain.atlassian.net/wiki/rest/api/group/{groupId}/membersByGroupId' \
  --header 'Accept: application/json'

Responses

Returned if the requested users are returned.

Content typeValue
application/json

allOf [UserArray, object]

Add member to group

POST /wiki/rest/api/group/user

Adds a user as a member in a group.

Permissions required: User must be a site admin.

Apps cannot access this REST resource.

OAuth scopes required
write:confluence-groups

Request

Query parameters
name Required

string

Name of the group whose membership is updated

Body parameters
accountId Required

string

Example

1
2
3
4
5
6
curl --request POST \
  --url 'https://your-domain.atlassian.net/wiki/rest/api/group/user?name={name}' \
  --header 'Content-Type: application/json' \
  --data '{
  "accountId": "<string>"
}'

Responses

Returned if the group was created successfully.

A schema has not been defined for this response code.

Remove member from group

DELETE /wiki/rest/api/group/user

Remove user as a member from a group.

Permissions required: User must be a site admin.

Apps cannot access this REST resource.

OAuth scopes required
write:confluence-groups

Request

Query parameters
name Required

string

Name of the group whose membership is updated.

accountId Required

string

AccountId of the user whose membership is removed.

Example

1
2
curl --request DELETE \
  --url 'https://your-domain.atlassian.net/wiki/rest/api/group/user?name={name}&accountId={accountId}'

Responses

Returned if the group was removed successfully.

Rate this page: