traces

Get a trace by id.

get/v2/trace/{trace_id}

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}
  • Auth
    none declared

Path parameters

trace_idstring uuid required

Response

Successful Response

idstring uuid required
job_idstring uuid required
task_version_idstring uuid nullable
task_slugstring nullable
instance_idstring uuid nullable
inference_llm_model_idstring uuid nullable
statusstring required
rewardnumber nullable
stop_reason'done' | 'max_steps' | 'length' | 'timeout' | 'malformed_tool_call'
viewsinteger
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).

metadataobject
start_timestring date-time nullable
end_timestring date-time nullable
created_atstring date-time required
evaluation_resultobject nullable

Changes

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • warning

      removed the optional property // from the response with the status

    • warning

      removed the optional property // from the response with the status