Documents: The documentation for the StackOne Unified API - DOCUMENTS
The SDK can be installed with either npm, pnpm, bun or yarn package managers.
npm add @stackone/stackone-client-ts
pnpm add @stackone/stackone-client-ts
bun add @stackone/stackone-client-ts
yarn add @stackone/stackone-client-ts zod
# Note that Yarn does not install peer dependencies automatically. You will need
# to install zod as shown above.
import { StackOne } from "@stackone/stackone-client-ts";
const stackOne = new StackOne({
security: {
password: "",
username: "",
},
});
async function run() {
const result = await stackOne.hris.listEmployees({
expand: "company,employments,work_location,home_location,groups,skills",
fields:
"id,remote_id,first_name,last_name,name,display_name,gender,ethnicity,date_of_birth,birthday,marital_status,avatar_url,avatar,personal_email,personal_phone_number,work_email,work_phone_number,job_id,remote_job_id,job_title,job_description,department_id,remote_department_id,department,cost_centers,benefits,company,manager_id,remote_manager_id,hire_date,start_date,tenure,work_anniversary,employment_type,employment_contract_type,employment_status,termination_date,company_name,company_id,remote_company_id,preferred_language,citizenships,home_location,work_location,employments,custom_fields,documents,created_at,updated_at,employee_number,national_identity_number,national_identity_numbers,skills",
filter: {
updatedAfter: "2020-01-01T00:00:00.000Z",
},
include: "avatar_url,avatar,custom_fields,job_description,benefits",
updatedAfter: "2020-01-01T00:00:00.000Z",
xAccountId: "<id>",
});
for await (const page of result) {
// Handle the page
console.log(page);
}
}
run();
Available methods
- deleteAccount - Delete Account
- getAccount - Get Account
- getAccountMetaInfo - Get meta information of the account
- listLinkedAccounts - List Accounts
- updateAccount - Update Account
- createApplication - Create Application
- createApplicationNote - Create Application Note
- createBackgroundCheckPackage - Create Background Check Package
- createCandidate - Create Candidate
- createCandidateNote - Create Candidate Note
- createJob - Create Job
- createOffer - Creates an offer
- deleteBackgroundCheckPackage - Delete Background Check Package
- downloadApplicationDocument - Download Application Document
- getApplication - Get Application
- getApplicationCustomFieldDefinition - Get Application Custom Field Definition
- getApplicationDocument - Get Application Document
- getApplicationNote - Get Application Note
- getApplicationOffer - Get Application Offer
- getApplicationScheduledInterview - Get Applications scheduled interview
- getApplicationScorecard - Get Application Scorecard
- getAssessmentsPackage - Get Assessments Package
- getAssessmentsRequest - Get Assessments Requests
- getAssessmentsResult - Get Assessments Results
- getBackgroundCheckPackage - Get Background Check Package
- getBackgroundCheckRequest - Get Background Check Request
- getBackgroundCheckResult - Get Background Check Results
- getCandidate - Get Candidate
- getCandidateCustomFieldDefinition - Get Candidate Custom Field Definition
- getCandidateNote - Get Candidate Note
- getDepartment - Get Department
- getInterview - Get Interview
- getInterviewStage - Get Interview Stage
- getJob - Get Job
- getJobCustomFieldDefinition - Get Job Custom Field Definition
- getJobPosting - Get Job Posting
- getList - Get List
- getLocation - Get Location
- getOffer - Get Offer
- getRejectedReason - Get Rejected Reason
- getUser - Get User
- listApplicationCustomFieldDefinitions - List Application Custom Field Definitions
- listApplicationDocuments - List Application Documents
- listApplicationNotes - List Application Notes
- listApplicationScorecards - List Application Scorecards
- listApplications - List Applications
- listApplicationsOffers - List Application Offers
- listApplicationsScheduledInterviews - List Applications scheduled interviews
- listAssessmentsPackages - List Assessments Packages
- listBackgroundCheckPackages - List Background Check Packages
- listBackgroundCheckRequest - List Background Check Request
- listCandidateCustomFieldDefinitions - List Candidate Custom Field Definitions
- listCandidateNotes - List Candidate Notes
- listCandidates - List Candidates
- listDepartments - List Departments
- listInterviewStages - List Interview Stages
- listInterviews - List Interviews
- listJobCustomFieldDefinitions - List Job Custom Field Definitions
- listJobPostings - List Job Postings
- listJobs - List Jobs
- listLists - Get all Lists
- listLocations - List locations
- listOffers - List Offers
- listRejectedReasons - List Rejected Reasons
- listUsers - List Users
- moveApplication - Move Application
- orderAssessmentsRequest - Order Assessments Request
- orderBackgroundCheckRequest - Order Background Check Request
- rejectApplication - Reject Application
- updateApplication - Update an Application
- updateApplicationNote - Update an Application Note
- updateAssessmentsResult - Update Assessments Result
- updateBackgroundCheckPackage - Update Background Check Package
- updateBackgroundCheckResult - Update Background Check Result
- updateCandidate - Update Candidate
- updateJob - Update Job
- uploadApplicationDocument - Upload Application Document
- getConnectorMeta - Get Connector Meta information for the given provider key
- listConnectorsMeta - List Connectors Meta Information for all providers
- authenticateConnectSession - Authenticate Connect Session
- createConnectSession - Create Connect Session
- createContact - Creates a new Contact
- getAccount - Get Account
- getContact - Get Contact
- getContactCustomFieldDefinition - Get Contact Custom Field Definition
- getList - Get List
- listAccounts - List Accounts
- listContactCustomFieldDefinitions - List Contact Custom Field Definitions
- listContacts - List Contacts
- listLists - Get all Lists
- updateContact - Update Contact (early access)
- downloadFile - Download File
- getDrive - Get Drive
- getFile - Get File
- getFolder - Get Folder
- listDrives - List Drives
- listFiles - List Files
- listFolders - List Folders
- searchFiles - Search Files
- uploadFile - Upload File
- batchUploadEmployeeDocument - Batch Upload Employee Document
- cancelEmployeeTimeOffRequest - Cancel Employee Time Off Request
- createEmployee - Creates an employee
- createEmployeeEmployment - Create Employee Employment
- createEmployeeSkill - Create Employee Skill
- createEmployeeTimeOffRequest - Create Employee Time Off Request
- createEmployeeWorkEligibilityRequest - Create Employee Work Eligibility Request
-
createTimeOffRequest- Creates a time off request⚠️ Deprecated - downloadEmployeeDocument - Download Employee Document
- getBenefit - Get Benefit
- getCompany - Get Company
- getCostCenterGroup - Get Cost Center Group
- getDepartmentGroup - Get Department Group
- getEmployee - Get Employee
- getEmployeeCustomFieldDefinition - Get employee Custom Field Definition
- getEmployeeDocument - Get Employee Document
- getEmployeeDocumentCategory - Get Employee Document Category
- getEmployeeEmployment - Get Employee Employment
- getEmployeeSkill - Get Employee Skill
- getEmployeeTimeOffBalance - Get Employee Time Off Balance
- getEmployeesTimeOffRequest - Get Employees Time Off Request
- getEmployeesWorkEligibility - Get Employees Work Eligibility
- getEmployment - Get Employment
- getGroup - Get Group
- getJob - Get Job
- getLocation - Get Work Location
- getTeamGroup - Get Team Group
- getTimeEntries - Get Time Entry
- getTimeOffPolicy - Get Time Off Policy
- getTimeOffRequest - Get time off request
-
getTimeOffType- Get time off type⚠️ Deprecated - inviteEmployee - Invite Employee
- listBenefits - List benefits
- listCompanies - List Companies
- listCostCenterGroups - List Cost Center Groups
- listDepartmentGroups - List Department Groups
- listEmployeeCategories - List Employee Document Categories
- listEmployeeCustomFieldDefinitions - List employee Custom Field Definitions
- listEmployeeDocuments - List Employee Documents
- listEmployeeEmployments - List Employee Employments
- listEmployeeSkills - List Employee Skills
- listEmployeeTimeOffBalances - List Employee Time Off Balances
- listEmployeeTimeOffPolicies - List Assigned Time Off Policies
- listEmployeeTimeOffRequests - List Employee Time Off Requests
- listEmployeeWorkEligibility - List Employee Work Eligibility
- listEmployees - List Employees
- listEmployments - List Employments
- listGroups - List Groups
- listJobs - List Jobs
- listLocations - List Work Locations
- listTeamGroups - List Team Groups
- listTimeEntries - List Time Entries
- listTimeOffPolicies - List Time Off Policies
- listTimeOffRequests - List time off requests
-
listTimeOffTypes- List time off types⚠️ Deprecated - updateEmployee - Updates an employee
- updateEmployeeEmployment - Update Employee Employment
- updateEmployeeTimeOffRequest - Update Employee Time Off Request
- updateEmployeeWorkEligibilityRequest - Update Employee Work Eligibility Request
-
updateTimeOffRequest- Update time off request⚠️ Deprecated - uploadEmployeeDocument - Upload Employee Document
- deleteUser - Delete User
- getGroup - Get Group
- getPolicy - Get Policy
- getRole - Get Role
- getUser - Get User
- listGroups - List Groups
- listPolicies - List Policies
- listRoles - List Roles
- listUsers - List Users
- updateUser - Update User
- batchUpsertContent - Batch Upsert Content
- batchUpsertCourse - Batch Upsert Course
- createCollection - Create Collection
- createUserAssignment - Create User Assignment
- createUserCompletion - Create User Completion
- deleteUserCompletion - Delete User Completion
- getAssignment - Get Assignment
- getCategory - Get Category
- getCompletion - Get Completion
- getContent - Get Content
- getCourse - Get Course
- getSkill - Get Skill
- getUser - Get User
- getUserAssignment - Get User Assignment
- getUserCompletion - Get User Completion
- listAssignments - List Assignments
- listCategories - List Categories
- listCompletions - List Completions
- listContent - List Content
- listCourses - List Courses
- listSkills - List Skills
- listUserAssignments - List User Assignments
- listUserCompletions - List User Completions
- listUsers - List Users
- updateCollection - Update Collection
- upsertContent - Upsert Content
- upsertCourse - Upsert Course
- createContentBlock - Create Content Block
- createEmailTemplate - Create Email Templates
- createInAppTemplate - Create In-App Template
-
createOmniChannelTemplate- Create Omni-Channel Template⚠️ Deprecated - createPushTemplate - Create Push Template
- createSmsTemplate - Create SMS Template
- getCampaign - Get campaign
- getContentBlock - Get Content Blocks
- getEmailTemplate - Get Email Templates
- getInAppTemplate - Get In-App Template
-
getOmniChannelTemplate- Get Omni-Channel Template⚠️ Deprecated - getPushTemplate - Get Push Template
- getSmsTemplate - Get SMS Template
- listCampaigns - List campaigns
- listContentBlocks - List Content Blocks
- listEmailTemplates - List Email Templates
- listInAppTemplates - List In-App Templates
-
listOmniChannelTemplates- List Omni-Channel Templates⚠️ Deprecated - listPushTemplates - List Push Templates
- listSmsTemplates - List SMS Templates
- updateContentBlock - Update Content Block
- updateEmailTemplate - Update Email Templates
- updateInAppTemplate - Update In-App Template
-
updateOmniChannelTemplate- Update Omni-Channel Template⚠️ Deprecated - updatePushTemplate - Update Push Template
- updateSmsTemplate - Update SMS Template
- proxyRequest - Proxy Request
- getLog - Get a Log
- listLogs - List Logs
- listStepLogs - List Step Logs
- createTicket - Create Ticket
- downloadTicketingAttachment - Download Attachment
- getAttachment - Get Attachment
- getCollection - Get Collection
- getComment - Get Comment
- getTicket - Get Ticket
- getTicketType - Get Ticket Type
- getUser - Get User
- listAttachments - List Attachments
- listCollections - List Collections
- listComments - List Comments
- listTicketTypes - List Ticket Types
- listTickets - List Tickets
- listUsers - List Users
Some of the endpoints in this SDK support pagination. To use pagination, you
make your SDK calls as usual, but the returned response object will also be an
async iterable that can be consumed using the for await...of
syntax.
Here's an example of one such pagination call:
import { StackOne } from "@stackone/stackone-client-ts";
const stackOne = new StackOne({
security: {
password: "",
username: "",
},
});
async function run() {
const result = await stackOne.ats.listApplicationCustomFieldDefinitions({
fields: "id,remote_id,name,description,type,options",
filter: {
updatedAfter: "2020-01-01T00:00:00.000Z",
},
updatedAfter: "2020-01-01T00:00:00.000Z",
xAccountId: "<id>",
});
for await (const page of result) {
// Handle the page
console.log(page);
}
}
run();
Some methods specify known errors which can be thrown. All the known errors are enumerated in the sdk/models/errors/errors.ts
module. The known errors for a method are documented under the Errors tables in SDK docs. For example, the deleteAccount
method may throw the following errors:
Error Type | Status Code | Content Type |
---|---|---|
errors.BadRequestResponse | 400 | application/json |
errors.UnauthorizedResponse | 401 | application/json |
errors.ForbiddenResponse | 403 | application/json |
errors.NotFoundResponse | 404 | application/json |
errors.RequestTimedOutResponse | 408 | application/json |
errors.ConflictResponse | 409 | application/json |
errors.UnprocessableEntityResponse | 422 | application/json |
errors.TooManyRequestsResponse | 429 | application/json |
errors.InternalServerErrorResponse | 500 | application/json |
errors.NotImplementedResponse | 501 | application/json |
errors.BadGatewayResponse | 502 | application/json |
errors.SDKError | 4XX, 5XX | */* |
If the method throws an error and it is not captured by the known errors, it will default to throwing a SDKError
.
import { StackOne } from "@stackone/stackone-client-ts";
import {
BadGatewayResponse,
BadRequestResponse,
ConflictResponse,
ForbiddenResponse,
InternalServerErrorResponse,
NotFoundResponse,
NotImplementedResponse,
RequestTimedOutResponse,
SDKValidationError,
TooManyRequestsResponse,
UnauthorizedResponse,
UnprocessableEntityResponse,
} from "@stackone/stackone-client-ts/sdk/models/errors";
const stackOne = new StackOne({
security: {
password: "",
username: "",
},
});
async function run() {
let result;
try {
result = await stackOne.accounts.deleteAccount({
id: "<id>",
});
// Handle the result
console.log(result);
} catch (err) {
switch (true) {
// The server response does not match the expected SDK schema
case (err instanceof SDKValidationError): {
// Pretty-print will provide a human-readable multi-line error message
console.error(err.pretty());
// Raw value may also be inspected
console.error(err.rawValue);
return;
}
case (err instanceof BadRequestResponse): {
// Handle err.data$: BadRequestResponseData
console.error(err);
return;
}
case (err instanceof UnauthorizedResponse): {
// Handle err.data$: UnauthorizedResponseData
console.error(err);
return;
}
case (err instanceof ForbiddenResponse): {
// Handle err.data$: ForbiddenResponseData
console.error(err);
return;
}
case (err instanceof NotFoundResponse): {
// Handle err.data$: NotFoundResponseData
console.error(err);
return;
}
case (err instanceof RequestTimedOutResponse): {
// Handle err.data$: RequestTimedOutResponseData
console.error(err);
return;
}
case (err instanceof ConflictResponse): {
// Handle err.data$: ConflictResponseData
console.error(err);
return;
}
case (err instanceof UnprocessableEntityResponse): {
// Handle err.data$: UnprocessableEntityResponseData
console.error(err);
return;
}
case (err instanceof TooManyRequestsResponse): {
// Handle err.data$: TooManyRequestsResponseData
console.error(err);
return;
}
case (err instanceof InternalServerErrorResponse): {
// Handle err.data$: InternalServerErrorResponseData
console.error(err);
return;
}
case (err instanceof NotImplementedResponse): {
// Handle err.data$: NotImplementedResponseData
console.error(err);
return;
}
case (err instanceof BadGatewayResponse): {
// Handle err.data$: BadGatewayResponseData
console.error(err);
return;
}
default: {
// Other errors such as network errors, see HTTPClientErrors for more details
throw err;
}
}
}
}
run();
Validation errors can also occur when either method arguments or data returned from the server do not match the expected format. The SDKValidationError
that is thrown as a result will capture the raw value that failed validation in an attribute called rawValue
. Additionally, a pretty()
method is available on this error that can be used to log a nicely formatted multi-line string since validation errors can list many issues and the plain error string may be difficult read when debugging.
In some rare cases, the SDK can fail to get a response from the server or even make the request due to unexpected circumstances such as network conditions. These types of errors are captured in the sdk/models/errors/httpclienterrors.ts
module:
HTTP Client Error | Description |
---|---|
RequestAbortedError | HTTP request was aborted by the client |
RequestTimeoutError | HTTP request timed out due to an AbortSignal signal |
ConnectionError | HTTP client was unable to make a request to a server |
InvalidRequestError | Any input used to create a request is invalid |
UnexpectedClientError | Unrecognised or unexpected error |
The TypeScript SDK makes API calls using an HTTPClient
that wraps the native
Fetch API. This
client is a thin wrapper around fetch
and provides the ability to attach hooks
around the request lifecycle that can be used to modify the request or handle
errors and response.
The HTTPClient
constructor takes an optional fetcher
argument that can be
used to integrate a third-party HTTP client or when writing tests to mock out
the HTTP client and feed in fixtures.
The following example shows how to use the "beforeRequest"
hook to to add a
custom header and a timeout to requests and how to use the "requestError"
hook
to log errors:
import { StackOne } from "@stackone/stackone-client-ts";
import { HTTPClient } from "@stackone/stackone-client-ts/lib/http";
const httpClient = new HTTPClient({
// fetcher takes a function that has the same signature as native `fetch`.
fetcher: (request) => {
return fetch(request);
}
});
httpClient.addHook("beforeRequest", (request) => {
const nextRequest = new Request(request, {
signal: request.signal || AbortSignal.timeout(5000)
});
nextRequest.headers.set("x-custom-header", "custom value");
return nextRequest;
});
httpClient.addHook("requestError", (error, request) => {
console.group("Request Error");
console.log("Reason:", `${error}`);
console.log("Endpoint:", `${request.method} ${request.url}`);
console.groupEnd();
});
const sdk = new StackOne({ httpClient });
This SDK supports the following security scheme globally:
Name | Type | Scheme |
---|---|---|
username password
|
http | HTTP Basic |
You can set the security parameters through the security
optional parameter when initializing the SDK client instance. For example:
import { StackOne } from "@stackone/stackone-client-ts";
const stackOne = new StackOne({
security: {
password: "",
username: "",
},
});
async function run() {
const result = await stackOne.accounts.deleteAccount({
id: "<id>",
});
// Handle the result
console.log(result);
}
run();
For supported JavaScript runtimes, please consult RUNTIMES.md.
Some of the endpoints in this SDK support retries. If you use the SDK without any configuration, it will fall back to the default retry strategy provided by the API. However, the default retry strategy can be overridden on a per-operation basis, or across the entire SDK.
To change the default retry strategy for a single API call, simply provide a retryConfig object to the call:
import { StackOne } from "@stackone/stackone-client-ts";
const stackOne = new StackOne({
security: {
password: "",
username: "",
},
});
async function run() {
const result = await stackOne.accounts.deleteAccount({
id: "<id>",
}, {
retries: {
strategy: "backoff",
backoff: {
initialInterval: 1,
maxInterval: 50,
exponent: 1.1,
maxElapsedTime: 100,
},
retryConnectionErrors: false,
},
});
// Handle the result
console.log(result);
}
run();
If you'd like to override the default retry strategy for all operations that support retries, you can provide a retryConfig at SDK initialization:
import { StackOne } from "@stackone/stackone-client-ts";
const stackOne = new StackOne({
retryConfig: {
strategy: "backoff",
backoff: {
initialInterval: 1,
maxInterval: 50,
exponent: 1.1,
maxElapsedTime: 100,
},
retryConnectionErrors: false,
},
security: {
password: "",
username: "",
},
});
async function run() {
const result = await stackOne.accounts.deleteAccount({
id: "<id>",
});
// Handle the result
console.log(result);
}
run();
All the methods listed above are available as standalone functions. These functions are ideal for use in applications running in the browser, serverless runtimes or other environments where application bundle size is a primary concern. When using a bundler to build your application, all unused functionality will be either excluded from the final bundle or tree-shaken away.
To read more about standalone functions, check FUNCTIONS.md.
Available standalone functions
-
accountsDeleteAccount
- Delete Account -
accountsGetAccount
- Get Account -
accountsGetAccountMetaInfo
- Get meta information of the account -
accountsListLinkedAccounts
- List Accounts -
accountsUpdateAccount
- Update Account -
atsCreateApplication
- Create Application -
atsCreateApplicationNote
- Create Application Note -
atsCreateBackgroundCheckPackage
- Create Background Check Package -
atsCreateCandidate
- Create Candidate -
atsCreateCandidateNote
- Create Candidate Note -
atsCreateJob
- Create Job -
atsCreateOffer
- Creates an offer -
atsDeleteBackgroundCheckPackage
- Delete Background Check Package -
atsDownloadApplicationDocument
- Download Application Document -
atsGetApplication
- Get Application -
atsGetApplicationCustomFieldDefinition
- Get Application Custom Field Definition -
atsGetApplicationDocument
- Get Application Document -
atsGetApplicationNote
- Get Application Note -
atsGetApplicationOffer
- Get Application Offer -
atsGetApplicationScheduledInterview
- Get Applications scheduled interview -
atsGetApplicationScorecard
- Get Application Scorecard -
atsGetAssessmentsPackage
- Get Assessments Package -
atsGetAssessmentsRequest
- Get Assessments Requests -
atsGetAssessmentsResult
- Get Assessments Results -
atsGetBackgroundCheckPackage
- Get Background Check Package -
atsGetBackgroundCheckRequest
- Get Background Check Request -
atsGetBackgroundCheckResult
- Get Background Check Results -
atsGetCandidate
- Get Candidate -
atsGetCandidateCustomFieldDefinition
- Get Candidate Custom Field Definition -
atsGetCandidateNote
- Get Candidate Note -
atsGetDepartment
- Get Department -
atsGetInterview
- Get Interview -
atsGetInterviewStage
- Get Interview Stage -
atsGetJob
- Get Job -
atsGetJobCustomFieldDefinition
- Get Job Custom Field Definition -
atsGetJobPosting
- Get Job Posting -
atsGetList
- Get List -
atsGetLocation
- Get Location -
atsGetOffer
- Get Offer -
atsGetRejectedReason
- Get Rejected Reason -
atsGetUser
- Get User -
atsListApplicationCustomFieldDefinitions
- List Application Custom Field Definitions -
atsListApplicationDocuments
- List Application Documents -
atsListApplicationNotes
- List Application Notes -
atsListApplications
- List Applications -
atsListApplicationScorecards
- List Application Scorecards -
atsListApplicationsOffers
- List Application Offers -
atsListApplicationsScheduledInterviews
- List Applications scheduled interviews -
atsListAssessmentsPackages
- List Assessments Packages -
atsListBackgroundCheckPackages
- List Background Check Packages -
atsListBackgroundCheckRequest
- List Background Check Request -
atsListCandidateCustomFieldDefinitions
- List Candidate Custom Field Definitions -
atsListCandidateNotes
- List Candidate Notes -
atsListCandidates
- List Candidates -
atsListDepartments
- List Departments -
atsListInterviews
- List Interviews -
atsListInterviewStages
- List Interview Stages -
atsListJobCustomFieldDefinitions
- List Job Custom Field Definitions -
atsListJobPostings
- List Job Postings -
atsListJobs
- List Jobs -
atsListLists
- Get all Lists -
atsListLocations
- List locations -
atsListOffers
- List Offers -
atsListRejectedReasons
- List Rejected Reasons -
atsListUsers
- List Users -
atsMoveApplication
- Move Application -
atsOrderAssessmentsRequest
- Order Assessments Request -
atsOrderBackgroundCheckRequest
- Order Background Check Request -
atsRejectApplication
- Reject Application -
atsUpdateApplication
- Update an Application -
atsUpdateApplicationNote
- Update an Application Note -
atsUpdateAssessmentsResult
- Update Assessments Result -
atsUpdateBackgroundCheckPackage
- Update Background Check Package -
atsUpdateBackgroundCheckResult
- Update Background Check Result -
atsUpdateCandidate
- Update Candidate -
atsUpdateJob
- Update Job -
atsUploadApplicationDocument
- Upload Application Document -
connectorsGetConnectorMeta
- Get Connector Meta information for the given provider key -
connectorsListConnectorsMeta
- List Connectors Meta Information for all providers -
connectSessionsAuthenticateConnectSession
- Authenticate Connect Session -
connectSessionsCreateConnectSession
- Create Connect Session -
crmCreateContact
- Creates a new Contact -
crmGetAccount
- Get Account -
crmGetContact
- Get Contact -
crmGetContactCustomFieldDefinition
- Get Contact Custom Field Definition -
crmGetList
- Get List -
crmListAccounts
- List Accounts -
crmListContactCustomFieldDefinitions
- List Contact Custom Field Definitions -
crmListContacts
- List Contacts -
crmListLists
- Get all Lists -
crmUpdateContact
- Update Contact (early access) -
documentsDownloadFile
- Download File -
documentsGetDrive
- Get Drive -
documentsGetFile
- Get File -
documentsGetFolder
- Get Folder -
documentsListDrives
- List Drives -
documentsListFiles
- List Files -
documentsListFolders
- List Folders -
documentsSearchFiles
- Search Files -
documentsUploadFile
- Upload File -
hrisBatchUploadEmployeeDocument
- Batch Upload Employee Document -
hrisCancelEmployeeTimeOffRequest
- Cancel Employee Time Off Request -
hrisCreateEmployee
- Creates an employee -
hrisCreateEmployeeEmployment
- Create Employee Employment -
hrisCreateEmployeeSkill
- Create Employee Skill -
hrisCreateEmployeeTimeOffRequest
- Create Employee Time Off Request -
hrisCreateEmployeeWorkEligibilityRequest
- Create Employee Work Eligibility Request -
hrisDownloadEmployeeDocument
- Download Employee Document -
hrisGetBenefit
- Get Benefit -
hrisGetCompany
- Get Company -
hrisGetCostCenterGroup
- Get Cost Center Group -
hrisGetDepartmentGroup
- Get Department Group -
hrisGetEmployee
- Get Employee -
hrisGetEmployeeCustomFieldDefinition
- Get employee Custom Field Definition -
hrisGetEmployeeDocument
- Get Employee Document -
hrisGetEmployeeDocumentCategory
- Get Employee Document Category -
hrisGetEmployeeEmployment
- Get Employee Employment -
hrisGetEmployeeSkill
- Get Employee Skill -
hrisGetEmployeesTimeOffRequest
- Get Employees Time Off Request -
hrisGetEmployeesWorkEligibility
- Get Employees Work Eligibility -
hrisGetEmployeeTimeOffBalance
- Get Employee Time Off Balance -
hrisGetEmployment
- Get Employment -
hrisGetGroup
- Get Group -
hrisGetJob
- Get Job -
hrisGetLocation
- Get Work Location -
hrisGetTeamGroup
- Get Team Group -
hrisGetTimeEntries
- Get Time Entry -
hrisGetTimeOffPolicy
- Get Time Off Policy -
hrisGetTimeOffRequest
- Get time off request -
hrisInviteEmployee
- Invite Employee -
hrisListBenefits
- List benefits -
hrisListCompanies
- List Companies -
hrisListCostCenterGroups
- List Cost Center Groups -
hrisListDepartmentGroups
- List Department Groups -
hrisListEmployeeCategories
- List Employee Document Categories -
hrisListEmployeeCustomFieldDefinitions
- List employee Custom Field Definitions -
hrisListEmployeeDocuments
- List Employee Documents -
hrisListEmployeeEmployments
- List Employee Employments -
hrisListEmployees
- List Employees -
hrisListEmployeeSkills
- List Employee Skills -
hrisListEmployeeTimeOffBalances
- List Employee Time Off Balances -
hrisListEmployeeTimeOffPolicies
- List Assigned Time Off Policies -
hrisListEmployeeTimeOffRequests
- List Employee Time Off Requests -
hrisListEmployeeWorkEligibility
- List Employee Work Eligibility -
hrisListEmployments
- List Employments -
hrisListGroups
- List Groups -
hrisListJobs
- List Jobs -
hrisListLocations
- List Work Locations -
hrisListTeamGroups
- List Team Groups -
hrisListTimeEntries
- List Time Entries -
hrisListTimeOffPolicies
- List Time Off Policies -
hrisListTimeOffRequests
- List time off requests -
hrisUpdateEmployee
- Updates an employee -
hrisUpdateEmployeeEmployment
- Update Employee Employment -
hrisUpdateEmployeeTimeOffRequest
- Update Employee Time Off Request -
hrisUpdateEmployeeWorkEligibilityRequest
- Update Employee Work Eligibility Request -
hrisUploadEmployeeDocument
- Upload Employee Document -
iamDeleteUser
- Delete User -
iamGetGroup
- Get Group -
iamGetPolicy
- Get Policy -
iamGetRole
- Get Role -
iamGetUser
- Get User -
iamListGroups
- List Groups -
iamListPolicies
- List Policies -
iamListRoles
- List Roles -
iamListUsers
- List Users -
iamUpdateUser
- Update User -
lmsBatchUpsertContent
- Batch Upsert Content -
lmsBatchUpsertCourse
- Batch Upsert Course -
lmsCreateCollection
- Create Collection -
lmsCreateUserAssignment
- Create User Assignment -
lmsCreateUserCompletion
- Create User Completion -
lmsDeleteUserCompletion
- Delete User Completion -
lmsGetAssignment
- Get Assignment -
lmsGetCategory
- Get Category -
lmsGetCompletion
- Get Completion -
lmsGetContent
- Get Content -
lmsGetCourse
- Get Course -
lmsGetSkill
- Get Skill -
lmsGetUser
- Get User -
lmsGetUserAssignment
- Get User Assignment -
lmsGetUserCompletion
- Get User Completion -
lmsListAssignments
- List Assignments -
lmsListCategories
- List Categories -
lmsListCompletions
- List Completions -
lmsListContent
- List Content -
lmsListCourses
- List Courses -
lmsListSkills
- List Skills -
lmsListUserAssignments
- List User Assignments -
lmsListUserCompletions
- List User Completions -
lmsListUsers
- List Users -
lmsUpdateCollection
- Update Collection -
lmsUpsertContent
- Upsert Content -
lmsUpsertCourse
- Upsert Course -
marketingCreateContentBlock
- Create Content Block -
marketingCreateEmailTemplate
- Create Email Templates -
marketingCreateInAppTemplate
- Create In-App Template -
marketingCreatePushTemplate
- Create Push Template -
marketingCreateSmsTemplate
- Create SMS Template -
marketingGetCampaign
- Get campaign -
marketingGetContentBlock
- Get Content Blocks -
marketingGetEmailTemplate
- Get Email Templates -
marketingGetInAppTemplate
- Get In-App Template -
marketingGetPushTemplate
- Get Push Template -
marketingGetSmsTemplate
- Get SMS Template -
marketingListCampaigns
- List campaigns -
marketingListContentBlocks
- List Content Blocks -
marketingListEmailTemplates
- List Email Templates -
marketingListInAppTemplates
- List In-App Templates -
marketingListPushTemplates
- List Push Templates -
marketingListSmsTemplates
- List SMS Templates -
marketingUpdateContentBlock
- Update Content Block -
marketingUpdateEmailTemplate
- Update Email Templates -
marketingUpdateInAppTemplate
- Update In-App Template -
marketingUpdatePushTemplate
- Update Push Template -
marketingUpdateSmsTemplate
- Update SMS Template -
proxyProxyRequest
- Proxy Request -
requestLogsGetLog
- Get a Log -
requestLogsListLogs
- List Logs -
requestLogsListStepLogs
- List Step Logs -
ticketingCreateTicket
- Create Ticket -
ticketingDownloadTicketingAttachment
- Download Attachment -
ticketingGetAttachment
- Get Attachment -
ticketingGetCollection
- Get Collection -
ticketingGetComment
- Get Comment -
ticketingGetTicket
- Get Ticket -
ticketingGetTicketType
- Get Ticket Type -
ticketingGetUser
- Get User -
ticketingListAttachments
- List Attachments -
ticketingListCollections
- List Collections -
ticketingListComments
- List Comments -
ticketingListTickets
- List Tickets -
ticketingListTicketTypes
- List Ticket Types -
ticketingListUsers
- List Users -
- Creates a time off requesthrisCreateTimeOffRequest
⚠️ Deprecated -
- Get time off typehrisGetTimeOffType
⚠️ Deprecated -
- List time off typeshrisListTimeOffTypes
⚠️ Deprecated -
- Update time off requesthrisUpdateTimeOffRequest
⚠️ Deprecated -
- Create Omni-Channel TemplatemarketingCreateOmniChannelTemplate
⚠️ Deprecated -
- Get Omni-Channel TemplatemarketingGetOmniChannelTemplate
⚠️ Deprecated -
- List Omni-Channel TemplatesmarketingListOmniChannelTemplates
⚠️ Deprecated -
- Update Omni-Channel TemplatemarketingUpdateOmniChannelTemplate
⚠️ Deprecated
You can setup your SDK to emit debug logs for SDK requests and responses.
You can pass a logger that matches console
's interface as an SDK option.
[!WARNING] Beware that debug logging will reveal secrets, like API tokens in headers, in log messages printed to a console or files. It's recommended to use this feature only during local development and not in production.
import { StackOne } from "@stackone/stackone-client-ts";
const sdk = new StackOne({ debugLogger: console });
This SDK is in beta, and there may be breaking changes between versions without a major version update. Therefore, we recommend pinning usage to a specific package version. This way, you can install the same version each time without breaking changes unless you are intentionally looking for the latest version.
While we value open-source contributions to this SDK, this library is generated programmatically. Feel free to open a PR or a Github issue as a proof of concept and we'll do our best to include it in a future release!