Restore a snapshot

POST

https://api.x.flatfile.com/v1/snapshots/:snapshotId/restore

POST

/v1/snapshots/:snapshotId/restore

1 from flatfile import Flatfile
2 from flatfile.snapshots import RestoreOptions
3 
4 client = Flatfile(
5     token="YOUR_TOKEN",
6 )
7 client.snapshots.restore_snapshot(
8     snapshot_id="us_ss_YOUR_ID",
9     request=RestoreOptions(
10         created=True,
11         updated=True,
12         deleted=True,
13     ),
14 )

Try it

1 {
2   "data": {
3     "id": "us_ss_YOUR_ID",
4     "sheetId": "us_sh_YOUR_ID",
5     "createdAt": "2023-01-01T00:00:00Z",
6     "createdBy": "us_usr_YOUR_ID",
7     "label": "My snapshot",
8     "summary": {
9       "createdSince": {
10         "total": 0
11       },
12       "updatedSince": {
13         "total": 5,
14         "byField": {
15           "lastName": 5
16         }
17       },
18       "deletedSince": {
19         "total": 5,
20         "byField": {
21           "firstName": 1
22         }
23       },
24       "schemaDiff": {
25         "firstName": "added",
26         "lastName": "removed",
27         "email": "unchanged"
28       },
29       "config": {
30         "name": "Contacts",
31         "fields": [
32           {
33             "type": "string",
34             "key": "firstName",
35             "label": "First Name"
36           },
37           {
38             "type": "string",
39             "key": "lastName",
40             "label": "Last Name"
41           },
42           {
43             "type": "string",
44             "key": "email",
45             "label": "Email"
46           }
47         ],
48         "slug": "contacts",
49         "mappingConfidenceThreshold": 0.5
50       }
51     }
52   }
53 }

Restores a snapshot of a sheet

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

snapshotIdstringRequired

ID of snapshot

Request

This endpoint expects an optional object.

createdbooleanRequired

updatedbooleanRequired

deletedbooleanRequired

Response

This endpoint returns an object.

dataobject

Restore a snapshot

Authentication

Path parameters

Headers

Request

Response

Errors