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

# List Audit Log

> The project's audit log, newest first: each change made through the
API to its agents, credentials, phone numbers, API keys and settings, the
API key that made it, and what changed (secrets never recorded).
`request_id` reads back everything one request wrote: a publish's
archived versions and re-pointed numbers as well as the version.

Paged by cursor, not by page number: entries keep arriving at the head of
the list, so a page number would shift under the reader. Pass
`next_cursor` back as `cursor` for the next page; it is null on the last.
Admin key only.



## OpenAPI

````yaml /openapi.json get /v1/audit-log
openapi: 3.1.0
info:
  title: TurnCall
  description: Production voice agent platform API
  version: 2.0.0
servers: []
security: []
paths:
  /v1/audit-log:
    get:
      tags:
        - audit-log
      summary: List Audit Log
      description: >-
        The project's audit log, newest first: each change made through the

        API to its agents, credentials, phone numbers, API keys and settings,
        the

        API key that made it, and what changed (secrets never recorded).

        `request_id` reads back everything one request wrote: a publish's

        archived versions and re-pointed numbers as well as the version.


        Paged by cursor, not by page number: entries keep arriving at the head
        of

        the list, so a page number would shift under the reader. Pass

        `next_cursor` back as `cursor` for the next page; it is null on the
        last.

        Admin key only.
      operationId: list_audit_log_v1_audit_log_get
      parameters:
        - name: resource_type
          in: query
          required: false
          schema:
            anyOf:
              - $ref: '#/components/schemas/AuditResource'
              - type: 'null'
            title: Resource Type
        - name: resource_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                maxLength: 64
              - type: 'null'
            title: Resource Id
        - name: action
          in: query
          required: false
          schema:
            anyOf:
              - $ref: '#/components/schemas/AuditAction'
              - type: 'null'
            title: Action
        - name: request_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: uuid
              - type: 'null'
            description: >-
              Every entry one request wrote: the id its response named in
              `X-TurnCall-Audit-Id`
            title: Request Id
          description: >-
            Every entry one request wrote: the id its response named in
            `X-TurnCall-Audit-Id`
        - name: since
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: date-time
              - type: 'null'
            description: Entries at or after this time
            title: Since
          description: Entries at or after this time
        - name: until
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: date-time
              - type: 'null'
            description: Entries before this time
            title: Until
          description: Entries before this time
        - name: limit
          in: query
          required: false
          schema:
            type: integer
            maximum: 200
            minimum: 1
            default: 50
            title: Limit
        - name: cursor
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: '`next_cursor` from the previous page'
            title: Cursor
          description: '`next_cursor` from the previous page'
        - name: authorization
          in: header
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            title: Authorization
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
                title: Response List Audit Log V1 Audit Log Get
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    AuditResource:
      type: string
      enum:
        - agent
        - credential
        - phone_number
        - api_key
        - project
      title: AuditResource
      description: What an audit log entry is about (#317, ADR-0024).
    AuditAction:
      type: string
      enum:
        - created
        - updated
        - deleted
        - published
        - rolled_back
        - archived
        - knowledge_base_linked
        - knowledge_base_unlinked
        - routing_set
        - routing_cleared
        - revoked
        - limits_set
        - redaction_set
        - retention_set
      title: AuditAction
      description: |-
        What was done to the resource. `archived` is an agent version a
        publish or rollback took out of service; `deleted` is an agent deleted
        through the API (archived too, but asked for).
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError

````

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