> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hyperleap.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Audit Report Overview

> Overview of the Audit Report API endpoints

## Introduction

The Audit Report API allows you to retrieve detailed information about AI interactions with conversations and prompt runs for auditing and compliance purposes.

* Conversations
* Conversation run details
* Prompt runs
* Prompt run details

## Available Endpoints

### [Conversations](/api-reference/audit-report/conversations)

Retrieve audit information about conversations based on filter conditions passed.

```
POST /audit/conversations
```

**Basic Response Format:**

```json theme={null}
{
  "conversations": [
    {
      "id": "string",
      "name": "string",
      "createdAt": "string",
      "updatedAt": "string",
      "externalUserId": "string"
    }
  ],
  "total": 0
}
```

### [Conversation Run Details](/api-reference/audit-report/conversation-run-details)

Retrieve detailed audit information about a specific conversation run based on the conversation id.

```
GET /audit/conversations/{conversationId}
```

**Basic Response Format:**

```json theme={null}
{
  "id": "string",
  "conversationId": "string",
  "messages": [
    {
      "role": "user|assistant",
      "content": "string",
      "timestamp": "string"
    }
  ],
  "metadata": {
    "key": "value"
  }
}
```

### [Prompt Runs](/api-reference/audit-report/prompt-runs)

Retrieve audit information about prompt runs based on filter conditions passed.

```
POST /audit/prompt-runs
```

**Basic Response Format:**

```json theme={null}
{
  "promptRuns": [
    {
      "id": "string",
      "promptId": "string",
      "promptVersionId": "string",
      "createdAt": "string",
      "status": "string"
    }
  ],
  "total": 0
}
```

### [Prompt Run Details](/api-reference/audit-report/prompt-run-details)

Retrieve detailed audit information about a specific prompt run based on the prompt run id.

```
GET /audit/prompt-runs/{promptRunId}
```

**Basic Response Format:**

```json theme={null}
{
  "id": "string",
  "promptId": "string",
  "promptVersionId": "string",
  "input": {
    "replacements": {
      "key": "value"
    }
  },
  "output": "string",
  "createdAt": "string",
  "completedAt": "string",
  "status": "string"
}
```

## Use Cases

* Compliance reporting
* Quality assurance
* Performance analysis
* Security auditing
* Debugging and troubleshooting

<RequestExample>
  ```js ENDPOINTS theme={null}
  POST / audit / conversations;
  GET / audit / conversations / { conversationId };
  POST / audit / prompt - runs;
  GET / audit / prompt - runs / { promptRunId };
  ```
</RequestExample>
