Versions Compared

Old Version 7

changes.mady.by.user Sergio Vieira

Saved on

compared with

New Version 8

changes.mady.by.user Sergio Vieira

Saved on

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


There are three endpoints regarding backups of Xray information.


Generate a Backup

/api/v1/backup

Check backup job status

/api/v1/backup/{jobId}/status

Get backup file/api/v1/backup/file
Get attachment backup file/api/v1/backup/file/attachment


The first endpoint is an asynchronous call to generate a backup. Whenever this endpoint is called, a job is queued to create the backup and its id is returned. The second endpoint can be used to check the status of this job.

...

Expand
titlePOST /api/v1/backup
Panel

Create a job to generate a backup.

Request


In the body of the request the following fields can be used:

  • projectIds (optional): This field determines which projects to backup. This field is optional, if omitted, the backup will contain Xray information of all projects containing it.
  • modifiedSince (optional): This field can hold a date in order for a partial backup to be generated containing only entities that were change from that date until now. This field is optional, if not supplied a full backup will be generated.
  • withAttachment (optional): It determines if the a zip file with the attachments should also be generated.
Example 1:


Example Input

{
  "projectIds": ["10000", "10001"],
  "modifiedSince": "2020-04-25T00:00:00Z",
  "withAttachment": false
}

Tip
titleExample Request

curl -H "Content-Type: application/json" -X POST -H "Authorization: Bearer $token"  --data @"data.json" https://xray.cloud.xpand-it.com/api/v1/backup

Responses

200 OK : application/json : Successful. The backup job was created successfully and the Job Id is provided.
Example Output

{
    "jobId":"34a4106b1d0948d1aae1170cc8df3bb4"
}


400 BAD_REQUEST : application/json : No backup job was created. Another backup job is still running or was completed not long ago.
Example Output

{
    "error":"A backup can be created once every 6 hours, you can create a new one in: 5 hours, 56 minutes and 47 seconds."
}



401 UNAUTHORIZED: application/json: The API token is invalid.

...