Get file revisions

A request to get a file revisions meta.

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

Path parameters

Parameter	Description
`fileId`	Id of a file to fetch revisions

Response structure

Path	Type	Description
`[]`	Array	Array of file’s revisions.
`[].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 the file’s owner
`[].revision.ownerEmail`	String	Email of the file’s owner
`[].revision.ownerFirstName`	String	First name of the file’s owner
`[].revision.ownerLastName`	String	Last name of the file’s owner
`[].revision.ownerMiddleName`	String	Middle name of the 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/189407886/revisions' -i \
-X GET \
-H 'X-co-auth-token: a38df30283b5386308cb9305fc944661'

Example response

HTTP/1.1 200 OK
X-co-request-id: 54344a4e49675244365136536378306f
Content-Type: application/vnd.ncloudtech.cloudoffice.revisionlist+json;v=1;charset=UTF-8
Content-Length: 1077
[
  {
    "revision": {
      "id": "189407887",
      "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": false,
      "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": "",
      "createdDate": "2022-04-06T16:01:55.000Z",
      "modifiedDate": "2022-04-06T16:01:55.000Z",
      "checksum": "e0e102b9ff40785fac8902d8bcbf2279",
      "pinned": true,
      "creatorIsDeleted": false,
      "ownerIsDeleted": false
    },
    "links": [
      {
        "rel": "self",
        "href": "http://localhost:8080/api/v1/files/189407887"
      }
    ]
  },
  {
    "revision": {
      "id": "189408194",
      "fileSize": "20",
      "creatorId": "5177189d266a4862ad93b1cda2f5ac2b",
      "creatorFirstName": "a",
      "creatorLastName": "s",
      "creatorMiddleName": "f",
      "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": "testfile.txt",
      "createdDate": "2022-04-06T16:01:56.000Z",
      "modifiedDate": "2022-04-06T16:01:56.000Z",
      "checksum": "e0e102b9ff40785fac8902d8bcbf2279",
      "pinned": true,
      "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/189408194"
      }
    ]
  }
]