curl --request POST \
  --url https://backend.trusys.ai/api/external/applications/{applicationId}/evaluations \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "traces": {
    "prompt": "What is the weather in Seattle?",
    "response": "It is 62°F and cloudy in Seattle.",
    "trusys": {
      "tool_calls": [
        {
          "name": "get_weather",
          "description": "Fetch current weather for a city",
          "arguments": {
            "city": "Seattle"
          },
          "output": "62°F, cloudy"
        }
      ]
    }
  }
}
'

{
  "success": true,
  "data": {
    "evalId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "applicationId": "550e8400-e29b-41d4-a716-446655440000",
    "traceId": "6ba7b810-9dad-11d1-80b4-00c04fd430c8"
  }
}

Submit traces for evaluation

Scores one or more prompt/response traces against the monitoring configuration on the application.

Prerequisites: monitoring must include at least one metric or security plugin (PUT /applications/{applicationId}/monitoring).

Trace payload: each trace includes prompt and response strings. Optional trusys metadata supports agentic flows (tool_calls, agent_calls, plan) and retrieval-augmented flows (query, context).

Single vs batch: pass traces as one object or an array. For a single trace, the response data is one object; for a batch, data is an array.

Trace IDs: supply traceId (string) to correlate with your own logging, or omit it and one is generated automatically.

POST

applications

{applicationId}

evaluations

curl --request POST \
  --url https://backend.trusys.ai/api/external/applications/{applicationId}/evaluations \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "traces": {
    "prompt": "What is the weather in Seattle?",
    "response": "It is 62°F and cloudy in Seattle.",
    "trusys": {
      "tool_calls": [
        {
          "name": "get_weather",
          "description": "Fetch current weather for a city",
          "arguments": {
            "city": "Seattle"
          },
          "output": "62°F, cloudy"
        }
      ]
    }
  }
}
'

{
  "success": true,
  "data": {
    "evalId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "applicationId": "550e8400-e29b-41d4-a716-446655440000",
    "traceId": "6ba7b810-9dad-11d1-80b4-00c04fd430c8"
  }
}

Authorizations

x-api-key

string

header

required

Your Trusys API key. Create and manage keys in the Trusys UI under Settings → API Keys.

Include the key on every request:

x-api-key: <your-api-key>

Path Parameters

applicationId

string<uuid>

required

Unique identifier (UUID) of the application. Returned by POST /applications.

Body

application/json

One trace or an array of traces to evaluate.

traces

object

required

One trace object or a non-empty array of traces.

object
object[]

Show child attributes

Response

Evaluation completed (or skipped for empty prompt/response pairs).

success

boolean

data

object

Single result object for one trace, or an array for batch submissions.

object
object[]

Show child attributes