Agents

Delete a run

Deletes a specific run and all its associated data, including files and storage. This is primarily used for PII compliance when an agent extracts personally identifiable information. The run can be in either the active Runs table or the RunHistory table — both are checked automatically.

The removeMethod parameter controls what is deleted:

RemoveEntireRun (default) — completely removes the run record and all associated files.
RemoveAllFiles — removes files but keeps the run record.
RemoveAllFilesAndAgentInput — removes files and clears agent input parameters.

DELETE

api

agent

{agentId}

run

{runId}

Delete a run and all its associated data

curl --request DELETE \
  --url https://api.example.com/api/v1/agent/{agentId}/run/{runId} \
  --header 'Authorization: Bearer <token>'

{
  "statusCode": 123,
  "statusDescription": "<string>",
  "message": "<string>",
  "errorCode": "<string>"
}

Authorizations

Authorization

string

header

required

API Key authorization header. Example: "Authorization: ApiKey {your-api-key}"

Authorization

string

header

required

OAuth 2.0 Bearer token. Example: "Authorization: Bearer {access-token}"

Path Parameters

agentId

integer<int32>

required

The ID of the agent that contains the run

runId

integer<int64>

required

The ID of the run to delete

Query Parameters

removeMethod

enum<string>

The deletion method to use. Defaults to RemoveEntireRun.

Available options:

RemoveAllFiles,

RemoveAllFilesAndAgentInput,

RemoveEntireRun

Response

The run was successfully deleted

Kill a run List run output files