Delete a collection

Deleting collections

Section titled “Deleting collections”

This endpoint lets you permanently remove a collection and all its objects from Tallyfy Answers¹. 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

Section titled “API endpoint”

DELETE /v1/collections/{collection_name}

Path parameters

Section titled “Path parameters”

Parameter	Type	Required	Description
collection_name	string	Yes	Name of the collection to delete

Response

Section titled “Response”

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

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

Error scenarios

Section titled “Error scenarios”

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

Example request

Section titled “Example request”

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

When to delete a collection

Section titled “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

Section titled “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

Section titled “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

Related articles

Section titled “Related articles”

Objects > Delete an object

Use the DELETE endpoint to permanently remove objects from Tallyfy Answers collections by unique…

Collections > Get a collection

Retrieve information about a specific collection in Tallyfy Answers using its unique name. The…

Collections > Update a collection

Use the PATCH endpoint to modify existing collection properties like descriptions in Tallyfy…

Collections > Create a collection

Create collections in Tallyfy Answers using a POST request to the /v1/collections endpoint. Each…

Footnotes

Section titled “Footnotes”

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

Was this helpful?

YesNo