Ga naar inhoud

API-referentie

Referentie voor WorkItem-operaties, beslisstapcontrols, integratie-uitvoering en telemetrie-export.

Deze API's zijn ontworpen voor voorspelbaar automatiseringsgedrag met expliciete beleids- en tenantscoping.

Basisendpoint

Gebruik je geconfigureerde publieke API-endpoint voor geauthenticeerde verzoeken.

https://api.threada.ai

Authenticatie en context

  • Gebruik scoped credentials voor API-toegang
  • Neem tenant- en rolcontext op waar vereist
  • Verzoeken zonder geldige context worden fail-closed afgehandeld

Typische scopes

  • workitems:read en workitems:write
  • workflow:manage voor beleid en beslissingsupdates
  • actions:execute voor beheerde uitvoering
  • telemetry:read voor exports en analyse

Paginering en filtering

  • List-endpoints ondersteunen cursor- of tokengebaseerde paginering
  • Filter op kanaal, workflow, status, beleidsversie en tijdsbereik
  • Gebruik bij voorkeur begrensde vensters voor grote telemetrie-exports

Foutmodel

  • Getypeerde foutcategorieën voor validatie-, autorisatie-, beleids- en uitvoeringsfouten
  • Reason codes ondersteunen deterministische afhandeling in operatortooling
  • Correlatie-ID's worden teruggegeven voor cross-service onderzoek

Voorbeeldverzoeken

Maak een WorkItem aan vanuit intakepayload

Maak een canoniek werkrecord aan voor workflowverwerking. Neem de channel identifier voor het intakekanaal op wanneer vereist.

Verzoek 
curl -X POST "https://api.threada.ai/api/v1/public/work-items" \
  -H "X-API-Key: <api-key>" \
  -H "Content-Type: application/json" \
  -d "{\"subject\":\"Review renewal request\",\"channel\":\"web\",\"channel_id\":\"web_main\",\"initial_message\":{\"role\":\"user\",\"content\":\"Review this renewal request before approval\"},\"tags\":[\"policy_review\"]}"
Antwoord 
{
  "work_item": {
    "summary": {
      "work_item_id": "wi_123",
      "status": "new",
      "subject": "Review renewal request"
    }
  }
}

Voer een goedgekeurde actie uit

Voer een door beleid goedgekeurde actie uit tegen een geconfigureerde integratie.

Verzoek 
curl -X POST "https://api.threada.ai/api/v1/public/work-items/wi_123/actions" \
  -H "X-API-Key: <api-key>" \
  -H "Content-Type: application/json" \
  -d "{\"integration_id\":\"int_workflow\",\"idempotency_key\":\"act_456\",\"payload\":{\"type\":\"custom_http\",\"method\":\"POST\",\"url\":\"https://api.example.com/approvals\",\"body_json\":\"{\\\"approved\\\":true}\"}}"
Antwoord 
{
  "action": {
    "action_id": "act_456",
    "work_item_id": "wi_123",
    "action_type": "custom_http",
    "status": "completed"
  }
}

Voorbeeldartefacten

Illustratieve voorbeelden van de objecten die Threada produceert, met synthetische data — geen echte klanten of records. Veldnamen volgen de API- en auditschema's van Threada.

Implementatiebegeleiding nodig?

Gebruik de docs en het technische overzicht voor uitrol- en governancepatronen.

Neem contact op met technisch team