> **Can't find what you're looking for?** Use `search_docs` on the docs MCP server at `https://docs.prividium.com/api/mcp` to find what you need.
>
> **Have feedback?** Use `submit_feedback` on the same MCP server.

# audit-logs

## GET /audit-logs/

`GET /audit-logs/`

List audit logs with pagination and filtering

### Query parameters

- `limit` `integer`
- `offset` `integer`
- `userId` `string`
- `activeTenantId` `string`
- `actionType` `string`
- `resourceId` `string`
- `requestId` `string`
- `traceId` `string`
- `startDate` `string <date-time> | string`
- `endDate` `string <date-time> | string`

### Responses

#### `200`: Default Response

Body (`application/json`):

- `items` `object[]` _(required)_
  - `id` `string` _(required)_
  - `activeUserId` `string | null` _(required)_
  - `activeTenantId` `string | null` _(required)_
  - `activeServiceId` `string | null` _(required)_
  - `activeOrganizationId` `string | null`
  - `actionType` `string` _(required)_
  - `actionDetails` `object` _(required)_
  - `traceId` `string | null` _(required)_
  - `requestId` `string | null` _(required)_
  - `actorType` `string | null` _(required)_
  - `authSubject` `string | null` _(required)_
  - `ipAddress` `string | null` _(required)_
  - `userAgent` `string | null` _(required)_
  - `createdAt` `string` _(required)_
- `pagination` `object` _(required)_
  - `currentPage` `number` _(required)_
  - `totalPages` `number` _(required)_
  - `totalItems` `number` _(required)_
  - `limit` `number` _(required)_
  - `offset` `number` _(required)_

#### `401`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

#### `403`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

### Example request

```bash
curl '/api/audit-logs/?limit=50&offset=0&userId=string&activeTenantId=string&actionType=string&resourceId=string&requestId=string&traceId=string&startDate=1970-01-01T00:00:00.000Z&endDate=1970-01-01T00:00:00.000Z'
```

```ts
fetch('/api/audit-logs/?limit=50&offset=0&userId=string&activeTenantId=string&actionType=string&resourceId=string&requestId=string&traceId=string&startDate=1970-01-01T00:00:00.000Z&endDate=1970-01-01T00:00:00.000Z')
```

## GET /audit-logs/user/{userId}

`GET /audit-logs/user/{userId}`

Get audit logs for a specific user

### Path parameters

- `userId` `string` _(required)_

### Query parameters

- `limit` `number`
- `offset` `number`

### Responses

#### `200`: Default Response

Body (`application/json`):

- `items` `object[]` _(required)_
  - `id` `string` _(required)_
  - `activeUserId` `string | null` _(required)_
  - `activeTenantId` `string | null` _(required)_
  - `activeServiceId` `string | null` _(required)_
  - `activeOrganizationId` `string | null`
  - `actionType` `string` _(required)_
  - `actionDetails` `object` _(required)_
  - `traceId` `string | null` _(required)_
  - `requestId` `string | null` _(required)_
  - `actorType` `string | null` _(required)_
  - `authSubject` `string | null` _(required)_
  - `ipAddress` `string | null` _(required)_
  - `userAgent` `string | null` _(required)_
  - `createdAt` `string` _(required)_
- `pagination` `object` _(required)_
  - `currentPage` `number` _(required)_
  - `totalPages` `number` _(required)_
  - `totalItems` `number` _(required)_
  - `limit` `number` _(required)_
  - `offset` `number` _(required)_

#### `401`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

#### `403`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

#### `404`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

### Example request

```bash
curl '/api/audit-logs/user/string?limit=50&offset=0'
```

```ts
fetch('/api/audit-logs/user/string?limit=50&offset=0')
```

## GET /audit-logs/action/{actionType}

`GET /audit-logs/action/{actionType}`

Get audit logs by action type

### Path parameters

- `actionType` `string` _(required)_

### Query parameters

- `limit` `number`
- `offset` `number`

### Responses

#### `200`: Default Response

Body (`application/json`):

- `items` `object[]` _(required)_
  - `id` `string` _(required)_
  - `activeUserId` `string | null` _(required)_
  - `activeTenantId` `string | null` _(required)_
  - `activeServiceId` `string | null` _(required)_
  - `activeOrganizationId` `string | null`
  - `actionType` `string` _(required)_
  - `actionDetails` `object` _(required)_
  - `traceId` `string | null` _(required)_
  - `requestId` `string | null` _(required)_
  - `actorType` `string | null` _(required)_
  - `authSubject` `string | null` _(required)_
  - `ipAddress` `string | null` _(required)_
  - `userAgent` `string | null` _(required)_
  - `createdAt` `string` _(required)_
- `pagination` `object` _(required)_
  - `currentPage` `number` _(required)_
  - `totalPages` `number` _(required)_
  - `totalItems` `number` _(required)_
  - `limit` `number` _(required)_
  - `offset` `number` _(required)_

#### `401`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

#### `403`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

### Example request

```bash
curl '/api/audit-logs/action/string?limit=50&offset=0'
```

```ts
fetch('/api/audit-logs/action/string?limit=50&offset=0')
```

## GET /audit-logs/request/{requestId}

`GET /audit-logs/request/{requestId}`

Get all audit logs for a specific HTTP request

### Path parameters

- `requestId` `string` _(required)_

### Query parameters

- `limit` `number`
- `offset` `number`

### Responses

#### `200`: Default Response

Body (`application/json`):

- `items` `object[]` _(required)_
  - `id` `string` _(required)_
  - `activeUserId` `string | null` _(required)_
  - `activeTenantId` `string | null` _(required)_
  - `activeServiceId` `string | null` _(required)_
  - `activeOrganizationId` `string | null`
  - `actionType` `string` _(required)_
  - `actionDetails` `object` _(required)_
  - `traceId` `string | null` _(required)_
  - `requestId` `string | null` _(required)_
  - `actorType` `string | null` _(required)_
  - `authSubject` `string | null` _(required)_
  - `ipAddress` `string | null` _(required)_
  - `userAgent` `string | null` _(required)_
  - `createdAt` `string` _(required)_
- `pagination` `object` _(required)_
  - `currentPage` `number` _(required)_
  - `totalPages` `number` _(required)_
  - `totalItems` `number` _(required)_
  - `limit` `number` _(required)_
  - `offset` `number` _(required)_

#### `401`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

#### `403`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

### Example request

```bash
curl '/api/audit-logs/request/string?limit=50&offset=0'
```

```ts
fetch('/api/audit-logs/request/string?limit=50&offset=0')
```

## GET /audit-logs/trace/{traceId}

`GET /audit-logs/trace/{traceId}`

Get all audit logs for a trace (spans multiple requests/services)

### Path parameters

- `traceId` `string` _(required)_

### Query parameters

- `limit` `number`
- `offset` `number`

### Responses

#### `200`: Default Response

Body (`application/json`):

- `items` `object[]` _(required)_
  - `id` `string` _(required)_
  - `activeUserId` `string | null` _(required)_
  - `activeTenantId` `string | null` _(required)_
  - `activeServiceId` `string | null` _(required)_
  - `activeOrganizationId` `string | null`
  - `actionType` `string` _(required)_
  - `actionDetails` `object` _(required)_
  - `traceId` `string | null` _(required)_
  - `requestId` `string | null` _(required)_
  - `actorType` `string | null` _(required)_
  - `authSubject` `string | null` _(required)_
  - `ipAddress` `string | null` _(required)_
  - `userAgent` `string | null` _(required)_
  - `createdAt` `string` _(required)_
- `pagination` `object` _(required)_
  - `currentPage` `number` _(required)_
  - `totalPages` `number` _(required)_
  - `totalItems` `number` _(required)_
  - `limit` `number` _(required)_
  - `offset` `number` _(required)_

#### `401`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

#### `403`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

### Example request

```bash
curl '/api/audit-logs/trace/string?limit=50&offset=0'
```

```ts
fetch('/api/audit-logs/trace/string?limit=50&offset=0')
```

## GET /audit-logs/recent

`GET /audit-logs/recent`

Get recent audit logs (last 24 hours) including DB-level mutations, filterable by user and action type

### Query parameters

- `limit` `number`
- `offset` `number`
- `userId` `string`
- `actionType` `string`

### Responses

#### `200`: Default Response

Body (`application/json`):

- `items` `object[]` _(required)_
- `pagination` `object` _(required)_
  - `currentPage` `number` _(required)_
  - `totalPages` `number` _(required)_
  - `totalItems` `number` _(required)_
  - `limit` `number` _(required)_
  - `offset` `number` _(required)_

#### `401`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

#### `403`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

### Example request

```bash
curl '/api/audit-logs/recent?limit=100&offset=0&userId=string&actionType=string'
```

```ts
fetch('/api/audit-logs/recent?limit=100&offset=0&userId=string&actionType=string')
```

## GET /audit-logs/db-mutations

`GET /audit-logs/db-mutations`

List DB-level mutation audit logs captured by Postgres triggers

### Query parameters

- `tableName` `string`
- `operation` `string`
- `primaryKey` `string`
- `requestId` `string`
- `traceId` `string`
- `actorId` `string`
- `limit` `integer`
- `offset` `integer`

### Responses

#### `200`: Default Response

Body (`application/json`):

- `items` `object[]` _(required)_
  - `id` `string` _(required)_
  - `occurredAt` `string` _(required)_
  - `tableName` `string` _(required)_
  - `operation` `string` _(required)_
  - `primaryKey` `string | null` _(required)_
  - `oldRow` `object` _(required)_
  - `newRow` `object` _(required)_
  - `changedColumns` `string[]` _(required)_
  - `requestId` `string | null` _(required)_
  - `jobId` `string | null` _(required)_
  - `traceId` `string | null` _(required)_
  - `actorId` `string | null` _(required)_
  - `actorType` `string | null` _(required)_
  - `httpOperation` `string | null` _(required)_
  - `method` `string | null` _(required)_
  - `url` `string | null` _(required)_
  - `createdAt` `string` _(required)_
- `pagination` `object` _(required)_
  - `currentPage` `number` _(required)_
  - `totalPages` `number` _(required)_
  - `totalItems` `number` _(required)_
  - `limit` `number` _(required)_
  - `offset` `number` _(required)_

#### `401`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

#### `403`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

### Example request

```bash
curl '/api/audit-logs/db-mutations?tableName=string&operation=INSERT&primaryKey=string&requestId=string&traceId=string&actorId=string&limit=50&offset=0'
```

```ts
fetch('/api/audit-logs/db-mutations?tableName=string&operation=INSERT&primaryKey=string&requestId=string&traceId=string&actorId=string&limit=50&offset=0')
```

## GET /audit-logs/db-mutations/request/{requestId}

`GET /audit-logs/db-mutations/request/{requestId}`

Get all DB mutations captured during a specific HTTP request

### Path parameters

- `requestId` `string` _(required)_

### Query parameters

- `limit` `integer`
- `offset` `integer`

### Responses

#### `200`: Default Response

Body (`application/json`):

- `items` `object[]` _(required)_
  - `id` `string` _(required)_
  - `occurredAt` `string` _(required)_
  - `tableName` `string` _(required)_
  - `operation` `string` _(required)_
  - `primaryKey` `string | null` _(required)_
  - `oldRow` `object` _(required)_
  - `newRow` `object` _(required)_
  - `changedColumns` `string[]` _(required)_
  - `requestId` `string | null` _(required)_
  - `jobId` `string | null` _(required)_
  - `traceId` `string | null` _(required)_
  - `actorId` `string | null` _(required)_
  - `actorType` `string | null` _(required)_
  - `httpOperation` `string | null` _(required)_
  - `method` `string | null` _(required)_
  - `url` `string | null` _(required)_
  - `createdAt` `string` _(required)_
- `pagination` `object` _(required)_
  - `currentPage` `number` _(required)_
  - `totalPages` `number` _(required)_
  - `totalItems` `number` _(required)_
  - `limit` `number` _(required)_
  - `offset` `number` _(required)_

#### `401`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

#### `403`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

### Example request

```bash
curl '/api/audit-logs/db-mutations/request/string?limit=50&offset=0'
```

```ts
fetch('/api/audit-logs/db-mutations/request/string?limit=50&offset=0')
```

## GET /audit-logs/db-mutations/trace/{traceId}

`GET /audit-logs/db-mutations/trace/{traceId}`

Get all DB mutations within a trace (spans multiple requests)

### Path parameters

- `traceId` `string` _(required)_

### Query parameters

- `limit` `integer`
- `offset` `integer`

### Responses

#### `200`: Default Response

Body (`application/json`):

- `items` `object[]` _(required)_
  - `id` `string` _(required)_
  - `occurredAt` `string` _(required)_
  - `tableName` `string` _(required)_
  - `operation` `string` _(required)_
  - `primaryKey` `string | null` _(required)_
  - `oldRow` `object` _(required)_
  - `newRow` `object` _(required)_
  - `changedColumns` `string[]` _(required)_
  - `requestId` `string | null` _(required)_
  - `jobId` `string | null` _(required)_
  - `traceId` `string | null` _(required)_
  - `actorId` `string | null` _(required)_
  - `actorType` `string | null` _(required)_
  - `httpOperation` `string | null` _(required)_
  - `method` `string | null` _(required)_
  - `url` `string | null` _(required)_
  - `createdAt` `string` _(required)_
- `pagination` `object` _(required)_
  - `currentPage` `number` _(required)_
  - `totalPages` `number` _(required)_
  - `totalItems` `number` _(required)_
  - `limit` `number` _(required)_
  - `offset` `number` _(required)_

#### `401`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

#### `403`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

### Example request

```bash
curl '/api/audit-logs/db-mutations/trace/string?limit=50&offset=0'
```

```ts
fetch('/api/audit-logs/db-mutations/trace/string?limit=50&offset=0')
```

## GET /audit-logs/db-mutations/resource/{tableName}/{primaryKey}

`GET /audit-logs/db-mutations/resource/{tableName}/{primaryKey}`

Get all DB mutations for a specific resource identified by table name and primary key

### Path parameters

- `tableName` `string` _(required)_
- `primaryKey` `string` _(required)_

### Query parameters

- `limit` `integer`
- `offset` `integer`

### Responses

#### `200`: Default Response

Body (`application/json`):

- `items` `object[]` _(required)_
  - `id` `string` _(required)_
  - `occurredAt` `string` _(required)_
  - `tableName` `string` _(required)_
  - `operation` `string` _(required)_
  - `primaryKey` `string | null` _(required)_
  - `oldRow` `object` _(required)_
  - `newRow` `object` _(required)_
  - `changedColumns` `string[]` _(required)_
  - `requestId` `string | null` _(required)_
  - `jobId` `string | null` _(required)_
  - `traceId` `string | null` _(required)_
  - `actorId` `string | null` _(required)_
  - `actorType` `string | null` _(required)_
  - `httpOperation` `string | null` _(required)_
  - `method` `string | null` _(required)_
  - `url` `string | null` _(required)_
  - `createdAt` `string` _(required)_
- `pagination` `object` _(required)_
  - `currentPage` `number` _(required)_
  - `totalPages` `number` _(required)_
  - `totalItems` `number` _(required)_
  - `limit` `number` _(required)_
  - `offset` `number` _(required)_

#### `401`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

#### `403`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

### Example request

```bash
curl '/api/audit-logs/db-mutations/resource/string/string?limit=50&offset=0'
```

```ts
fetch('/api/audit-logs/db-mutations/resource/string/string?limit=50&offset=0')
```

## GET /audit-logs/action-types

`GET /audit-logs/action-types`

Get all available audit action types

### Responses

#### `200`: Default Response

Body (`application/json`):

- `actionTypes` `string[]` _(required)_

#### `401`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

#### `403`: Default Response

Body (`application/json`):

- `error` `object` _(required)_
  - `code` `string` _(required)_
  - `message` `string` _(required)_
  - `issues` `unknown[]`

### Example request

```bash
curl /api/audit-logs/action-types
```

```ts
fetch('/api/audit-logs/action-types')
```