Returns the current status of the request for endpoints run asynchronously:
- POST /v2/crm/entities
- DELETE /v2/crm/integrations
When accessed using a bearer token, this endpoint requires the 'api:crm:upload' scope.
Status Codes
- PENDING: file is pending being processed
- IN_PROGRESS: file is being processed
- DONE: all objects in the file were successfully processed
- FAILED: failed to parse some objects, or a general error occurred when the file was being processed
Correcting a file that failed to be processed:
When the status in the response is FAILED do one of the following:
- If the response includes a list of errors, correct the errors in the file as follows:
- Using the
errors.lineattribute, locate and correct the data in the JSON file. - You can resend the entire LDJSON file, or only the corrected records via the relevant API.
Note: The response returns a maximum of 20 errors. To make sure you have corrected all errors, upload the entire file repeatedly until you receive a DONE status.
- Using the
- A single error in the form of:
{"line":0,"description":"....."} indicates a general processing error:- Fix the LDJSON file according to the error message.
- Upload the entire LDJSON file again.
Integration ID generated when creating the integration
The client request ID used in the asynchronous endpoint you want to get a status for
Operation successful
A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.
Request status
Line number of failed object
Error description
Number of objects that failed parsing
Number of valid objects
Malformed request
A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.
Error messages.
Access denied
A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.
Error messages.
API request limit exceeded
A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.
Error messages.
Failed to complete the operation due to an unexpected error
A Gong request reference Id, generated for this request. Can be used for troubleshooting purposes.
Error messages.