Skip to content
Tallyfy

Delete a collection

Deleting collections

This endpoint lets you permanently remove a collection and all its objects from Tallyfy Answers1. This operation is irreversible and should be used with caution.

Permanent action

Deleting a collection permanently removes all objects within it. This can’t be undone, and there’s no way to recover the data once deleted.

API endpoint

DELETE /v1/collections/{collection_name}

Path parameters

ParameterTypeRequiredDescription
collection_namestringYesName of the collection to delete

Response

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

{
  "name": "products",
  "status": "deleted"
}

Error scenarios

StatusDescription
404Collection not found
400Invalid collection name format
403Permission denied (if applicable)

Example request

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

When to delete a collection

Consider deleting a collection when:

  • The data is no longer needed for any purpose
  • You need to rebuild a collection with a different structure
  • You want to remove test or development data
  • You’re performing cleanup of unused resources

Alternatives to deletion

Instead of permanently deleting a collection, you might consider these alternatives:

  • Export the data before deletion for backup purposes
  • Create a new collection with only the objects you want to keep
  • Use application-level filtering[^2] to hide certain objects from users

Best practices

  • Always confirm collection names before deletion
  • Consider implementing a confirmation step in your application
  • Back up important data before deletion
  • Use descriptive logging to track deletion operations
  • Verify permissions carefully to prevent unauthorized deletions

Footnotes

  1. Tallyfy’s semantic search and knowledge management system using vector embeddings ↩

Get in touch
About Tallyfy