Get asynchronous operation status

Retrieves the current status, progress, and results of one or more asynchronous operations. Many endpoints that perform complex operations (such as bulk updates, program template applications, or large deletions) return async operation IDs immediately and process the work in the background. Use this endpoint to poll for completion, monitor progress, and retrieve the final results or error messages.

Key Features:

  • Query multiple async operations simultaneously by providing multiple operation IDs
  • Monitor progress with percentage completion for long-running operations
  • Retrieve operation state including Not Started, Running, Succeeded, or Failed
  • Access result data once operations complete successfully including created resource IDs
  • Receive detailed error messages when operations fail for troubleshooting
  • Poll this endpoint repeatedly to track operation progress until completion

Authorization Logic:

  1. User must have a valid JWT token with viewing or management scopes
  2. User can only query async operations they initiated or have permission to view

Usage Example:

After applying a program template that returns async operation IDs, poll this endpoint every few seconds to check if the program and all its tasks have been created. When bulk deleting programs, monitor progress to ensure all deletions complete successfully. Track bulk update operations to verify all changes were applied.

Path Params
string
required
length between 7 and 22

The unique identifier of the space containing the target entity. This determines the scope of entity queries and ensures proper access control. The space must be accessible to the authenticated user with appropriate permissions. It can be the unique identifier (GUID) of the space or the word "default" to indicate the default programs space. Common values include "default" and "rkr83lapKkyCJuLLWqLqzB".

Query Params
asyncOperationIds
array of strings

Array of async operation IDs to query. These IDs are returned by endpoints that perform
asynchronous operations such as bulk updates, template applications, or large deletions. Provide one or more IDs
to check the status of multiple operations simultaneously.

asyncOperationIds
Responses

Language
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json