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

# List audit actors

> Search the actors recorded in this workspace's audit history, including former members and System. Use a returned actor ID to filter audit logs. Continue with nextCursor while hasMore is true.

Administrator access with explicit administrator permission on API keys or MCP credentials, or a signed-in administrator.

Search the actors recorded in this workspace's audit history, including former members and System. Use a returned actor ID to filter audit logs. Continue with nextCursor while hasMore is true.

[Request conventions](https://www.posted.cc/api-reference/overview.md) · [API keys](https://www.posted.cc/api-keys.md) · [MCP connections](https://www.posted.cc/mcp-connections.md)


## OpenAPI

````yaml api-reference/openapi.json GET /api/audit-logs/actors
openapi: 3.1.0
info:
  title: Posted HTTP API
  version: 0.2.6
  description: >-
    All registered application, account, OAuth, MCP transport and health
    endpoints. Publishing and draft request schemas come from the shared runtime
    validators. Replace the example server with your installation. Documentation
    uses simple request examples and does not execute live publishing requests.
servers:
  - url: https://posted-api.example.com
security: []
paths:
  /api/audit-logs/actors:
    get:
      tags:
        - Audit Logs
      summary: List audit actors
      description: >-
        Search the actors recorded in this workspace's audit history, including
        former members and System. Use a returned actor ID to filter audit logs.
        Continue with nextCursor while hasMore is true.


        Administrator access with explicit administrator permission on API keys
        or MCP credentials, or a signed-in administrator.
      operationId: get_api_audit_logs_actors
      parameters:
        - name: workspaceId
          in: query
          required: true
          schema:
            type: string
            format: uuid
          description: >-
            Workspace UUID returned by list_workspaces. Required for Default
            too.
        - name: q
          in: query
          required: false
          schema:
            type: string
            maxLength: 200
          description: string
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 100
          description: integer
        - name: cursor
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: uuid
                pattern: >-
                  ^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
              - type: string
                const: system
          description: JSON value
      responses:
        '200':
          description: >-
            Successful response. Examples are illustrative; field values vary by
            record.
          content:
            application/json:
              schema:
                type: object
                properties:
                  items:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                        name:
                          type: string
                        email:
                          type: string
                      additionalProperties: true
                  hasMore:
                    type: boolean
                  nextCursor:
                    type:
                      - string
                      - 'null'
                additionalProperties: true
              example:
                items:
                  - id: 66666666-6666-4666-8666-666666666666
                    name: Alex Morgan
                    email: alex@example.test
                hasMore: false
                nextCursor: null
        default:
          description: >-
            Request failure. Inspect code, message and requestId; respect
            Retry-After on HTTP 429.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - bearerAuth: []
        - sessionCookie: []
components:
  schemas:
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
            - requestId
          properties:
            code:
              type: string
            message:
              type: string
            requestId:
              type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Personal or workspace Posted REST API key
    sessionCookie:
      type: apiKey
      in: cookie
      name: posted_session
      description: >-
        Signed-in human browser session; mutation requests also need the exact
        UI Origin

````

## Related topics

- [List audit logs](https://www.posted.cc/api-reference/get_api_audit_logs.md)
- [list_audit_logs](https://www.posted.cc/mcp-reference/list_audit_logs.md)
- [Workspaces](https://www.posted.cc/workspaces.md)
- [Create a personal API key](https://www.posted.cc/api-reference/post_api_credentials.md)
- [Create a workspace API key](https://www.posted.cc/api-reference/post_api_workspace_credentials.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.