Get watches for page

GET /wiki/rest/api/content/{id}/notification/child-created

Returns the watches for a page. A user that watches a page will receive receive notifications when the page is updated.

If you want to manage watches for a page, use the following user methods:

• Get content watch status for user
• Add content watch
• Remove content watch

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

Connect app scope required: READ

Request

Example

1
2
3
4

curl --request GET \
  --url 'https://your-domain.atlassian.net/wiki/rest/api/content/{id}/notification/child-created' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Accept: application/json'

Responses

Get watches for space

GET /wiki/rest/api/content/{id}/notification/created

Returns all space watches for the space that the content is in. A user that watches a space will receive receive notifications when any content in the space is updated.

If you want to manage watches for a space, use the following user methods:

• Get space watch status for user
• Add space watch
• Remove space watch

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

Connect app scope required: READ

Request

Example

1
2
3
4

curl --request GET \
  --url 'https://your-domain.atlassian.net/wiki/rest/api/content/{id}/notification/created' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Accept: application/json'

Responses

Get space watchers

GET /wiki/rest/api/space/{spaceKey}/watch

Returns a list of watchers of a space

Connect app scope required: READ

Request

Example

1
2
3

curl --request GET \
  --url 'https://your-domain.atlassian.net/wiki/rest/api/space/{spaceKey}/watch' \
  --header 'Accept: application/json'

Responses

Get content watch status

GET /wiki/rest/api/user/watch/content/{contentId}

Returns whether a user is watching a piece of content. Choose the user by doing one of the following:

• Specify a user via a query parameter: Use the accountId to identify the user.
• Do not specify a user: The currently logged-in user will be used.

Permissions required: 'Confluence Administrator' global permission if specifying a user, otherwise permission to access the Confluence site ('Can use' global permission).

Connect app scope required: READ

Request

Example

1
2
3
4

curl --request GET \
  --url 'https://your-domain.atlassian.net/wiki/rest/api/user/watch/content/{contentId}' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Accept: application/json'

Responses

Add content watcher

POST /wiki/rest/api/user/watch/content/{contentId}

Adds a user as a watcher to a piece of content. Choose the user by doing one of the following:

• Specify a user via a query parameter: Use the accountId to identify the user.
• Do not specify a user: The currently logged-in user will be used.

Note, you must add the X-Atlassian-Token: no-check header when making a request, as this operation has XSRF protection.

Permissions required: 'Confluence Administrator' global permission if specifying a user, otherwise permission to access the Confluence site ('Can use' global permission).

Connect app scope required: WRITE

Request

Example

1
2
3

curl --request POST \
  --url 'https://your-domain.atlassian.net/wiki/rest/api/user/watch/content/{contentId}' \
  --header 'Authorization: Bearer <access_token>'

Responses

Remove content watcher

DELETE /wiki/rest/api/user/watch/content/{contentId}

Removes a user as a watcher from a piece of content. Choose the user by doing one of the following:

• Specify a user via a query parameter: Use the accountId to identify the user.
• Do not specify a user: The currently logged-in user will be used.

Permissions required: 'Confluence Administrator' global permission if specifying a user, otherwise permission to access the Confluence site ('Can use' global permission).

Connect app scope required: DELETE

Request

Example

1
2
3

curl --request DELETE \
  --url 'https://your-domain.atlassian.net/wiki/rest/api/user/watch/content/{contentId}' \
  --header 'Authorization: Bearer <access_token>'

Responses

Get label watch status

GET /wiki/rest/api/user/watch/label/{labelName}

Returns whether a user is watching a label. Choose the user by doing one of the following:

• Specify a user via a query parameter: Use the accountId to identify the user.
• Do not specify a user: The currently logged-in user will be used.

Permissions required: 'Confluence Administrator' global permission if specifying a user, otherwise permission to access the Confluence site ('Can use' global permission).

Connect app scope required: READ

Request

Example

1
2
3
4

curl --request GET \
  --url 'https://your-domain.atlassian.net/wiki/rest/api/user/watch/label/{labelName}' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Accept: application/json'

Responses

Add label watcher

POST /wiki/rest/api/user/watch/label/{labelName}

Adds a user as a watcher to a label. Choose the user by doing one of the following:

• Specify a user via a query parameter: Use the accountId to identify the user.
• Do not specify a user: The currently logged-in user will be used.

Note, you must add the X-Atlassian-Token: no-check header when making a request, as this operation has XSRF protection.

Permissions required: 'Confluence Administrator' global permission if specifying a user, otherwise permission to access the Confluence site ('Can use' global permission).

Connect app scope required: WRITE

Request

Example

1
2
3

curl --request POST \
  --url 'https://your-domain.atlassian.net/wiki/rest/api/user/watch/label/{labelName}' \
  --header 'Authorization: Bearer <access_token>'

Responses

Remove label watcher

DELETE /wiki/rest/api/user/watch/label/{labelName}

Removes a user as a watcher from a label. Choose the user by doing one of the following:

• Specify a user via a query parameter: Use the accountId to identify the user.
• Do not specify a user: The currently logged-in user will be used.

Permissions required: 'Confluence Administrator' global permission if specifying a user, otherwise permission to access the Confluence site ('Can use' global permission).

Connect app scope required: DELETE

Request

Example

1
2
3

curl --request DELETE \
  --url 'https://your-domain.atlassian.net/wiki/rest/api/user/watch/label/{labelName}' \
  --header 'Authorization: Bearer <access_token>'

Responses

Get space watch status

GET /wiki/rest/api/user/watch/space/{spaceKey}

Returns whether a user is watching a space. Choose the user by doing one of the following:

• Specify a user via a query parameter: Use the accountId to identify the user.
• Do not specify a user: The currently logged-in user will be used.

Permissions required: 'Confluence Administrator' global permission if specifying a user, otherwise permission to access the Confluence site ('Can use' global permission).

Connect app scope required: READ

Request

Example

1
2
3
4

curl --request GET \
  --url 'https://your-domain.atlassian.net/wiki/rest/api/user/watch/space/{spaceKey}' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Accept: application/json'

Responses

Add space watcher

POST /wiki/rest/api/user/watch/space/{spaceKey}

Adds a user as a watcher to a space. Choose the user by doing one of the following:

• Specify a user via a query parameter: Use the accountId to identify the user.
• Do not specify a user: The currently logged-in user will be used.

Note, you must add the X-Atlassian-Token: no-check header when making a request, as this operation has XSRF protection.

Permissions required: 'Confluence Administrator' global permission if specifying a user, otherwise permission to access the Confluence site ('Can use' global permission).

Connect app scope required: WRITE

Request

Example

1
2
3

curl --request POST \
  --url 'https://your-domain.atlassian.net/wiki/rest/api/user/watch/space/{spaceKey}' \
  --header 'Authorization: Bearer <access_token>'

Responses

Remove space watch

DELETE /wiki/rest/api/user/watch/space/{spaceKey}

Removes a user as a watcher from a space. Choose the user by doing one of the following:

• Specify a user via a query parameter: Use the accountId to identify the user.
• Do not specify a user: The currently logged-in user will be used.

Permissions required: 'Confluence Administrator' global permission if specifying a user, otherwise permission to access the Confluence site ('Can use' global permission).

Connect app scope required: DELETE

Request

Example

1
2
3

curl --request DELETE \
  --url 'https://your-domain.atlassian.net/wiki/rest/api/user/watch/space/{spaceKey}' \
  --header 'Authorization: Bearer <access_token>'

Responses