API referenceCollections
Undo a soft photo delete
Un-deletes a soft-deleted photo's faces so they are searchable again. (POST /v1/collections/{id}/photos/{photoId}/restore)
POST
/v1/collections/{id}/photos/{photoId}/restore- Auth
- Bearer API key
- Billing
- free (0 credits).
Un-deletes a soft-deleted photo's faces so they are searchable again. Only works while the vectors still exist — i.e. for a soft delete inside its grace window. An immediate delete physically removed the vectors and cannot be undone; re-index the photo instead. Free and idempotent.
Example request
curl -X POST "https://api.sightradar.com/v1/collections/$ID/photos/$PHOTOID/restore" \
-H "Authorization: Bearer $SR_API_KEY"Parameters
| Name | In | Type | Description |
|---|---|---|---|
id required | path | string | Collection id. |
photoId required | path | string | The photoId supplied at index time. |
Response body
| Field | Type | Description |
|---|---|---|
restored | boolean | |
collection_id | string | |
photo_id | string |
Status codes
| Status | Meaning |
|---|---|
200 | Faceprints restored. |
401 | Missing or invalid API key. |
403 | Account is read-only. |
404 | Resource not found. |
502 | Deletion service unavailable. |
Last updated
Undo a soft collection delete
Restores a collection that is still inside its grace window (status=deletion_pending) back to active, cancelling the… (POST /v1/collections/{id}/restore)
Get collection deletion status
Authoritative status for an asynchronous collection deletion. (GET /v1/collections/{id}/deletion)