Create a new entity in the knowledge graph.

• name: The entity’s display name (required, max 256 chars)
• entity_type: Type of entity (concept, instance, class, property, event, action, state, or custom)
• properties: Optional key-value pairs for additional metadata Response Returns the created entity with its assigned unique identifier and automatically generated embedding vector for semantic similarity search. Errors
• 400 Bad Request: Invalid input (empty name, exceeds limits, invalid characters)
• 500 Internal Server Error: Entity creation or embedding generation failed Example (curl)

curl -X POST 'https://api.nsr.stateset.com/api/v1/entities' \
-H 'X-API-Key: your-api-key' \
-H 'Content-Type: application/json' \
-d '{'name': 'Customer', 'entity_type': 'class', 'properties': {'description': 'A person who purchases goods'}}'

​

Request body

​

Response

​

Status codes

curl --request POST \
  --url 'https://api.nsr.stateset.com/api/v1/entities' \
  --header 'X-API-Key: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
  "entity_type": "string",
  "name": "string",
  "properties": {}
}'

{
  "confidence": 1,
  "created_at": "string",
  "entity_type": "string",
  "has_embedding": true,
  "id": "string",
  "name": "string",
  "properties": {},
  "updated_at": "string"
}