Delete an object

Deleting objects from collections

This endpoint allows you to permanently remove a specific object from a Tallyfy Answers collection using its unique identifier. Once deleted, an object cannot be recovered.

API endpoint

DELETE /v1/collections/{collection_name}/objects/{object_id}

Request parameters

Parameter	Type	Required	Description
collection_name	path	Yes	Name of the collection containing the object
object_id	path	Yes	Unique identifier of the object to delete

Response

A successful deletion returns a 200 OK status code with a confirmation response:

{
  "id": "product-123",
  "status": "deleted"
}

Error scenarios

Status	Description
404	Object or collection not found
400	Invalid object ID format
403	Permission denied (if applicable)

Example request

curl -X DELETE https://go.tallyfy.com/api/collections/products/objects/product-123 \
  -H "X-Answers-API-Key: your_api_key"

Important considerations

Permanent Action

Object deletion is permanent and cannot be undone. There is no “trash” or “recycle bin” for deleted objects.

• Verify that you have the correct object ID before deletion
• Consider archiving objects in your application logic instead of deleting them if you might need them later
• Deleting an object will remove it from search results immediately
• If you need to delete multiple objects, you may need to make separate API calls for each one
• Consider implementing confirmation workflows in your application before calling this endpoint

Alternative approaches

Instead of actually deleting objects, consider these alternatives:

• Add a “status” field to mark objects as inactive
• Move objects to an “archive” collection
• Implement soft deletion¹ by adding a “deleted_at” timestamp field

Related articles

Collections > Delete a collection

The DELETE endpoint permanently removes collections and all their objects from Tallyfy Answers with no recovery option and requires careful consideration of alternatives like data export or backup before execution.

Objects > Get an object

The Tallyfy Answers API endpoint retrieves complete individual object data from collections using unique identifiers through a GET request that returns full object properties including system-generated timestamps.

Objects > Index a single object

The Tallyfy Answers API endpoint enables adding single objects to collections in real-time through POST requests with JSON data ideal for individual record creation and testing while bulk operations should use the import endpoint for better performance.

Answers > Objects

Objects in Tallyfy Answers are fundamental JSON-formatted data records that belong to collections and can be indexed retrieved and searched using either custom or auto-generated unique identifiers while supporting flexible schema-less structure and various management operations.

Footnotes

1. Records marked as deleted but retained in database, unlike hard deletion which permanently removes data ↩