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:
- User must have a valid JWT token with viewing or management scopes
- 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.