Audit Log Vocabulary

The auditLog.list endpoint returns audit entries and accepts filters documented here. This page is the source of truth for targetTypes, categories, and actor.type values.

Forward compatibility: New category or target.type values may appear in responses as we add auditing — treat unknown values as valid. Request filters (targetTypes, categories) must use values from this page; unrecognized filter values return 400.

Each category belongs to exactly one target type. The tables below are grouped by target type so you can see which categories apply to each.

Actor types

Returned on each entry as actor.type. Filter by actor using actorIds in the request (the actor's id when present, not the type string).

`actor.type`	Description
`User`	An action performed by a person signed in to Ashby. `actor.id` is their user id.
`ApiUser`	An action performed with an API key. `actor.id` is the service account backing the key.
`Automation`	An action performed by an automation or integration. `actor.id` may be null or a non-user identifier.
`Support`	An action performed by Ashby Support acting on your organization. `actor.id` is the support user's id.
`Other`	An actor that could not be classified. Almost all entries with this value were recorded before API key and Ashby Support actions were distinguished.

How filters combine

Parameters	Combination
`actorIds`, `targetIds`	AND with each other and with activity filters — an entry must match every supplied dimension.
`targetTypes`, `categories`	OR with each other — an entry matching either list is included. To narrow to one job's status changes, use `targetIds` plus `categories`, not `targetTypes` + `categories` alone.
Empty arrays (`[]`)	Ignored — same as omitting the parameter.
`actorIds`, `targetIds`, `targetTypes`, `categories`	Each array may contain at most 100 ids or values; longer arrays are rejected with a `400`.

Pagination: Pass nextCursor only together with the same startDate, endDate, and filters as the request that produced it.

Date range examples

All dates are ISO 8601 interpreted as UTC.

Request	Window
`{}` (no dates)	Last 24 hours ending now
`endDate` only	24 hours ending at `endDate`
`startDate` only	24 hours starting at `startDate` (ends at `startDate` + 24h, not until now)
Both `startDate` and `endDate`	Explicit span (max 18 months)

Example — entries from 1 June 00:00 UTC through 7 June 00:00 UTC:

{
  "startDate": "2026-06-01T00:00:00.000Z",
  "endDate": "2026-06-07T00:00:00.000Z",
  "limit": 100
}

Filter vocabulary

actorIds, targetIds, targetTypes, categories — each array accepts at most 100 items.
targetTypes — snake_case object type (see table below). Unrecognized values → 400.
categories — PascalCase action category (see tables below). Unrecognized values → 400.

Target types

`targetType`	Description
`agency`	An external recruiting agency that can access jobs and teams.
`ai_interviewer`	An AI Interviewer configuration used to conduct screening interviews.
`ai_screening_interview`	An AI interview for a candidate's application.
`app_user`	A person with a login to your Ashby organization.
`location`	A location used to organize jobs, candidates, and interview scheduling.
`security_role`	An access role that defines a set of permissions assignable to users.
`team`	A team or department used to organize jobs, permissions, and reporting.
`job_posting`	The job posting created for a job within your ATS.
`job`	A job set up within your ATS.
`candidate`	Candidates in Ashby.
`application`	A candidate's record on a specific job.
`dashboard`	A saved collection of reports and charts assembled into a single view.
`api_key`	An organization API key for the Ashby public API.
`bulk_data_import`	A bulk data import operation.
`internal_job_board`	A private job board associated with an organization brand.
`offer`	An offer extended to a candidate for a job.
`organization_brand`	A branded public job board.
`organization_setting`	Organization-wide configuration and integration settings.
`scheduled_dashboard`	A configured schedule that emails dashboard reports to recipients on a recurring cadence.
`survey_form_definition`	A consent survey form definition.
`webhook`	An organization webhook configured to receive event notifications.

Categories

Agency (`agency`)

`category`	Description
`AgencyArchived`	An agency was archived.
`AgencyCreated`	An agency was created.
`AgencyJobAccessGranted`	An agency was granted access to a job.
`AgencyJobAccessRevoked`	An agency's access to a job was revoked.
`AgencyNameChanged`	An agency's name was changed.
`AgencyRestored`	An agency was restored.
`AgencySourceChanged`	An agency's source was changed.
`AgencyTeamAccessGranted`	An agency was granted access to a team.
`AgencyTeamAccessRevoked`	An agency's access to a team was revoked.
`AgencyUserAdded`	A user was added to an agency.
`AgencyUserRemoved`	A user was removed from an agency.

AI Interviewer (`ai_interviewer`)

`category`	Description
`AiInterviewerArchived`	An AI Interviewer was archived.
`AiInterviewerUnarchived`	An AI Interviewer was restored from the archive.
`AiInterviewerPaused`	An AI Interviewer was paused.
`AiInterviewerUnpaused`	An AI Interviewer was unpaused.
`AiInterviewerVersionPublished`	A version of an AI Interviewer was published.
`AiInterviewerVersionUnpublished`	A version of an AI Interviewer was unpublished.

AI Interview (`ai_screening_interview`)

`category`	Description
`AiScreeningInterviewActivityAdded`	An AI interview was added to an application.
`AiScreeningInterviewActivityRemoved`	An AI interview was removed from an application.
`AiScreeningInterviewReset`	An AI interview was reset.

User (`app_user`)

`category`	Description
`UserActivated`	A user account was activated.
`UserDeactivated`	A user account was deactivated.
`UserGlobalRole`	A user's global role was changed.
`UserAdminPermissions`	A user's admin permissions were changed.
`UserAccess`	A user's job/team access (or its access role) was granted, updated, or revoked.
`UserCandidateLinked`	A candidate (and optionally an application) was linked to a user's employee record.
`UserCandidateUnlinked`	A candidate was unlinked from a user's employee record.
`UserLoggedIn`	A user logged into their Ashby account.
`UserLoggedOut`	A user logged out of their Ashby account.

Location (`location`)

`category`	Description
`LocationCreated`	A location was created.
`LocationDetails`	A location's details were changed.
`LocationArchived`	A location was archived.
`LocationUnarchived`	A location was restored from the archive.
`LocationReparent`	A location's parent in the hierarchy was changed.

Access Role (`security_role`)

`category`	Description
`SecurityRoleCreated`	An access role was created.
`SecurityRoleUpdated`	An access role's display properties or permissions were updated.
`SecurityRoleArchived`	An access role was archived.
`SecurityRoleRestored`	An access role was restored from the archive.
`SecurityRoleDeleted`	An access role was deleted.

Team (`team`)

`category`	Description
`TeamCreated`	A team or department was created.
`TeamNameChanged`	A team or department's name was changed.
`TeamCandidateFacingNameChanged`	A team or department's candidate-facing name was changed.
`TeamParentChanged`	A team or department's parent in the hierarchy was changed.
`TeamArchived`	A team or department was archived.
`TeamUnarchived`	A team or department was restored from the archive.

Job Posting (`job_posting`)

`category`	Description
`JobPostingCompensationTierCreated`	A compensation tier was added to a job posting.
`JobPostingCompensationTierUpdated`	A job posting's compensation tier was updated.
`JobPostingCreated`	A job posting was created.
`JobPostingDeleted`	A job posting was deleted.
`JobPostingPublished`	A job posting was published.
`JobPostingUnpublished`	A job posting was unpublished.
`JobPostingTitleUpdated`	A job posting's title was updated.
`JobPostingDescriptionUpdated`	A job posting's description was edited.

Job (`job`)

`category`	Description
`JobTeamChanged`	A job's team was changed.
`JobTeamRemoved`	A job's team was removed.
`JobStatusChanged`	A job's status was changed.
`JobLocationUpdated`	A job's location was updated.
`JobHiringTeamChanged`	A job's hiring team was changed.
`JobCreated`	A job was created.
`JobTitleChanged`	A job's title was changed.
`JobConfidentialChanged`	A job's confidential setting was changed.
`JobOpeningAdded`	A job was added to an opening.
`JobOpeningRemoved`	A job was removed from an opening.
`JobFraudDetectionSettingChanged`	A job's fraud detection setting was changed.
`JobBrandChanged`	A job's brand was changed.
`JobEmploymentTypeChanged`	A job's employment type was changed.
`JobApplicationConfirmationEmailTemplateChanged`	A job's application confirmation email template was changed.
`JobCustomRequisitionIdChanged`	A job's custom requisition ID was changed.

Candidate (`candidate`)

`category`	Description
`CandidateDataExported`	A candidate's data was exported.
`CandidateCreated`	A candidate was created.
`CandidateSourceUpdated`	A candidate's source was updated.
`CandidateDeletionRequested`	A candidate's deletion was requested.
`CandidateDeletionRequestCancelled`	A pending candidate deletion was cancelled.
`CandidateDeleted`	A candidate's data was permanently deleted.
`CandidateMerged`	A candidate was merged into another candidate.
`CandidateAnonymized`	A candidate was anonymized.
`CandidateTagAdded`	A tag was added to a candidate.
`CandidateTagRemoved`	A tag was removed from a candidate.
`CandidateDoNotContactUpdated`	A candidate's do-not-contact setting was updated.

Job Consideration (`application`)

`category`	Description
`ApplicationCreated`	An application was created.
`ApplicationStageChanged`	An application's interview stage was changed.
`ApplicationHired`	An application was hired.
`ApplicationArchived`	An application was archived.
`ApplicationTransferred`	An application was transferred to another job.
`ApplicationUnarchived`	An application was unarchived.
`ApplicationSourceUpdated`	An application's source was changed.
`ApplicationCreditedToUpdated`	An application's credited-to recruiter was changed.
`ApplicationDeleted`	An application was permanently deleted.

Dashboard (`dashboard`)

`category`	Description
`DashboardOpened`	A dashboard was opened.
`DashboardDataExported`	A dashboard's data was exported.

API Key (`api_key`)

`category`	Description
`ApiKeyCreated`	An API key was created.
`ApiKeyDeactivated`	An API key was deactivated.
`ApiKeyDefaultSourceUpdated`	An API key's default source was updated.
`ApiKeyPermissionsUpdated`	An API key's permissions were updated.
`ApiKeyTitleUpdated`	An API key's title was updated.

Bulk Data Import (`bulk_data_import`)

`category`	Description
`BulkDataImportStarted`	A bulk data import was started.
`BulkDataImportCompleted`	A bulk data import completed.

Internal Job Board (`internal_job_board`)

`category`	Description
`InternalJobBoardAvailabilityChanged`	An internal job board's availability was changed.
`InternalJobBoardMessagingUpdated`	An internal job board's employee-facing messaging was updated.

Offer (`offer`)

`category`	Description
`OfferCreated`	An offer was created.
`OfferUpdated`	An offer was updated.
`OfferExtended`	An offer was sent to the candidate.
`OfferAccepted`	An offer was accepted.
`OfferDeclined`	An offer was declined.
`OfferCancelled`	An offer was cancelled — directly by a user, because an approver rejected its approval, or because the candidate's application was moved to the Hired stage.
`OfferResponseUpdated`	A candidate's offer response was corrected after the offer process completed.
`OfferDecisionDateUpdated`	The date a candidate's offer response was recorded on was corrected.
`OfferApprovalProcessStarted`	An offer's approval process was started.
`OfferApprovalStepApproved`	An approver approved a step of an offer's approval process.
`OfferApprovalStepRejected`	An approver rejected a step of an offer's approval process.
`OfferApprovalProcessCompleted`	An offer's approval process was fully approved and completed.
`OfferApprovalProcessCancelled`	An offer's approval process was cancelled, typically because a new offer version or approval process superseded it.
`OfferApprovalProcessOverridden`	An admin overrode an offer's approval process, force-approving it without the remaining approvals.
`OfferApprovalSingleApproverOverridden`	An admin approved a step of an offer's approval process on another approver's behalf.

Job Board (`organization_brand`)

`category`	Description
`BrandCreated`	A job board brand was created.
`JobBoardUrlChanged`	A job board's public URL was changed.
`JobBoardAvailabilityChanged`	A public job board's availability was changed.
`JobBoardSpamProtectionChanged`	A job board's application spam protection was changed.
`JobBoardCustomCssChanged`	A job board's custom CSS or CSS allowlist was changed.
`JobBoardEmbeddingChanged`	A job board's embedding settings were changed.
`NoReplyEmailChanged`	A job board's no-reply email settings were changed.
`JobBoardCookieConsentChanged`	A job board's cookie consent setting was changed.
`JobBoardPostingBackUrlChanged`	A job board's posting back URL was changed.
`JobBoardIdentityUpdated`	A job board's brand name or public website was updated.
`JobBoardAppearanceUpdated`	A job board's logos or social preview settings were updated.
`JobBoardDisplayUpdated`	A job board's display settings were updated.
`JobBoardMessagingUpdated`	A job board's candidate-facing messaging was updated.

Organization Setting (`organization_setting`)

`category`	Description
`OptInFeatureEnabled`	An opt-in feature was enabled for the organization.
`OptInFeatureDisabled`	An opt-in feature was disabled for the organization.
`AiInterviewerTermsUpdated`	An AI Interviewer's candidate-facing terms & conditions were updated.
`InternalJobBoardDisplayUpdated`	An internal job board's display settings were updated.

Scheduled Dashboard (`scheduled_dashboard`)

`category`	Description
`ScheduledDashboardCreated`	A scheduled dashboard was created.
`ScheduledDashboardEnabled`	A scheduled dashboard was enabled and will send on its next scheduled run.
`ScheduledDashboardDisabled`	A scheduled dashboard was disabled and will no longer send on its schedule.
`ScheduledDashboardArchived`	A scheduled dashboard was archived.
`ScheduledDashboardForceTriggered`	A scheduled dashboard was manually triggered to send outside of its schedule.
`ScheduledDashboardRecipientsChanged`	A scheduled dashboard's delivery recipients were changed.
`ScheduledDashboardScheduleChanged`	A scheduled dashboard's send cadence was changed.
`ScheduledDashboardFiltersChanged`	A scheduled dashboard's dashboard filters were changed.
`ScheduledDashboardFileFormatChanged`	A scheduled dashboard's attached file formats (CSV, PDF) were changed.
`ScheduledDashboardSendFromChanged`	A scheduled dashboard's sender (the generating user or Ashby) was changed.
`ScheduledDashboardSendAsChanged`	A scheduled dashboard's delivery mode (individual emails or a single group email) was changed.
`ScheduledDashboardSubjectChanged`	A scheduled dashboard's email subject was changed.

Survey Form (`survey_form_definition`)

`category`	Description
`ConsentSurveyFormCreated`	A consent survey form was created.
`ConsentSurveyFormArchived`	A consent survey form was archived.
`ConsentSurveyFormUnarchived`	A consent survey form was unarchived.
`ConsentSurveyFormAutomationEnabled`	Automation was enabled for a consent survey form.
`ConsentSurveyFormAutomationDisabled`	Automation was disabled for a consent survey form.
`ConsentSurveyFormDraftAutomationActivated`	A draft automation configuration was activated for a consent survey form.
`ConsentSurveyFormJobsPagesSettingsUpdated`	A consent survey form's jobs-pages settings were updated.
`ConsentSurveyFormDisplayPropertiesUpdated`	A consent survey form's display properties were updated.

Webhook (`webhook`)

`category`	Description
`WebhookSettingCreated`	A webhook was created.
`WebhookSettingUpdated`	A webhook's title, request URL, or auth provider was updated.
`WebhookSettingDeleted`	A webhook was deleted.
`WebhookSettingEnabled`	A webhook was enabled.
`WebhookSettingDisabled`	A webhook was disabled.
`WebhookSettingSigningSecretRotated`	A webhook's signing secret was rotated.
`WebhookSettingCustomHeaderAdded`	A custom header was added to a webhook.
`WebhookSettingCustomHeaderRemoved`	A custom header was removed from a webhook.
`WebhookSettingCustomHeaderUpdated`	A custom header's value was updated on a webhook.

Actor types

How filters combine

Date range examples

Filter vocabulary

Target types

Categories

Agency (agency)

AI Interviewer (ai_interviewer)

AI Interview (ai_screening_interview)

User (app_user)

Location (location)

Access Role (security_role)

Team (team)

Job Posting (job_posting)

Job (job)

Candidate (candidate)

Job Consideration (application)

Dashboard (dashboard)

API Key (api_key)

Bulk Data Import (bulk_data_import)

Internal Job Board (internal_job_board)

Offer (offer)

Job Board (organization_brand)

Organization Setting (organization_setting)

Scheduled Dashboard (scheduled_dashboard)

Survey Form (survey_form_definition)

Webhook (webhook)