How do I install the Ashby full reference skill?

Run npx skillmds@latest add tools-only/ashby-full-reference in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Ashby full reference skill do?

This is the full reference documentation for the Ashby agent connector. It is listed under Coding & Dev Tools on SkillMD.

Is Ashby full reference safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Ashby full reference?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Ashby full reference free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Ashby full reference?

tools-only (@tools-only) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Ashby full reference by tools-only — Agent Skill

Name: Ashby full reference
Author: tools-only

Ashby full reference

This is the full reference documentation for the Ashby agent connector.

Supported entities and actions

The Ashby connector supports the following entities and actions.

Entity	Actions
Candidates	List, Get
Applications	List, Get
Jobs	List, Get
Departments	List, Get
Locations	List, Get
Users	List, Get
Job Postings	List, Get
Sources	List
Archive Reasons	List
Candidate Tags	List
Custom Fields	List
Feedback Form Definitions	List

Candidates

Candidates List

Lists all candidates in the organization

Python SDK

await ashby.candidates.list()

API

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "candidates",
    "action": "list"
}'

Parameters

Parameter Name	Type	Required	Description
`cursor`	`string`	No	Pagination cursor for next page
`limit`	`integer`	No	Maximum number of records to return per page

Records

Field Name	Type	Description
`id`	`string`
`createdAt`	`string \| null`
`updatedAt`	`string \| null`
`name`	`string \| null`
`emailAddresses`	`array \| null`
`phoneNumbers`	`array \| null`
`socialLinks`	`array \| null`
`tags`	`array \| null`
`applicationIds`	`array \| null`
`fileHandles`	`array \| null`
`customFields`	`array \| null`
`profileUrl`	`string \| null`
`source`	`object \| any`
`creditedToUser`	`object \| any`
`timezone`	`string \| null`

Meta

Field Name	Type	Description
`cursor`	`string \| null`
`has_more`	`boolean`

Candidates Get

Get a single candidate by ID

Python SDK

await ashby.candidates.get(
    id="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "candidates",
    "action": "get",
    "params": {
        "id": "<str>"
    }
}'

Parameters

Parameter Name	Type	Required	Description
`id`	`string`	Yes	Candidate ID

Applications

Applications List

Gets all applications in the organization

Python SDK

await ashby.applications.list()

API

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "applications",
    "action": "list"
}'

Parameters

Parameter Name	Type	Required	Description
`cursor`	`string`	No	Pagination cursor for next page
`limit`	`integer`	No	Maximum number of records to return per page

Records

Field Name	Type	Description
`id`	`string`
`createdAt`	`string \| null`
`updatedAt`	`string \| null`
`archivedAt`	`string \| null`
`candidate`	`object \| any`
`status`	`string \| null`
`customFields`	`array \| null`
`currentInterviewStage`	`object \| any`
`source`	`object \| any`
`creditedToUser`	`object \| any`
`archiveReason`	`object \| any`
`job`	`object \| any`
`hiringTeam`	`array \| null`
`appliedViaJobPostingId`	`string \| null`
`submitterClientIp`	`string \| null`
`submitterUserAgent`	`string \| null`

Meta

Field Name	Type	Description
`cursor`	`string \| null`
`has_more`	`boolean`

Applications Get

Get a single application by ID

Python SDK

await ashby.applications.get(
    application_id="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "applications",
    "action": "get",
    "params": {
        "applicationId": "<str>"
    }
}'

Parameters

Parameter Name	Type	Required	Description
`applicationId`	`string`	Yes	Application ID

Jobs

Jobs List

List all open, closed, and archived jobs

Python SDK

await ashby.jobs.list()

API

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "jobs",
    "action": "list"
}'

Parameters

Parameter Name	Type	Required	Description
`cursor`	`string`	No	Pagination cursor for next page
`limit`	`integer`	No	Maximum number of records to return per page

Records

Field Name	Type	Description
`id`	`string`
`title`	`string \| null`
`confidential`	`boolean \| null`
`status`	`string \| null`
`employmentType`	`string \| null`
`locationId`	`string \| null`
`departmentId`	`string \| null`
`defaultInterviewPlanId`	`string \| null`
`interviewPlanIds`	`array \| null`
`jobPostingIds`	`array \| null`
`customFields`	`array \| null`
`hiringTeam`	`array \| null`
`customRequisitionId`	`string \| null`
`brandId`	`string \| null`
`author`	`object \| any`
`createdAt`	`string \| null`
`updatedAt`	`string \| null`
`openedAt`	`string \| null`
`closedAt`	`string \| null`

Meta

Field Name	Type	Description
`cursor`	`string \| null`
`has_more`	`boolean`

Jobs Get

Get a single job by ID

Python SDK

await ashby.jobs.get(
    id="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "jobs",
    "action": "get",
    "params": {
        "id": "<str>"
    }
}'

Parameters

Parameter Name	Type	Required	Description
`id`	`string`	Yes	Job ID

Departments

Departments List

List all departments

Python SDK

await ashby.departments.list()

API

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "departments",
    "action": "list"
}'

Parameters

Parameter Name	Type	Required	Description
`cursor`	`string`	No	Pagination cursor for next page
`limit`	`integer`	No	Maximum number of records to return per page

Records

Field Name	Type	Description
`id`	`string`
`name`	`string \| null`
`externalName`	`string \| null`
`isArchived`	`boolean \| null`
`parentId`	`string \| null`
`createdAt`	`string \| null`
`updatedAt`	`string \| null`
`extraData`	`object \| any`

Meta

Field Name	Type	Description
`cursor`	`string \| null`
`has_more`	`boolean`

Departments Get

Get a single department by ID

Python SDK

await ashby.departments.get(
    department_id="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "departments",
    "action": "get",
    "params": {
        "departmentId": "<str>"
    }
}'

Parameters

Parameter Name	Type	Required	Description
`departmentId`	`string`	Yes	Department ID

Locations

Locations List

List all locations

Python SDK

await ashby.locations.list()

API

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "locations",
    "action": "list"
}'

Parameters

Parameter Name	Type	Required	Description
`cursor`	`string`	No	Pagination cursor for next page
`limit`	`integer`	No	Maximum number of records to return per page

Records

Field Name	Type	Description
`id`	`string`
`name`	`string \| null`
`externalName`	`string \| null`
`isArchived`	`boolean \| null`
`address`	`object \| any`
`isRemote`	`boolean \| null`
`workplaceType`	`string \| null`
`parentLocationId`	`string \| null`
`type`	`string \| null`
`extraData`	`object \| any`

Meta

Field Name	Type	Description
`cursor`	`string \| null`
`has_more`	`boolean`

Locations Get

Get a single location by ID

Python SDK

await ashby.locations.get(
    location_id="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "locations",
    "action": "get",
    "params": {
        "locationId": "<str>"
    }
}'

Parameters

Parameter Name	Type	Required	Description
`locationId`	`string`	Yes	Location ID

Users

Users List

List all users in the organization

Python SDK

await ashby.users.list()

API

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "users",
    "action": "list"
}'

Parameters

Parameter Name	Type	Required	Description
`cursor`	`string`	No	Pagination cursor for next page
`limit`	`integer`	No	Maximum number of records to return per page

Records

Field Name	Type	Description
`id`	`string`
`firstName`	`string \| null`
`lastName`	`string \| null`
`email`	`string \| null`
`globalRole`	`string \| null`
`isEnabled`	`boolean \| null`
`updatedAt`	`string \| null`

Meta

Field Name	Type	Description
`cursor`	`string \| null`
`has_more`	`boolean`

Users Get

Get a single user by ID

Python SDK

await ashby.users.get(
    user_id="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "users",
    "action": "get",
    "params": {
        "userId": "<str>"
    }
}'

Parameters

Parameter Name	Type	Required	Description
`userId`	`string`	Yes	User ID

Job Postings

Job Postings List

List all job postings

Python SDK

await ashby.job_postings.list()

API

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "job_postings",
    "action": "list"
}'

Parameters

Parameter Name	Type	Required	Description
`cursor`	`string`	No	Pagination cursor for next page
`limit`	`integer`	No	Maximum number of records to return per page

Records

Field Name	Type	Description
`id`	`string`
`title`	`string \| null`
`jobId`	`string \| null`
`departmentName`	`string \| null`
`teamName`	`string \| null`
`locationName`	`string \| null`
`locationExternalName`	`string \| null`
`workplaceType`	`string \| null`
`employmentType`	`string \| null`
`isListed`	`boolean \| null`
`publishedDate`	`string \| null`
`applicationDeadline`	`string \| null`
`externalLink`	`string \| null`
`applyLink`	`string \| null`
`locationIds`	`object \| any`
`compensationTierSummary`	`string \| null`
`shouldDisplayCompensationOnJobBoard`	`boolean \| null`
`updatedAt`	`string \| null`

Meta

Field Name	Type	Description
`cursor`	`string \| null`
`has_more`	`boolean`

Job Postings Get

Get a single job posting by ID

Python SDK

await ashby.job_postings.get(
    job_posting_id="<str>"
)

API

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "job_postings",
    "action": "get",
    "params": {
        "jobPostingId": "<str>"
    }
}'

Parameters

Parameter Name	Type	Required	Description
`jobPostingId`	`string`	Yes	Job posting ID

Sources

Sources List

List all candidate sources

Python SDK

await ashby.sources.list()

API

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "sources",
    "action": "list"
}'

Parameters

Parameter Name	Type	Required	Description
`cursor`	`string`	No	Pagination cursor for next page
`limit`	`integer`	No	Maximum number of records to return per page

Records

Field Name	Type	Description
`id`	`string`
`title`	`string \| null`
`isArchived`	`boolean \| null`
`sourceType`	`object \| any`

Meta

Field Name	Type	Description
`cursor`	`string \| null`
`has_more`	`boolean`

Archive Reasons

Archive Reasons List

List all archive reasons

Python SDK

await ashby.archive_reasons.list()

API

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "archive_reasons",
    "action": "list"
}'

Parameters

Parameter Name	Type	Required	Description
`cursor`	`string`	No	Pagination cursor for next page
`limit`	`integer`	No	Maximum number of records to return per page

Records

Field Name	Type	Description
`id`	`string`
`text`	`string \| null`
`reasonType`	`string \| null`
`isArchived`	`boolean \| null`

Meta

Field Name	Type	Description
`cursor`	`string \| null`
`has_more`	`boolean`

Candidate Tags

Candidate Tags List

List all candidate tags

Python SDK

await ashby.candidate_tags.list()

API

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "candidate_tags",
    "action": "list"
}'

Parameters

Parameter Name	Type	Required	Description
`cursor`	`string`	No	Pagination cursor for next page
`limit`	`integer`	No	Maximum number of records to return per page

Records

Field Name	Type	Description
`id`	`string`
`title`	`string \| null`
`isArchived`	`boolean \| null`

Meta

Field Name	Type	Description
`cursor`	`string \| null`
`has_more`	`boolean`

Custom Fields

Custom Fields List

List all custom fields

Python SDK

await ashby.custom_fields.list()

API

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "custom_fields",
    "action": "list"
}'

Parameters

Parameter Name	Type	Required	Description
`cursor`	`string`	No	Pagination cursor for next page
`limit`	`integer`	No	Maximum number of records to return per page

Records

Field Name	Type	Description
`id`	`string`
`title`	`string \| null`
`objectType`	`string \| null`
`isArchived`	`boolean \| null`
`isPrivate`	`boolean \| null`
`fieldType`	`string \| null`

Meta

Field Name	Type	Description
`cursor`	`string \| null`
`has_more`	`boolean`

Feedback Form Definitions

Feedback Form Definitions List

List all feedback form definitions

Python SDK

await ashby.feedback_form_definitions.list()

API

curl --location 'https://api.airbyte.ai/api/v1/integrations/connectors/{your_connector_id}/execute' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {your_auth_token}' \
--data '{
    "entity": "feedback_form_definitions",
    "action": "list"
}'

Parameters

Parameter Name	Type	Required	Description
`cursor`	`string`	No	Pagination cursor for next page
`limit`	`integer`	No	Maximum number of records to return per page

Records

Field Name	Type	Description
`id`	`string`
`organizationId`	`string \| null`
`title`	`string \| null`
`isArchived`	`boolean \| null`
`isDefaultForm`	`boolean \| null`
`formDefinition`	`object \| any`
`interviewId`	`string \| null`

Meta

Field Name	Type	Description
`cursor`	`string \| null`
`has_more`	`boolean`

Ashby full reference

File contents

Ashby full reference

Supported entities and actions

Candidates

Candidates List

Python SDK

API

Parameters

Records

Meta

Candidates Get

Python SDK

API

Parameters

Applications

Applications List

Python SDK

API

Parameters

Records

Meta

Applications Get

Python SDK

API

Parameters

Jobs

Jobs List

Python SDK

API

Parameters

Records

Meta

Jobs Get

Python SDK

API

Parameters

Departments

Departments List

Python SDK

API

Parameters

Records

Meta

Departments Get

Python SDK

API

Parameters

Locations

Locations List

Python SDK

API

Parameters

Records

Meta

Locations Get

Python SDK

API

Parameters

Users

Users List

Python SDK

API

Parameters

Records

Meta

Users Get

Python SDK

API

Parameters

Job Postings

Job Postings List

Python SDK

API

Parameters

Records

Meta

Job Postings Get

Python SDK

API