Create or update an entity
Creates a graph entity. When content is present, creates or re-indexes a content entity (former POST /index pipeline): fetch/enrich/embed and write catalog rows. Pass the same id with an updated content object to re-index; existing parent links are mean-pooled after re-index.
Without content, creates a non-content entity (name + type required). Optional linked_content (array of ContentObject) upserts each item as its own content entity, links child→parent (about), then mean-pools the parent once. Mutually exclusive with top-level content. Pass { id, linked_content } alone to attach/update children on an existing parent without rewriting name/type.
Linking a single existing child is also available via POST /entity/{parent_id}/link.
Authorization
ApiKeyAuth In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
curl -X POST "https://example.com/entity" \ -H "Content-Type: application/json" \ -d '{}'{
"id": "string",
"type": "content",
"name": "string",
"description": "string",
"created": true,
"turbopuffer_document_id": "string",
"linked_content": [
{
"entity_id": "string",
"created": true,
"url": "string",
"turbopuffer_document_id": "string"
}
],
"representation": "point",
"subspace_rank": 0
}{
"error": "string",
"code": "string"
}{
"error": "string",
"code": "string"
}