Retrieve an async request
Retrieve the status and details of an asynchronous request.
YunoJuno processes certain operations asynchronously when they involve large amounts of data that would exceed typical API request timeouts. Operations such as bulk timesheet creation, bulk project updates via file upload, and client data list updates are handled this way. When you submit one of these operations, the API immediately returns an async request identifier rather than waiting for the operation to complete.
This endpoint allows you to check the progress of these background operations. The response includes the current processing state, timing information, and any error details if the operation failed. The `state` field indicates whether the request is still being processed (`SUBMITTED`), has completed successfully (`PROCESSED`), or encountered an error (`FAILED`). The `source` field identifies what type of operation created the async request, such as `CREATE_TIMESHEETS_BULK` or `UPSERT_PROJECTS_BULK_VIA_FILE`.
Processing times vary based on the operation size and complexity. Small operations with fewer than 100 records typically complete within 30 seconds, while operations involving thousands of records may take several minutes. The `created_at` timestamp shows when the request was submitted, and `processed_at` indicates when processing completed (this field remains null while the request is still being processed).
Authentication
AuthorizationBearer
Bearer authentication of the form Bearer <token>, where token is your auth token.
Path parameters
async_request_id
The unique identifier of the asynchronous request. This identifier is provided in the response when submitting bulk operations such as timesheet creation or project updates. All async request IDs follow the format ‘areq_’ followed by a unique string.
Response
data
The asynchronous request object.
This object represents a request that has been submitted
for further background processing.
