curl --request POST \
--url https://api.mixpeek.com/v1/collections/{collection_identifier}/documents \
--header 'Content-Type: application/json' \
--data '{
"collection_id": "collection_123",
"source_details": [
{
"type": "bucket",
"source_id": "<string>",
"object_id": "<string>",
"feature_extractor_task_id": "<string>",
"object_task_id": "<string>",
"source_blobs": [
{
"blob_id": "<string>",
"property": "<string>",
"key_prefix": "<string>",
"type": "string",
"data": "<string>",
"metadata": {},
"details": {
"filename": "<string>",
"size_bytes": 123,
"mime_type": "<string>",
"hash": "<string>",
"s3_object_key": "<string>"
}
}
],
"feature_extractor_id": "<string>",
"batch_id": "<string>",
"batch_task_id": "<string>"
}
],
"metadata": {},
"features": [
{
"feature_extractor_id": "<string>",
"payload": {},
"vectors": {}
}
]
}'
{
"document_id": "<string>",
"collection_id": "<string>",
"source_details": [
{
"type": "bucket",
"source_id": "<string>",
"object_id": "<string>",
"feature_extractor_task_id": "<string>",
"object_task_id": "<string>",
"source_blobs": [
{
"blob_id": "<string>",
"property": "<string>",
"key_prefix": "<string>",
"type": "string",
"data": "<string>",
"metadata": {},
"details": {
"filename": "<string>",
"size_bytes": 123,
"mime_type": "<string>",
"hash": "<string>",
"s3_object_key": "<string>"
}
}
],
"feature_extractor_id": "<string>",
"batch_id": "<string>",
"batch_task_id": "<string>"
}
],
"enrichments": {
"clusters": [
{
"cluster_id": "cluster_001",
"coordinates": [
0.12,
0.23,
0.34,
0.45,
0.56
],
"distance_to_centroid": 0.15,
"document_id": "doc_123",
"features": {
"category": "electronics",
"product_name": "Widget A"
},
"source_details": {
"source_id": "col_products_v1",
"type": "collection"
}
}
],
"taxonomies": [
{
"label": "Mobile Phones",
"node_id": "node_electronics_phones",
"path": [
"products",
"electronics",
"phones"
],
"score": 0.87,
"taxonomy_id": "tax_products"
}
]
},
"source_blobs": [
{}
],
"internal_metadata": {},
"metadata": {},
"vector": [
123
],
"presigned_url": "<string>"
}
Create a document by ID.
curl --request POST \
--url https://api.mixpeek.com/v1/collections/{collection_identifier}/documents \
--header 'Content-Type: application/json' \
--data '{
"collection_id": "collection_123",
"source_details": [
{
"type": "bucket",
"source_id": "<string>",
"object_id": "<string>",
"feature_extractor_task_id": "<string>",
"object_task_id": "<string>",
"source_blobs": [
{
"blob_id": "<string>",
"property": "<string>",
"key_prefix": "<string>",
"type": "string",
"data": "<string>",
"metadata": {},
"details": {
"filename": "<string>",
"size_bytes": 123,
"mime_type": "<string>",
"hash": "<string>",
"s3_object_key": "<string>"
}
}
],
"feature_extractor_id": "<string>",
"batch_id": "<string>",
"batch_task_id": "<string>"
}
],
"metadata": {},
"features": [
{
"feature_extractor_id": "<string>",
"payload": {},
"vectors": {}
}
]
}'
{
"document_id": "<string>",
"collection_id": "<string>",
"source_details": [
{
"type": "bucket",
"source_id": "<string>",
"object_id": "<string>",
"feature_extractor_task_id": "<string>",
"object_task_id": "<string>",
"source_blobs": [
{
"blob_id": "<string>",
"property": "<string>",
"key_prefix": "<string>",
"type": "string",
"data": "<string>",
"metadata": {},
"details": {
"filename": "<string>",
"size_bytes": 123,
"mime_type": "<string>",
"hash": "<string>",
"s3_object_key": "<string>"
}
}
],
"feature_extractor_id": "<string>",
"batch_id": "<string>",
"batch_task_id": "<string>"
}
],
"enrichments": {
"clusters": [
{
"cluster_id": "cluster_001",
"coordinates": [
0.12,
0.23,
0.34,
0.45,
0.56
],
"distance_to_centroid": 0.15,
"document_id": "doc_123",
"features": {
"category": "electronics",
"product_name": "Widget A"
},
"source_details": {
"source_id": "col_products_v1",
"type": "collection"
}
}
],
"taxonomies": [
{
"label": "Mobile Phones",
"node_id": "node_electronics_phones",
"path": [
"products",
"electronics",
"phones"
],
"score": 0.87,
"taxonomy_id": "tax_products"
}
]
},
"source_blobs": [
{}
],
"internal_metadata": {},
"metadata": {},
"vector": [
123
],
"presigned_url": "<string>"
}
Bearer token authentication using your API key. Format: 'Bearer your_api_key'. To get an API key, create an account at mixpeek.com/start and generate a key in your account settings. Example: 'Bearer sk_1234567890abcdef'
Optional namespace for data isolation. This can be a namespace name or namespace ID. Example: 'netflix_prod' or 'ns_1234567890'. To create a namespace, use the /namespaces endpoint.
The ID of the collection.
Request model for creating a document.
Successful Response
Response model for a single document.
Was this page helpful?