Get Data Backup Details
Purpose
To fetch information about the latest data backup scheduled for your CRM account.
Endpoints
- GET /backup
Request Details
Request URL
{api-domain}/crm/bulk/v8/backup
Header
Authorization: Zoho-oauthtoken d92d4xxxxxxxxxxxxx15f52
Scope
ZohoCRM.bulk.backup.ALL
(or)
ZohoCRM.bulk.backup.READ
Possible operation types
ALL - Full access to backup data
READ - Fetch information about a scheduled backup
Sample Request
Copiedcurl "https://www.zohoapis.com/crm/bulk/v8/backup"
-X GET
-H "Authorization: Zoho-oauthtoken 1000.8cb99dxxxxxxxxxxxxx9be93.9b8xxxxxxxxxxxxxxxf"
Response JSON
- idstring
The unique identifier for the backup request.
- scheduled_dateDateTime
The date and time at which the next backup is scheduled to occur, formatted in ISO 8601. This key is null if you do not specify the rrule while scheduling the backup.
- start_dateDateTime
The date and time when the backup process was initially set to start, formatted in ISO 8601. This reflects when the backup was first scheduled. This key is null if you do not specify the rrule while scheduling the backup.
- rrulestring
The recurrence rule that defines how often the backup is scheduled.
- requesterJSON object
Details of the user who initiated the backup. The details include the name, record ID, and the ZUID of the user.
- statusstring
Represents the status of the scheduled backup.
Possible values:
STOPPED - The backup is scheduled and will occur at the specified time.
SCHEDULED - The backup is currently being processed.
INPROGRESS - The backup has been successfully completed.
COMPLETED - The backup process has been halted.
FAILED - The backup process encountered an error and could not be completed.
Possible Errors
- INVALID_REQUEST_METHODHTTP 400
The request method is incorrect.
Resolution: Use the HTTP GET method to make this API call. Any other request method will result in this error. - OAUTH_SCOPE_MISMATCHHTTP 401
The access token you have used to make this API call does not have the required scope.
Resolution: Generate a new access token with the required scopes for this API. Refer to the Scope section at the beginning of this page for the list of required scopes. - NO_PERMISSIONHTTP 403
Permission denied to read
Resolution: The user does not have permission to read data backup data. Contact your system administrator. - INVALID_URL_PATTERNHTTP 404
The request URL is incorrect.
Resolution: Specify a valid request URL. Refer to the request URL section at the beginning of this page for more details. - INTERNAL_ERRORHTTP 500
Unexpected and unhandled exception in the server.
Resolution: Contact the support team at support@zohocrm.com.
Sample Response
Copied{
"backup": {
"id": "4876876000001593003",
"scheduled_date": "2022-07-26T09:58:45+05:30",
"start_date": "2022-07-12T12:30:00+05:30",
"rrule": "RRULE:FREQ=WEEKLY;INTERVAL=2;BYDAY=TU",
"requester": {
"id": "4876876000000327001",
"name": "Patricia Boyle",
"zuid": "7534658674"
},
"status": "SCHEDULED"
}
}