Skip to main content
Tenant-scoped entity endpoints. Every response is filtered to the tenant this api-tenant instance is bound to (via NTRO_TENANT_SLUG). Path params are entity UUIDs, never slugs — keeping client-identifying strings out of URLs (browser history, screenshots, logs).

​
List entities

GET /v1/entities
Lists every entity registered against this tenant. Response — EntitySummary[]: 
[
  {
    "id": "0cf95a21-…",
    "tenantId": "11111111-…",
    "slug": "acme-fund-one",
    "name": "Acme Fund One Ltd"
  }
]

​
List tasks for an entity

GET /v1/entities/:entityId/tasks
Returns the kanban data for one entity — every task plus an awaiting field (the current display_hint.component) so the UI can bucket by what each workflow is blocked on. Next-step is fetched per-task in parallel; a missing next-step (e.g. workflow already removed from Temporal) silently drops awaiting. Path params
ParamTypeNotes
entityIdUUIDMust belong to this tenant — otherwise 404.
Response — TaskSummary[]: 
[
  {
    "id": "d0b298c2-…",
    "title": "Monthly NAV — 2026-05",
    "status": "IN_PROGRESS",
    "priority": "HIGH",
    "awaiting": "FILE_UPLOAD",
    "entityId": "0cf95a21-…",
    "workflowId": "wf_nav_monthly",
    "createdAt": "2026-05-01T08:00:00Z"
  }
]
Terminal tasks (COMPLETED / FAILED) skip the next-step lookup.

​
List available workflows

GET /v1/entities/:entityId/workflows
Returns workflows the entity can start — tenant-specific workflows plus globally available ones (no tenantId). Used by the kanban “Start workflow” dropdown. Response 
[
  {
    "id": "wf_nav_monthly",
    "name": "nav-monthly",
    "startParams": [
      {
        "key": "period",
        "type": "string",
        "description": "Accounting period (YYYY-MM).",
        "pattern": "^[0-9]{4}-[0-9]{2}$",
        "required": true
      }
    ]
  }
]
startParams is derived from each workflow’s runbook configSchema.global block. Each entry carries key, type (string / number / boolean / array / object), optional description / pattern / enum / default, and required (true when the schema field has no default). Workflow rows whose runbook lookup fails are still returned, just without startParams.

​
Create a task

POST /v1/entities/:entityId/tasks
Starts a workflow run for this entity. Forwards to api-workspace’s POST /workspace/tasks scoped to this tenant + entity. Body 
{
  "workflowId": "wf_nav_monthly",
  "context": {
    "period": "2026-05",
    "priority": "HIGH"
  }
}
FieldRequiredNotes
workflowIdYesMust be one of the IDs returned by GET /entities/:entityId/workflows.
contextNoFree-form JSON forwarded into the workflow’s start payload. Match the runbook’s startParams.
Response — the created task row from api-workspace. Drive it forward with the Tasks endpoints.

​
Errors

StatusWhen
404 Not FoundentityId doesn’t belong to this tenant.
400 Bad RequestMissing / malformed body fields, validated by api-workspace.