Recycle bin API endpoints

Relative URI	Method	Success code	Description
`/recycleBinTTL`	`GET`	`200`	Get all deleted resources from the recycle bin for the last 30 days
`/recycleBinTTL/<_resource>`	`GET`	`200`	Get all deleted resources of a specific type (import, export, connection, etc.) from the recycle bin for the last 30 days.
`/recycleBinTTL/<resource>/<_id>`	`GET`	`200`	Get deleted data for a specific resource (connection, import, export, etc.) based on the Id from the recycle bin for the last 30 days.
	`POST`	`204`	Restore a resource from the recycle bin.
	`DELETE`	`204`	Permanently delete a resource from the recycle bin.

Recycle bin API examples

Get all resources from the recycle bin

GET/v1/recycleBinTTL
Host: api.integrator.io
Authorization: Bearer my_api_token

Sample response

[
{
"model": "Import",
"doc": {
"_id": "64f•••••••••••••••016",
"createdAt": "2023-09-06T05:09:26.965Z",
"lastModified": "2023-09-06T05:09:32.854Z",
"name": "delete_import",
"_connectionId": "64b•••••••••••••••a6b",
…………….
}
},
{
"model": "Connection",
"doc": {
"_id": "64e••••••••••••••••9d78",
"createdAt": "2023-08-28T11:42:57.339Z",
"lastModified": "2023-09-04T11:11:06.148Z",
"type": "http",
"name": "HTTP Ratelimit",
…………….

}
},
{
"model": "Connection",
"doc": {
"_id": "64e•••••••••••••••••5e2",
"createdAt": "2023-08-23T11:02:31.941Z",
"lastModified": "2023-09-04T11:11:04.594Z",
"type": "http",
"name": "HTTP RateLimit",
…………….
}
},
{
"model": "Flow",
"doc": {
"_id": "64d2•••••••••••••••23ca",
"lastModified": "2023-08-08T09:44:02.690Z",
"name": "New flow",
…………….
}
}
]

Get all imports from the recycle bin

GET/v1/recycleBinTTL/imports
Host: api.integrator.io
Authorization: Bearer my_api_token

Sample response

[
{
"_id": "6b4••••••••••••••••016",
"createdAt": "2023-09-06T05:09:26.965Z",
"lastModified": "2023-09-06T05:09:32.854Z",
"name": "delete_import",
"_connectionId": "64b•••••••••••••••••a6b",
…………..
}
]

Get a connection from the recycle bin

GET/v1/recycleBinTTL/connections/64f••••••••••••••016
Host: api.integrator.io
Authorization: Bearer my_api_token

Sample response

{
"_id": "64f••••••••••••••016",
"createdAt": "2023-09-06T05:09:26.965Z",
"lastModified": "2023-09-06T05:09:32.854Z",
"name": "delete_import",
"_connectionId": "64b•••••••••••••••••a6b",
………….
}

Comments

1 comment

Tyler Lamparter Principal Product Manager

November 23, 2023 14:42
To restore resources from the recycling bin, you can use the following:
```
POST /recycleBinTTL/<resource>/<id>
```
To permanently delete from the recycling bin, you can use the following:
```
DELETE /recycleBinTTL/<resource>/<id>
```
0