Cancel a list build - Autotouch AI

This page documents the canonical HTTP contract for this endpoint.

This endpoint accepts no request body. If the job is cancelled, it returns {"status":"cancelled","job_id":"…"}. If it cannot cancel the job, it returns the current summarized job instead; inspect that status rather than assuming the request stopped execution.

Authentication and organization context are required. Developer API keys need search:run. Unknown jobs return 404; a missing organization context returns 400.

Path parameters

job_idrequired
string
List-build ID returned by POST /api/list-builds.

Name	Type	Description
job_idrequired	string	List-build ID returned by POST /api/list-builds.

Errors

Status	Meaning
400	organization_id is required.
401	Authentication required.
403	Developer API key lacks search:run.
404	List build job not found.

Example

bash

curl -X DELETE "https://app.autotouch.ai/api/list-builds/lb_1234567890abcdef12345678" -H "Authorization: Bearer $AUTOTOUCH_API_KEY"

Response example

json

{"status":"cancelled","job_id":"lb_1234567890abcdef12345678"}