Guides

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.typeDescription
UserAn action performed by a person signed in to Ashby. actor.id is their user id.
AutomationAn action performed by an automation or integration. actor.id may be null or a non-user identifier.
OtherAny other actor kind e.g API key, actor.id may be null.

How filters combine

ParametersCombination
actorIds, targetIdsAND with each other and with activity filters — an entry must match every supplied dimension.
targetTypes, categoriesOR 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, categoriesEach 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.

RequestWindow
{} (no dates)Last 24 hours ending now
endDate only24 hours ending at endDate
startDate only24 hours starting at startDate (ends at startDate + 24h, not until now)
Both startDate and endDateExplicit 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

targetTypeDescription
ai_interviewerAn AI Interviewer configuration used to conduct screening interviews.
ai_screening_interviewAn AI-conducted screening interview for a candidate's application.
app_userA person with a login to your Ashby organization.
locationA location used to organize jobs, candidates, and interview scheduling.
security_roleAn access role that defines a set of permissions assignable to users.
job_postingThe job posting created for a job within your ATS.
jobA job set up within your ATS.
api_keyAn organization API key for the Ashby public API.
survey_form_definitionA consent survey form definition.

Categories

AI Interviewer (ai_interviewer)

categoryDescription
AiInterviewerArchivedAn AI Interviewer was archived.
AiInterviewerUnarchivedAn AI Interviewer was restored from the archive.
AiInterviewerPausedAn AI Interviewer was paused.
AiInterviewerUnpausedAn AI Interviewer was unpaused.
AiInterviewerVersionPublishedA version of an AI Interviewer was published.
AiInterviewerVersionUnpublishedA version of an AI Interviewer was unpublished.

AI Screening Interview (ai_screening_interview)

categoryDescription
AiScreeningInterviewActivityAddedAn AI screening interview was added to an application.
AiScreeningInterviewActivityRemovedAn AI screening interview was removed from an application.
AiScreeningInterviewResetAn AI screening interview was reset.

User (app_user)

categoryDescription
UserActivatedA user account was activated.
UserDeactivatedA user account was deactivated.
UserGlobalRoleA user's global role was changed.
UserAdminPermissionsA user's admin permissions were changed.
UserAccessA user's job/team access (or its access role) was granted, updated, or revoked.
UserLoggedInA user logged into their Ashby account.
UserLoggedOutA user logged out of their Ashby account.

Location (location)

categoryDescription
LocationCreatedA location was created.
LocationDetailsA location's details were changed.
LocationArchivedA location was archived.
LocationUnarchivedA location was restored from the archive.
LocationReparentA location's parent in the hierarchy was changed.

Access Role (security_role)

categoryDescription
SecurityRoleCreatedAn access role was created.
SecurityRoleUpdatedAn access role's display properties or permissions were updated.
SecurityRoleArchivedAn access role was archived.
SecurityRoleRestoredAn access role was restored from the archive.
SecurityRoleDeletedAn access role was deleted.

Job Posting (job_posting)

categoryDescription
JobPostingCompensationTierCreatedA compensation tier was added to a job posting.
JobPostingCompensationTierUpdatedA job posting's compensation tier was updated.
JobPostingCreatedA job posting was created.
JobPostingDeletedA job posting was deleted.
JobPostingPublishedA job posting was published.
JobPostingUnpublishedA job posting was unpublished.
JobPostingTitleUpdatedA job posting's title was updated.

Job (job)

categoryDescription
JobTeamChangedA job's team was changed.
JobTeamRemovedA job's team was removed.
JobStatusChangedA job's status was changed.
JobLocationUpdatedA job's location was updated.
JobHiringTeamChangedA job's hiring team was changed.

API Key (api_key)

categoryDescription
ApiKeyCreatedAn API key was created.
ApiKeyDeactivatedAn API key was deactivated.
ApiKeyDefaultSourceUpdatedAn API key's default source was updated.
ApiKeyPermissionsUpdatedAn API key's permissions were updated.
ApiKeyTitleUpdatedAn API key's title was updated.

Survey Form (survey_form_definition)

categoryDescription
ConsentSurveyFormCreatedA consent survey form was created.
ConsentSurveyFormArchivedA consent survey form was archived.
ConsentSurveyFormUnarchivedA consent survey form was unarchived.
ConsentSurveyFormAutomationEnabledAutomation was enabled for a consent survey form.
ConsentSurveyFormAutomationDisabledAutomation was disabled for a consent survey form.
ConsentSurveyFormDraftAutomationActivatedA draft automation configuration was activated for a consent survey form.
ConsentSurveyFormJobsPagesSettingsUpdatedA consent survey form's jobs-pages settings were updated.
ConsentSurveyFormDisplayPropertiesUpdatedA consent survey form's display properties were updated.