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

# Audit

> Query audit trails across the workspace or a single project.

Audit endpoints let you review actions across the workspace, with optional filters for users, actions, artifact types, and time ranges.

## Basic request and response

Query the workspace audit log with `GET /api/v1/app/audit`.

```bash theme={null}
curl "https://{BASE_URL}/api/v1/app/audit?start_date=1738291200&end_date=1738972800&include=User&artifact_types=File,URL&page=1&page_size=50" \
  -H "Authorization: Bearer {API_TOKEN}"
  -H "x-org: {org_slug}"
```

<Accordion title="Example response">
  ```json theme={null}
  []
  ```
</Accordion>

## Project audit log

```bash theme={null}
curl "https://{BASE_URL}/api/v1/app/project/{projectID}/audit?start_date=1738291200&end_date=1738972800&artifact_types=File,URL&page=1&page_size=50" \
  -H "Authorization: Bearer {API_TOKEN}"
  -H "x-org: {org_slug}"
```

<Accordion title="Example response">
  ```json theme={null}
  []
  ```
</Accordion>

## Query parameters

* `start_date`, `end_date`: Unix timestamps for the time window.
* `include`: Optional entity filter (for example `User`).
* `artifact_types`: Optional comma-separated artifact type filter.
* `page`, `page_size`: Pagination controls.

## Errors and edge cases

* **400**: invalid time range or filters.
* **403**: insufficient permissions.