traces

Get Trace Analysis Context

Changed on

Aggregate context for analysis environments (QA agents).

get/v2/trace/{trace_id}/analysis-context

Request

  • Base URL
    https://api.hud.ai (the document declares no server; this is the origin it was published from)
  • URL
    https://api.hud.ai/v2/trace/{trace_id}/analysis-context
  • Auth
    none declared

Path parameters

trace_idstring uuid required

Query parameters

include_spansboolean
include_env_logsboolean
include_worker_logsboolean

Response

Successful Response

trace_idstring uuid required
job_idstring uuid nullable
task_idstring uuid nullable
task_version_idstring uuid nullable
task_external_idstring nullable
task_namestring nullable
statusstring required
rewardnumber nullable
errorstring nullable
error_codestring nullable
error_source'user' | 'platform' | 'provider'

Who is at fault for a failure.

user: the customer's input, account, environment, or agent code. platform: HUD infrastructure or a broken platform invariant. provider: a third-party dependency (cloud runtime, upstream LLM API).

promptstring nullable
scenario_namestring nullable
scenario_argsobject
scenario_codestring nullable
registry_idstring uuid nullable
evaluation_resultobject nullable
metadataobject
spansobject[] nullable
spans_countinteger
worker_logsstring nullable

Changes

  • 76e7e99cfcd1Revision changes
    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

  • 44153c2e35e9Revision changes
    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status