Skip to main content
The Entity Service maps and stores the shared operational state of your organization. Base URL: https://api.thygon.com

​
Create entities

​
Create entity

POST /entities Create a new entity with a specific type and properties. You can also specify optional mappings to external SaaS providers. Request body: 
{
  "type": "Task",
  "properties": {
    "title": "Resolve billing login issue",
    "status": "TODO",
    "priority": "high"
  },
  "externalRefs": [
    {
      "provider": "linear",
      "external_id": "issue_lin_9982"
    }
  ]
}
Response (201 Created): 
{
  "success": true,
  "data": {
    "id": "ent_01h3j4k5m6",
    "type": "Task",
    "properties": {
      "title": "Resolve billing login issue",
      "status": "TODO",
      "priority": "high"
    },
    "externalRefs": [
      {
        "provider": "linear",
        "external_id": "issue_lin_9982"
      }
    ],
    "createdAt": "2026-06-16T17:10:00.000Z",
    "updatedAt": "2026-06-16T17:10:00.000Z"
  }
}

​
List & query entities

​
List entities

GET /entities Retrieve a list of active entities. Query parameters:
  • type (string, optional): Filter by exact entity type (e.g. Task).
  • limit (integer, optional): Maximum number of entities to return. Default is 50.
  • skip (integer, optional): Number of entities to skip. Default is 0.
Response (200 OK): 
{
  "success": true,
  "data": [
    {
      "id": "ent_01h3j4k5m6",
      "type": "Task",
      "properties": {
        "title": "Resolve billing login issue",
        "status": "TODO"
      }
    }
  ]
}

​
Get single entity

GET /entities/{id} Retrieve the full properties and external references of a specific entity. Response (200 OK): 
{
  "success": true,
  "data": {
    "id": "ent_01h3j4k5m6",
    "type": "Task",
    "properties": {
      "title": "Resolve billing login issue",
      "status": "TODO"
    },
    "externalRefs": []
  }
}

​
Update & delete entities

​
Update entity properties

PUT /entities/{id} Update the custom properties or change external system mappings for an entity. This operation merges or replaces active configurations. Request body: 
{
  "properties": {
    "status": "DONE"
  },
  "externalRefs": [
    {
      "provider": "linear",
      "external_id": "issue_lin_9982"
    }
  ]
}

​
Delete entity

DELETE /entities/{id} Permanently delete an entity from the shared state layer.