Collections - Aigmented

Collections are containers for your knowledge. Upload documents to a collection, and Aigmented extracts structured knowledge cards that you can search and query.

List collections

curl https://aigmented.io/api/v1/collections/list \
  -H "Authorization: Bearer sk-YOUR_API_KEY"

Returns all collections for your team:

{
  "message": "List of collections",
  "data": [
    {
      "id": 49,
      "name": "Product Documentation",
      "status": "processed",
      "_count": {
        "knowledgeCards": 1248,
        "fileInstances": 4
      }
    }
  ]
}

Get collection details

curl https://aigmented.io/api/v1/collections/49 \
  -H "Authorization: Bearer sk-YOUR_API_KEY"

Create a collection

curl -X POST https://aigmented.io/api/v1/collections/add \
  -H "Authorization: Bearer sk-YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Q4 2024 Contracts" }'

Delete a collection

curl -X DELETE https://aigmented.io/api/v1/collections/49 \
  -H "Authorization: Bearer sk-YOUR_API_KEY"

Deleting a collection removes all associated knowledge cards. This action cannot be undone.

Collection statuses

Status	Meaning
`new`	Collection created, no files processed yet
`processing`	Files are being parsed and knowledge extracted
`processed`	All files processed successfully
`processed_with_conflicts`	Processed but some knowledge cards have conflicts
`error`	Processing failed

List knowledge cards

curl "https://aigmented.io/api/v1/collections/49/knowledge-cards?page=1&limit=20" \
  -H "Authorization: Bearer sk-YOUR_API_KEY"

Supports pagination (page, limit), filtering by type (type), and full-text search (search).