---
title: "Get audit logs"
method: GET
path: "/workspaces/logs"
tags: ["Workspace Logs"]
---

# Get audit logs

`GET /workspaces/logs`

## Request

- Base URL: `https://app.freyavoice.ai/api/v2`
- URL: `https://app.freyavoice.ai/api/v2/workspaces/logs`
- Auth: HTTP bearer

Returns audit log entries for workspace events (login, API key changes, member changes, exports, etc.).

## Query parameters

- `workspaceId` string, uuid, required: Workspace ID
- `limit` integer: Maximum number of logs to return (1-100)
- `cursor` string: Cursor for pagination

## Response `200`

Audit log entries

- object
  - `success` true, required
  - `data` object, required
    - `message` string, required
    - `result` object, required
      - `logs` object[], required
        - `id` string, required
        - `workspaceId` string, required
        - `eventType` 'LOGIN' | 'LOGOUT' | 'SIGNUP' | 'PASSWORD_RESET' | 'API_KEYS' | 'MEMBERS' | 'PHONE_NUMBERS' | 'EXPORTS', required
        - `eventDescription` string, required
        - `actorId` string, nullable, required
        - `actorEmail` string, nullable
        - `metadata` object
        - `createdAt` string, required
      - `nextCursor` string, nullable

## Other responses

- `400`: Validation error
- `401`: Missing or invalid token
- `500`: Server error

---

[API](https://skmtc.dev/freyavoice/apis/freyavoice-api.md) - [All operations](https://skmtc.dev/freyavoice/apis/freyavoice-api/llms.txt) - [OpenAPI document](https://skmtc.dev/freyavoice/apis/freyavoice-api/revisions/153d120f0c73?raw)