---
title: "Create audit event"
method: POST
path: "/api/v1/audit-events"
tags: ["Audit"]
---

# Create audit event

`POST /api/v1/audit-events`

## Request

- Base URL: `https://api-docs.busabase.com`
- URL: `https://api-docs.busabase.com/api/v1/audit-events`
- Auth: none declared

## Request body

- object
  - `action` 'record.viewed' | 'change_request.created' | 'change_request.updated' | 'change_request.deleted' | 'change_request.reviewed' | 'change_request.merged' | 'base.created' | 'field.created' | 'doc.created' | 'doc.updated' | 'file.created' | 'skill.created' | 'drive.created' | 'airapp.created' | 'asset.deleted' | 'asset.metadata_updated' | 'asset.text_written' | 'asset.text_marked_none' | 'node.metadata_updated' | 'node.settings_updated' | 'node.agent_prompts_updated' | 'node.purged', required
  - `actorId` string
  - `baseId` string
  - `recordId` string
  - `changeRequestId` string
  - `operationId` string
  - `commitId` string
  - `metadata` object

## Response `200`

Recorded audit event.

- object
  - `id` string, required
  - `action` 'record.viewed' | 'change_request.created' | 'change_request.updated' | 'change_request.deleted' | 'change_request.reviewed' | 'change_request.merged' | 'base.created' | 'field.created' | 'doc.created' | 'doc.updated' | 'file.created' | 'skill.created' | 'drive.created' | 'airapp.created' | 'asset.deleted' | 'asset.metadata_updated' | 'asset.text_written' | 'asset.text_marked_none' | 'node.metadata_updated' | 'node.settings_updated' | 'node.agent_prompts_updated' | 'node.purged', required
  - `actorId` string, required
  - `actor` object
    - `id` string, required
    - `name` string, required
    - `email` string, required
    - `image` string, required
    - `role` string
  - `sourceAttribution` object
    - `displayName` string, required
    - `ownerName` string, required
    - `channel` 'web_ui' | 'browser' | 'openapi' | 'sdk' | 'cli' | 'mcp' | 'skill' | 'webhook' | 'automation' | 'import', required
    - `playbook` object
      - `kind` 'skill' | 'prompt', required
      - `accessible` boolean, required
      - `nodeId` string, required
      - `key` string, required
      - `nodeType` string, required
      - `nodeSlug` string, required
      - `label` string, required
  - `baseId` string, required
  - `recordId` string, required
  - `changeRequestId` string, required
  - `operationId` string, required
  - `commitId` string, required
  - `metadata` object, required
  - `createdAt` string, required

---

[API](https://skmtc.dev/busabase/apis/busabase-api.md) · [All operations](https://skmtc.dev/busabase/apis/busabase-api/llms.txt) · [OpenAPI document](https://skmtc.dev/busabase/apis/busabase-api/revisions/bc6a7d5ff4c1?raw)