v51

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-014102371.0 MB
AI

Delete an AI audit.

Soft-deletes an AI audit record. The associated aicall is not affected.

delete/aiaudits/{id}

Path parameters

idstring uuid required

The AI audit ID.

Response

The deleted AI audit record.

idstring uuid

The unique identifier of the audit.

customer_idstring uuid

The customer who owns this audit.

aicall_idstring uuid

The AI call that was audited. Returned from the GET /aicalls response.

ai_idstring uuid

The AI participant that was evaluated. Returned from the GET /ais response.

prompt_history_idstring uuid

The prompt version active during the call.

status'progressing' | 'completed' | 'failed'

Status of the AI audit.

overall_scoreinteger nullable

Overall score (1-5) independently assessed by the LLM. Null until completed.

evaluationobject nullable

Full structured evaluation output. Null until completed.

message_idsstring[] nullable

Ordered list of message IDs (newest-first) that were evaluated by Gemini. Null while progressing, on failure, or for audits completed before this feature. Present and non-empty on successful completion for calls with messages.

languagestring

BCP47 language code used for audit output.

errorstring

Failure reason if status is failed.

tm_createstring date-time

Timestamp when the audit was created.

tm_updatestring date-time nullable

Timestamp when the audit was last updated.

tm_deletestring date-time nullable

Timestamp when the audit was deleted.

Example response

{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "customer_id": "7c4d2f3a-1b8e-4f5c-9a6d-3e2f1a0b4c5d",
  "aicall_id": "550e8400-e29b-41d4-a716-446655440000",
  "ai_id": "550e8400-e29b-41d4-a716-446655440000",
  "prompt_history_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "progressing",
  "overall_score": 4,
  "evaluation": {
    "overall_score": 4,
    "dimensions": {
      "helpfulness": {
        "score": 4,
        "reason": "Provided clear and helpful answers."
      },
      "accuracy": {
        "score": 4,
        "reason": "Responses were factually correct."
      },
      "tone": {
        "score": 5,
        "reason": "Maintained professional and empathetic tone."
      },
      "goal_completion": {
        "score": 4,
        "reason": "Successfully resolved the customer's issue."
      },
      "tool_usage": null
    },
    "summary": "The AI assistant performed well overall."
  },
  "message_ids": [
    "550e8400-e29b-41d4-a716-446655440001",
    "550e8400-e29b-41d4-a716-446655440002"
  ],
  "language": "en-US",
  "error": "LLM API quota exceeded",
  "tm_create": "2026-01-15T09:30:00.000000Z",
  "tm_update": "2026-01-15T09:30:00.000000Z",
  "tm_delete": "2026-01-15T09:30:00.000000Z"
}