This connector is optimized for AI agents. For the data replication connector, see Ashby .
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 , Context Store Search Applications List , Get , Context Store Search Jobs List , Get , Context Store Search Departments List , Get Locations List , Get Users List , Get , Context Store Search Job Postings List , Get , Context Store Search 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 cursorstringNo Pagination cursor for next page limitintegerNo Maximum number of records to return per page
Response Schema Records Field Name Type Description idstringcreatedAtstring | nullupdatedAtstring | nullnamestring | nullemailAddressesarray | nullphoneNumbersarray | nullsocialLinksarray | nulltagsarray | nullapplicationIdsarray | nullfileHandlesarray | nullcustomFieldsarray | nullprofileUrlstring | nullsourceobject | anycreditedToUserobject | anytimezonestring | null
Field Name Type Description cursorstring | nullhas_moreboolean
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 idstringYes Candidate ID
Candidates Context Store Search
Search and filter candidates records powered by Airbyte's data sync. This often provides additional fields and operators beyond what the API natively supports, making it easier to narrow down results before performing further operations. Only available in hosted mode.
Python SDK
await ashby . candidates . context_store_search ( query = { "filter" : { "eq" : { "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": "context_store_search", "params": { "query": {"filter": {"eq": {"id": "<str>"}}} } }'
Parameters
Parameter Name Type Required Description queryobjectYes Filter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or query.filterobjectNo Filter conditions query.sortarrayNo Sort conditions limitintegerNo Maximum results to return (default 1000) cursorstringNo Pagination cursor from previous response's meta.cursor fieldsarrayNo Field paths to include in results
Searchable Fields
Field Name Type Description idstringUnique identifier for the candidate namestringFull name of the candidate companystringCandidate's current company positionstringCandidate's current position or title schoolstringSchool associated with the candidate's education
Response Schema Field Name Type Description dataarrayList of matching records metaobjectPagination metadata meta.has_morebooleanWhether additional pages are available meta.cursorstring | nullCursor for next page of results meta.took_msnumber | nullQuery execution time in milliseconds data[].idstringUnique identifier for the candidate data[].namestringFull name of the candidate data[].companystringCandidate's current company data[].positionstringCandidate's current position or title data[].schoolstringSchool associated with the candidate's education
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 cursorstringNo Pagination cursor for next page limitintegerNo Maximum number of records to return per page
Response Schema Records Field Name Type Description idstringcreatedAtstring | nullupdatedAtstring | nullarchivedAtstring | nullcandidateobject | anystatusstring | nullcustomFieldsarray | nullcurrentInterviewStageobject | anysourceobject | anycreditedToUserobject | anyarchiveReasonobject | anyjobobject | anyhiringTeamarray | nullappliedViaJobPostingIdstring | nullsubmitterClientIpstring | nullsubmitterUserAgentstring | null
Field Name Type Description cursorstring | nullhas_moreboolean
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 applicationIdstringYes Application ID
Applications Context Store Search
Search and filter applications records powered by Airbyte's data sync. This often provides additional fields and operators beyond what the API natively supports, making it easier to narrow down results before performing further operations. Only available in hosted mode.
Python SDK
await ashby . applications . context_store_search ( query = { "filter" : { "eq" : { "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": "context_store_search", "params": { "query": {"filter": {"eq": {"id": "<str>"}}} } }'
Parameters
Parameter Name Type Required Description queryobjectYes Filter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or query.filterobjectNo Filter conditions query.sortarrayNo Sort conditions limitintegerNo Maximum results to return (default 1000) cursorstringNo Pagination cursor from previous response's meta.cursor fieldsarrayNo Field paths to include in results
Searchable Fields
Field Name Type Description idstringUnique identifier for the application statusstringCurrent application status (e.g. active, archived, hired) archiveReasonstringReason the application was archived, if applicable createdAtstringTimestamp when the application was created, in ISO 8601 format updatedAtstringTimestamp when the application was last updated, in ISO 8601 format
Response Schema Field Name Type Description dataarrayList of matching records metaobjectPagination metadata meta.has_morebooleanWhether additional pages are available meta.cursorstring | nullCursor for next page of results meta.took_msnumber | nullQuery execution time in milliseconds data[].idstringUnique identifier for the application data[].statusstringCurrent application status (e.g. active, archived, hired) data[].archiveReasonstringReason the application was archived, if applicable data[].createdAtstringTimestamp when the application was created, in ISO 8601 format data[].updatedAtstringTimestamp when the application was last updated, in ISO 8601 format
Jobs
Jobs List
List all open, closed, and archived jobs
Python SDK
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 cursorstringNo Pagination cursor for next page limitintegerNo Maximum number of records to return per page
Response Schema Records Field Name Type Description idstringtitlestring | nullconfidentialboolean | nullstatusstring | nullemploymentTypestring | nulllocationIdstring | nulldepartmentIdstring | nulldefaultInterviewPlanIdstring | nullinterviewPlanIdsarray | nulljobPostingIdsarray | nullcustomFieldsarray | nullhiringTeamarray | nullcustomRequisitionIdstring | nullbrandIdstring | nullauthorobject | anycreatedAtstring | nullupdatedAtstring | nullopenedAtstring | nullclosedAtstring | null
Field Name Type Description cursorstring | nullhas_moreboolean
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 idstringYes Job ID
Jobs Context Store Search
Search and filter jobs records powered by Airbyte's data sync. This often provides additional fields and operators beyond what the API natively supports, making it easier to narrow down results before performing further operations. Only available in hosted mode.
Python SDK
await ashby . jobs . context_store_search ( query = { "filter" : { "eq" : { "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": "context_store_search", "params": { "query": {"filter": {"eq": {"id": "<str>"}}} } }'
Parameters
Parameter Name Type Required Description queryobjectYes Filter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or query.filterobjectNo Filter conditions query.sortarrayNo Sort conditions limitintegerNo Maximum results to return (default 1000) cursorstringNo Pagination cursor from previous response's meta.cursor fieldsarrayNo Field paths to include in results
Searchable Fields
Field Name Type Description idstringUnique identifier for the job titlestringTitle of the job statusstringCurrent status of the job (e.g. open, closed, draft) departmentIdstringIdentifier of the department the job belongs to locationIdstringIdentifier of the primary location of the job
Response Schema Field Name Type Description dataarrayList of matching records metaobjectPagination metadata meta.has_morebooleanWhether additional pages are available meta.cursorstring | nullCursor for next page of results meta.took_msnumber | nullQuery execution time in milliseconds data[].idstringUnique identifier for the job data[].titlestringTitle of the job data[].statusstringCurrent status of the job (e.g. open, closed, draft) data[].departmentIdstringIdentifier of the department the job belongs to data[].locationIdstringIdentifier of the primary location of the job
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 cursorstringNo Pagination cursor for next page limitintegerNo Maximum number of records to return per page
Response Schema Records Field Name Type Description idstringnamestring | nullexternalNamestring | nullisArchivedboolean | nullparentIdstring | nullcreatedAtstring | nullupdatedAtstring | nullextraDataobject | any
Field Name Type Description cursorstring | nullhas_moreboolean
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 departmentIdstringYes 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 cursorstringNo Pagination cursor for next page limitintegerNo Maximum number of records to return per page
Response Schema Records Field Name Type Description idstringnamestring | nullexternalNamestring | nullisArchivedboolean | nulladdressobject | anyisRemoteboolean | nullworkplaceTypestring | nullparentLocationIdstring | nulltypestring | nullextraDataobject | any
Field Name Type Description cursorstring | nullhas_moreboolean
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 locationIdstringYes Location ID
Users
Users List
List all users in the organization
Python SDK
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 cursorstringNo Pagination cursor for next page limitintegerNo Maximum number of records to return per page
Response Schema Records Field Name Type Description idstringfirstNamestring | nulllastNamestring | nullemailstring | nullglobalRolestring | nullisEnabledboolean | nullupdatedAtstring | null
Field Name Type Description cursorstring | nullhas_moreboolean
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 userIdstringYes User ID
Users Context Store Search
Search and filter users records powered by Airbyte's data sync. This often provides additional fields and operators beyond what the API natively supports, making it easier to narrow down results before performing further operations. Only available in hosted mode.
Python SDK
await ashby . users . context_store_search ( query = { "filter" : { "eq" : { "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": "context_store_search", "params": { "query": {"filter": {"eq": {"id": "<str>"}}} } }'
Parameters
Parameter Name Type Required Description queryobjectYes Filter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or query.filterobjectNo Filter conditions query.sortarrayNo Sort conditions limitintegerNo Maximum results to return (default 1000) cursorstringNo Pagination cursor from previous response's meta.cursor fieldsarrayNo Field paths to include in results
Searchable Fields
Field Name Type Description idstringUnique identifier for the user firstNamestringFirst name of the user lastNamestringLast name of the user emailstringPrimary email address of the user
Response Schema Field Name Type Description dataarrayList of matching records metaobjectPagination metadata meta.has_morebooleanWhether additional pages are available meta.cursorstring | nullCursor for next page of results meta.took_msnumber | nullQuery execution time in milliseconds data[].idstringUnique identifier for the user data[].firstNamestringFirst name of the user data[].lastNamestringLast name of the user data[].emailstringPrimary email address of the user
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 cursorstringNo Pagination cursor for next page limitintegerNo Maximum number of records to return per page
Response Schema Records Field Name Type Description idstringtitlestring | nulljobIdstring | nulldepartmentNamestring | nullteamNamestring | nulllocationNamestring | nulllocationExternalNamestring | nullworkplaceTypestring | nullemploymentTypestring | nullisListedboolean | nullpublishedDatestring | nullapplicationDeadlinestring | nullexternalLinkstring | nullapplyLinkstring | nulllocationIdsobject | anycompensationTierSummarystring | nullshouldDisplayCompensationOnJobBoardboolean | nullupdatedAtstring | null
Field Name Type Description cursorstring | nullhas_moreboolean
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 jobPostingIdstringYes Job posting ID
Job Postings Context Store Search
Search and filter job postings records powered by Airbyte's data sync. This often provides additional fields and operators beyond what the API natively supports, making it easier to narrow down results before performing further operations. Only available in hosted mode.
Python SDK
await ashby . job_postings . context_store_search ( query = { "filter" : { "eq" : { "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": "context_store_search", "params": { "query": {"filter": {"eq": {"id": "<str>"}}} } }'
Parameters
Parameter Name Type Required Description queryobjectYes Filter and sort conditions. Supports operators: eq, neq, gt, gte, lt, lte, in, like, fuzzy, keyword, not, and, or query.filterobjectNo Filter conditions query.sortarrayNo Sort conditions limitintegerNo Maximum results to return (default 1000) cursorstringNo Pagination cursor from previous response's meta.cursor fieldsarrayNo Field paths to include in results
Searchable Fields
Field Name Type Description idstringUnique identifier for the job posting titlestringTitle of the job posting isListedbooleanWhether the job posting is currently published/listed jobIdstringIdentifier of the job this posting belongs to locationNamestringName of the location associated with the posting
Response Schema Field Name Type Description dataarrayList of matching records metaobjectPagination metadata meta.has_morebooleanWhether additional pages are available meta.cursorstring | nullCursor for next page of results meta.took_msnumber | nullQuery execution time in milliseconds data[].idstringUnique identifier for the job posting data[].titlestringTitle of the job posting data[].isListedbooleanWhether the job posting is currently published/listed data[].jobIdstringIdentifier of the job this posting belongs to data[].locationNamestringName of the location associated with the posting
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 cursorstringNo Pagination cursor for next page limitintegerNo Maximum number of records to return per page
Response Schema Records Field Name Type Description idstringtitlestring | nullisArchivedboolean | nullsourceTypeobject | any
Field Name Type Description cursorstring | nullhas_moreboolean
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 cursorstringNo Pagination cursor for next page limitintegerNo Maximum number of records to return per page
Response Schema Records Field Name Type Description idstringtextstring | nullreasonTypestring | nullisArchivedboolean | null
Field Name Type Description cursorstring | nullhas_moreboolean
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 cursorstringNo Pagination cursor for next page limitintegerNo Maximum number of records to return per page
Response Schema Records Field Name Type Description idstringtitlestring | nullisArchivedboolean | null
Field Name Type Description cursorstring | nullhas_moreboolean
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 cursorstringNo Pagination cursor for next page limitintegerNo Maximum number of records to return per page
Response Schema Records Field Name Type Description idstringtitlestring | nullobjectTypestring | nullisArchivedboolean | nullisPrivateboolean | nullfieldTypestring | null
Field Name Type Description cursorstring | nullhas_moreboolean
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 cursorstringNo Pagination cursor for next page limitintegerNo Maximum number of records to return per page
Response Schema Records Field Name Type Description idstringorganizationIdstring | nulltitlestring | nullisArchivedboolean | nullisDefaultFormboolean | nullformDefinitionobject | anyinterviewIdstring | null
Field Name Type Description cursorstring | nullhas_moreboolean