Create entity

Create a new entity in any vertical. Auto-generates `description_llm` for embedding and `search_text` for full-text search. If a JSON Schema is registered for the vertical, `vertical_data` is validated against it.

Header Parameters

x-tenant-id?|

authorization?|

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

vertical*string

Vertical identifier (e.g., 'manufacturing', 'healthcare').

Length1 <= length <= 50

entity_type*string

Entity type within the vertical (e.g., 'product', 'supplier').

Length1 <= length <= 100

name*string

Display name for the entity.

Length1 <= length

description?|

Human-readable description.

source_url?|

URL of the original data source.

source_type?|

Source type: api, file_upload, webhook, manual.

source_name?|

Source identifier for traceability.

source_id?|

External identifier for upsert (e.g., supplier's product ID). Must be unique per tenant+vertical.

status?string

Entity status: active, archived, draft, suspended.

Default"active"

Match^(active|archived|draft|suspended)$

vertical_data?

Domain-specific data (max 100KB, max depth 10). Validated against registered JSON Schema if available.

raw_data?|

Original unprocessed data from the source.

Response Body

`application/json`

curl -X POST "https://loading/api/v1/entities" \  -H "Content-Type: application/json" \  -d '{    "vertical": "manufacturing",    "entity_type": "product",    "name": "Deep Groove Ball Bearing 6205"  }'

{
  "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
  "tenant_id": "34f5c98e-f430-457b-a812-92637d0c6fd0",
  "vertical": "string",
  "entity_type": "string",
  "name": "string",
  "description": "string",
  "description_llm": "string",
  "source_url": "string",
  "source_type": "string",
  "source_name": "string",
  "source_id": "string",
  "status": "string",
  "vertical_data": {},
  "embedding_status": "string",
  "claim_status": "string",
  "data_quality_score": 0,
  "created_at": "2019-08-24T14:15:22Z",
  "updated_at": "2019-08-24T14:15:22Z"
}

{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string",
      "input": null,
      "ctx": {}
    }
  ]
}

Header Parameters

Request Body

Response Body

201application/json

422application/json

`application/json`

`application/json`