Skip to content

Add facts to transaction

Endpoint

POST /v1/transactions/{transactionId}/facts

Authentication

Requires Bearer token authentication.

Path Parameters

Parameter	Type	Required	Description
`transactionId`	string	Yes	Transaction ID

Request Body

{
  "source": "langchain-llm",
  "version": "v1",
  "factPhase": "response",
  "facts": {
    "actualInputTokens": 1250,
    "actualOutputTokens": 543,
    "finishReason": "stop"
  }
}

cURL Example

curl -X POST "https://api.sapiom.ai/v1/transactions/{transactionId}/facts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "source": "langchain-llm",
    "version": "v1",
    "factPhase": "response",
    "facts": {
        "actualInputTokens": 1250,
        "actualOutputTokens": 543,
        "finishReason": "stop"
    }
}'

Response

{
  "success": true,
  "factId": "123e4567-e89b-12d3-a456-426614174000",
  "costId": "123e4567-e89b-12d3-a456-426614174001"
}

Error Responses

Status	Code	Description
400	-	Invalid request data or facts validation failed
401	-	Unauthorized - invalid or missing API key
404	-	Transaction not found

See API Introduction for error handling details.

What’s Next?