---
title: "Get workspace logs"
method: GET
path: "/api/v1/logs"
tags: ["logs"]
---

# Get workspace logs

`GET /api/v1/logs`

Retrieve a paginated list of audit logs for your workspace.

        This endpoint allows you to:
        - Get all audit logs in your workspace
        - Filter logs by user, action, operation, or date range
        - Paginate through large sets of logs using cursor-based or offset-based pagination

        **Use cases:**
        - Building an audit log viewer or dashboard
        - Monitoring workspace activity
        - Compliance and security auditing
        - Tracking user actions and changes

        **Available log actions:**
        - workspace, workspace:team, workspace:invite, workspace:invite:redeem, workspace:preferences, workspace:avatar, workspace:rename, workspace:user, workspace:user:role
        - collection
        - scene, scene:readonly-link, scene:readonly-links, scene:link-sharing, scene:collection, scene:upload, scene:image-upload, scene:slides, scene:comment
        - user:signup
        - ai:diagram-to-code, ai:text-to-diagram, ai:text-to-drawing

## Query parameters

- `limit` integer
- `offset` integer
- `cursor` string
- `page` string
- `user` string
- `action` string
- `operation` 'create' | 'read' | 'update' | 'delete'
- `dateFrom` string
- `dateTo` string

## Response `200`

This response returns a paginated list of workspace audit logs.

- object — This response returns a paginated list of workspace audit logs.
  - `logs` object[], required — Array of log entries
    - `id` string, uuid, required
    - `action` string, required
    - `operation` string, required
    - `details` union, required
      - string
      - number
      - boolean
      - object
      - unknown[]
        - unknown
    - `created_at` string, required
    - `ip_address` string, required
    - `user_id` string, required
    - `workspace_id` string, required
    - `app_source` 'admin' | 'excalidraw-plus', required
    - `source_type` 'user' | 'api' | 'crontab' | 'webhook' | 'guest', required
    - `source_id` string, required
    - `status` integer, required
    - `user_email` string
    - `user_full_name` string
    - `user_picture` string
  - `nextCursor` string, required — Cursor for next page (null if no more pages)
  - `hasMore` boolean, required — Whether there are more logs to fetch
  - `availableActions` string[], required — List of available log actions that can be filtered
  - `totalCount` number, required — Total count of logs (only when using page parameter)
  - `totalPages` number, required — Total pages (only when using page parameter)
  - `currentPage` number, required — Current page number (only when using page parameter)

## Other responses

- `400` — This response indicates that the request was malformed or contained invalid parameters.
- `401` — This response indicates that the client must authenticate to access the requested resource.
- `403` — This response indicates that the client does not have permission to access the requested resource.

---

[API](https://skmtc.net/excalidraw/apis/excalidraw-api.md) · [All operations](https://skmtc.net/excalidraw/apis/excalidraw-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/excalidraw/excalidraw-api/revisions/c1404d1545ba/schema)