Collections Management

Collections are a way to organize your video data. You can create, update, delete, and list collections. Each collection can contain multiple videos, and you can manage the videos within each collection.

Collection Endpoints

The Aana API provides several endpoints for managing collections:

• POST /collections: Create a new collection.
• GET /collections: List all collections.
• GET /collections/{collection_id}: Retrieve a specific collection by its collection ID.
• PUT /collections/{collection_id}: Update a name or description of a specific collection.
• DELETE /collections/{collection_id}: Delete a specific collection by its collection ID.

Collection Items Endpoints

Apart from managing the collections themselves, you can also manage the videos within each collection:

• GET /collections/{collection_id}/items: List the all items (videos) in a specific collection.
• DELETE /collections/{collection_id}/items/{media_id}: Remove a specific video from a collection by its media ID.

Collection Analysis Endpoints

The Aana API provides an endpoint to get content exploration prompts (suggestions) based on your collection content. This can help you surface information you might want to look for.

• POST /collection_suggestions: Get content exploration prompts based on your collection content. For example, if you have a collection of sports videos, the API might suggest prompts like "Ice Hockey Matches", "Winter Universiade in Harbin", "Fierce Rivalries in Sports", "Fan Support in Sports", "Resilience in Sports Matches".