traces

Update Trace

Changed on

Update a trace's metadata fields.

patch/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

Request body

namestring nullable
descriptionstring nullable

Response

Successful Response

idstring uuid required
job_idstring uuid required
task_version_idstring uuid nullable
task_slugstring nullable
task_idstring uuid 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).

evaluation_resultobject nullable
start_timestring date-time nullable
end_timestring date-time nullable
created_atstring date-time required
task_promptstring nullable
task_namestring nullable
namestring nullable
descriptionstring nullable
metadataobject
job_namestring nullable
execution_mode'external' | 'cloud' | 'hosted' required
runtime_provider'ec2' | 'modal'

Sandbox runtime provider for HUD-managed instances.

publicboolean
job_publicboolean
trace_publicboolean
is_ownerboolean
can_editboolean
can_view_jobboolean
can_view_tasksetboolean

Changes