Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

The requests can include filters , for example:

...

to retrieve workflow actions that match any or all of the filters. These are some of the filters available:

  • actors to filter by one or more users (by userid) who undertook an action in a document

  • participants to filter by one or more users (by userid) who were assigned to an action

  • statenames of the workflow states in which the actions took place

  • fromdate indicates that the actions must have taken place after it

  • todate indicates that the actions must have taken place before it

  • types to filter by specific types (e.g. "state", "approval") or subtypes (e.g. "expired", “approvalAssigned“) of actions

Pagination

A query can be separated into multiple requests providing a limit and an offset in order to retrieve all the results in different "pages"

Info

Each request is limited by default to 100 items.

Permissions

Depending on which of the 2 endpoints is used, the following user permissions are required:

  • documentactivity/pages: Workflow Visibility over all the provided pages

  • documentactivity/spaces: Confluence Space Administrator permission over all the provided spaces

If the request contains a space/page over which the user making the request does not have enough permissions then the response will be a bad request with details about the spaces/pages over which the user does not have enough permissions.

...