---
title: "List user actions and configuration changes within this organization."
method: GET
path: "/organization/audit_logs"
tags: ["Audit Logs"]
---

# List user actions and configuration changes within this organization.

`GET /organization/audit_logs`

## Query parameters

- `effective_at` object
  - `gt` integer — Return only events whose `effective_at` (Unix seconds) is greater than this value.
  - `gte` integer — Return only events whose `effective_at` (Unix seconds) is greater than or equal to this value.
  - `lt` integer — Return only events whose `effective_at` (Unix seconds) is less than this value.
  - `lte` integer — Return only events whose `effective_at` (Unix seconds) is less than or equal to this value.
- `project_ids[]` string[]
- `event_types[]` AuditLogEventType[]
- `actor_ids[]` string[]
- `actor_emails[]` string[]
- `resource_ids[]` string[]
- `limit` integer
- `after` string
- `before` string

## Response `200`

Audit logs listed successfully.

- ListAuditLogsResponse
  - `object` 'list', required
  - `data` AuditLog[], required
    - `id` string, required — The ID of this log.
    - `type` 'api_key.created' | 'api_key.updated' | 'api_key.deleted' | 'invite.sent' | 'invite.accepted' | 'invite.deleted' | 'login.succeeded' | 'login.failed' | 'logout.succeeded' | 'logout.failed' | 'organization.updated' | 'project.created' | 'project.updated' | 'project.archived' | 'service_account.created' | 'service_account.updated' | 'service_account.deleted' | 'user.added' | 'user.updated' | 'user.deleted', required — The event type.
    - `effective_at` integer, required — The Unix timestamp (in seconds) of the event.
    - `project` object — The project that the action was scoped to. Absent for actions not scoped to projects.
      - `id` string — The project ID.
      - `name` string — The project title.
    - `actor` AuditLogActor, required — The actor who performed the audit logged action.
      - `type` 'session' | 'api_key' — The type of actor. Is either `session` or `api_key`.
      - `session` AuditLogActorSession — The session in which the audit logged action was performed.
        - `user` AuditLogActorUser — The user who performed the audit logged action.
          - `id` string — The user id.
          - `email` string — The user email.
        - `ip_address` string — The IP address from which the action was performed.
      - `api_key` AuditLogActorApiKey — The API Key used to perform the audit logged action.
        - `id` string — The tracking id of the API key.
        - `type` 'user' | 'service_account' — The type of API key. Can be either `user` or `service_account`.
        - `user` AuditLogActorUser — The user who performed the audit logged action.
          - `id` string — The user id.
          - `email` string — The user email.
        - `service_account` AuditLogActorServiceAccount — The service account that performed the audit logged action.
          - `id` string — The service account id.
    - `api_key.created` object — The details for events with this `type`.
      - `id` string — The tracking ID of the API key.
      - `data` object — The payload used to create the API key.
        - `scopes` string[] — A list of scopes allowed for the API key, e.g. `["api.model.request"]`
    - `api_key.updated` object — The details for events with this `type`.
      - `id` string — The tracking ID of the API key.
      - `changes_requested` object — The payload used to update the API key.
        - `scopes` string[] — A list of scopes allowed for the API key, e.g. `["api.model.request"]`
    - `api_key.deleted` object — The details for events with this `type`.
      - `id` string — The tracking ID of the API key.
    - `invite.sent` object — The details for events with this `type`.
      - `id` string — The ID of the invite.
      - `data` object — The payload used to create the invite.
        - `email` string — The email invited to the organization.
        - `role` string — The role the email was invited to be. Is either `owner` or `member`.
    - `invite.accepted` object — The details for events with this `type`.
      - `id` string — The ID of the invite.
    - `invite.deleted` object — The details for events with this `type`.
      - `id` string — The ID of the invite.
    - `login.failed` object — The details for events with this `type`.
      - `error_code` string — The error code of the failure.
      - `error_message` string — The error message of the failure.
    - `logout.failed` object — The details for events with this `type`.
      - `error_code` string — The error code of the failure.
      - `error_message` string — The error message of the failure.
    - `organization.updated` object — The details for events with this `type`.
      - `id` string — The organization ID.
      - `changes_requested` object — The payload used to update the organization settings.
        - `title` string — The organization title.
        - `description` string — The organization description.
        - `name` string — The organization name.
        - `settings` object
          - `threads_ui_visibility` string — Visibility of the threads page which shows messages created with the Assistants API and Playground. One of `ANY_ROLE`, `OWNERS`, or `NONE`.
          - `usage_dashboard_visibility` string — Visibility of the usage dashboard which shows activity and costs for your organization. One of `ANY_ROLE` or `OWNERS`.
    - `project.created` object — The details for events with this `type`.
      - `id` string — The project ID.
      - `data` object — The payload used to create the project.
        - `name` string — The project name.
        - `title` string — The title of the project as seen on the dashboard.
    - `project.updated` object — The details for events with this `type`.
      - `id` string — The project ID.
      - `changes_requested` object — The payload used to update the project.
        - `title` string — The title of the project as seen on the dashboard.
    - `project.archived` object — The details for events with this `type`.
      - `id` string — The project ID.
    - `service_account.created` object — The details for events with this `type`.
      - `id` string — The service account ID.
      - `data` object — The payload used to create the service account.
        - `role` string — The role of the service account. Is either `owner` or `member`.
    - `service_account.updated` object — The details for events with this `type`.
      - `id` string — The service account ID.
      - `changes_requested` object — The payload used to updated the service account.
        - `role` string — The role of the service account. Is either `owner` or `member`.
    - `service_account.deleted` object — The details for events with this `type`.
      - `id` string — The service account ID.
    - `user.added` object — The details for events with this `type`.
      - `id` string — The user ID.
      - `data` object — The payload used to add the user to the project.
        - `role` string — The role of the user. Is either `owner` or `member`.
    - `user.updated` object — The details for events with this `type`.
      - `id` string — The project ID.
      - `changes_requested` object — The payload used to update the user.
        - `role` string — The role of the user. Is either `owner` or `member`.
    - `user.deleted` object — The details for events with this `type`.
      - `id` string — The user ID.
  - `first_id` string, required
  - `last_id` string, required
  - `has_more` boolean, required

---

[API](https://skmtc.net/omnistack-sh/apis/openai-api.md) · [All operations](https://skmtc.net/omnistack-sh/apis/openai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/omnistack-sh/openai-api/versions/a127ad1d97cb/schema)