Restore revision

note

[Since 2017.02]

A request to restore file’s revision. Specified revision will be copied to a new revision. It’s impossible to restore a revision of a file opened for collaboration.

POST /api/v1/files/{fileId}/revisions/{revId}/restore

Path parameters

Parameter	Description
`fileId`	Id of a file
`revId`	Id of a revision

Response structure

Path	Type	Description
`revision`	Object	Revision object
`links[]`	Array	Common hypermedia links
`revision.checksum`	String	An MD5 checksum for the content of the revision
`revision.createdDate`	String	Creation date of the revision
`revision.fileSize`	String	Size of the revision in bytes
`revision.id`	String	Id of the revision
`revision.isLastRevision`	Boolean	Current revision flag
`revision.mediaType`	String	Media type of the revision
`revision.modifiedDate`	String	Modification date of the revision
`revision.title`	String	Title for the revision
`revision.ownerId`	String	The file owner id
`revision.ownerLogin`	String	Login of file’s owner
`revision.ownerEmail`	String	Email of file’s owner
`revision.ownerFirstName`	String	First name of file’s owner
`revision.ownerLastName`	String	Last name of file’s owner
`revision.ownerMiddleName`	String	Middle name of file’s owner
`revision.creatorId`	String	Revision creator id
`revision.creatorLogin`	String	Login of revision’s creator
`revision.creatorEmail`	String	Email of revision’s creator
`revision.creatorFirstName`	String	First name of revision’s creator
`revision.creatorMiddleName`	String	Middle name of revision’s creator
`revision.creatorLastName`	String	Last name of revision’s creator
`revision.pinned`	Boolean	Mark to not auto delete revision
`revision.creatorIsDeleted`	Boolean	Mark creator is deleted
`revision.ownerIsDeleted`	Boolean	Mark owner is deleted
`revision.ownerAvatar`	String	Owner avatar
`revision.creatorAvatar`	String	Creator avatar
`links[].rel`	String	Link type
`links[].href`	String	Link reference

Example request

curl 'http://localhost:8080/api/v1/files/189402868/revisions/189403176/restore?title=SampleTitle' -i -X POST \
-H 'X-co-auth-token: 1458fab4ac8b58fdf542e89aa8433c28' \
-H 'Content-Type: application/x-www-form-urlencoded'

Example response

HTTP/1.1 200 OK
X-co-request-id: 49787357424349315548723656563678
Content-Type: application/json
Content-Length: 1208
{
  "revision": {
    "id": "189403499",
    "fileSize": "20",
    "creatorId": "5177189d266a4862ad93b1cda2f5ac2b",
    "creatorFirstName": "a",
    "creatorLastName": "s",
    "creatorMiddleName": "d",
    "creatorLogin": "testsrvdocs@srv-one.tacos.devoffice.ru",
    "creatorEmail": "testsrvdocs@srv-one.tacos.devoffice.ru",
    "isLastRevision": true,
    "mediaType": "text/plain",
    "ownerId": "5177189d266a4862ad93b1cda2f5ac2b",
    "ownerFirstName": "a",
    "ownerLastName": "s",
    "ownerMiddleName": "d",
    "ownerLogin": "testsrvdocs@srv-one.tacos.devoffice.ru",
    "ownerEmail": "testsrvdocs@srv-one.tacos.devoffice.ru",
    "title": "SampleTitle",
    "createdDate": "2022-04-06T16:01:14.000Z",
    "modifiedDate": "2022-04-06T16:01:14.000Z",
    "checksum": "e0e102b9ff40785fac8902d8bcbf2279",
    "pinned": false,
    "creatorIsDeleted": false,
    "ownerIsDeleted": false,
    "ownerAvatar": "a00bbb30-993e-4632-925f-152939195049",
    "creatorAvatar": "a00bbb30-993e-4632-925f-152939195049"
  },
  "links": [
    {
      "rel": "self",
      "href": "http://localhost:8080/api/v1/files/189403499"
    }
  ]
}