Skip to main content
PUT
/
api
/
v1
/
tasks
/
{task_id}
/
fail
Fail Task
curl --request PUT \
  --url https://api.tracelm.ai/api/v1/tasks/{task_id}/fail

​
Path Parameters

  • task_id (UUID)

​
Request Body

All fields optional:
  • reason (stored as failure_reason in metadata)
  • metadata
  • project_id (required for upsert if auth scope has multiple projects)
  • conversation_id
  • user_id
  • task_name

​
Response

{
  "id": "...",
  "status": "failed",
  "completed_at": "..."
}