From c154e59c071f6606a4e6762db6b7af8ff4e7ba50 Mon Sep 17 00:00:00 2001 From: ryoppippi <1560508+ryoppippi@users.noreply.github.com> Date: Fri, 5 Dec 2025 14:42:10 +0000 Subject: [PATCH 01/13] refactor(openapi): remove OpenAPI spec parsing and generation code Remove the entire src/openapi/ directory containing: - Generated OpenAPI spec TypeScript files for all verticals (ATS, CRM, Documents, HRIS, IAM, LMS, Marketing, Messaging, Screening, Ticketing) - OpenAPI parser that converted OAS to tool definitions - OpenAPI loader for loading specs from files - Associated tests and snapshots This code is no longer needed as the SDK now exclusively uses fetchTools() to retrieve tool definitions via MCP. BREAKING CHANGE: OpenAPI spec imports from src/openapi/ are removed --- src/openapi/generated/ats.ts | 27497 ------------- src/openapi/generated/crm.ts | 4050 -- src/openapi/generated/documents.ts | 4483 -- src/openapi/generated/hris.ts | 29334 ------------- src/openapi/generated/iam.ts | 5235 --- src/openapi/generated/index.ts | 11 - src/openapi/generated/lms.ts | 8673 ---- src/openapi/generated/marketing.ts | 7697 ---- src/openapi/generated/messaging.ts | 3704 -- src/openapi/generated/screening.ts | 1615 - src/openapi/generated/stackone.ts | 6308 --- src/openapi/generated/ticketing.ts | 7794 ---- src/openapi/loader.ts | 97 - src/openapi/parser.ts | 670 - .../__snapshots__/openapi-parser.spec.ts.snap | 18605 --------- src/openapi/tests/openapi-loader.spec.ts | 13 - src/openapi/tests/openapi-parser.spec.ts | 505 - .../__snapshots__/openapi-parser.spec.ts.snap | 34009 ---------------- 18 files changed, 160300 deletions(-) delete mode 100644 src/openapi/generated/ats.ts delete mode 100644 src/openapi/generated/crm.ts delete mode 100644 src/openapi/generated/documents.ts delete mode 100644 src/openapi/generated/hris.ts delete mode 100644 src/openapi/generated/iam.ts delete mode 100644 src/openapi/generated/index.ts delete mode 100644 src/openapi/generated/lms.ts delete mode 100644 src/openapi/generated/marketing.ts delete mode 100644 src/openapi/generated/messaging.ts delete mode 100644 src/openapi/generated/screening.ts delete mode 100644 src/openapi/generated/stackone.ts delete mode 100644 src/openapi/generated/ticketing.ts delete mode 100644 src/openapi/loader.ts delete mode 100644 src/openapi/parser.ts delete mode 100644 src/openapi/tests/__snapshots__/openapi-parser.spec.ts.snap delete mode 100644 src/openapi/tests/openapi-loader.spec.ts delete mode 100644 src/openapi/tests/openapi-parser.spec.ts delete mode 100644 src/tests/__snapshots__/openapi-parser.spec.ts.snap diff --git a/src/openapi/generated/ats.ts b/src/openapi/generated/ats.ts deleted file mode 100644 index 7c49ea6e..00000000 --- a/src/openapi/generated/ats.ts +++ /dev/null @@ -1,27497 +0,0 @@ -// Generated OpenAPI specification for ats -// DO NOT EDIT THIS FILE DIRECTLY -export const atsSpec = { - openapi: '3.1.0', - paths: { - '/unified/ats/applications': { - get: { - operationId: 'ats_list_applications', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,candidate_id,remote_candidate_id,job_id,remote_job_id,job_posting_id,remote_job_posting_id,interview_stage,interview_stage_id,remote_interview_stage_id,application_stage,application_stage_id,remote_application_stage_id,rejected_reason,rejected_reason_id,remote_rejected_reason_id,rejected_reason_ids,remote_rejected_reason_ids,rejected_reasons,rejected_at,location_id,remote_location_id,location_ids,remote_location_ids,status,application_status,questionnaires,attachments,result_links,source,created_at,updated_at,documents,custom_fields,candidate,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'ATS Application Filter', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - created_after: { - description: - 'Use a string with a date to only select results created after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - job_id: { - description: 'Filter to select applications by job_id', - type: 'string', - nullable: true, - }, - stage: { - description: 'Filter to select applications by application_stage id', - type: 'string', - nullable: true, - }, - application_stage_id: { - description: 'Filter to select applications by application_stage_id', - type: 'string', - nullable: true, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - { - name: 'sync_token', - required: false, - in: 'query', - description: 'The sync token to select the only updated results', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'expand', - required: false, - in: 'query', - description: 'The comma separated list of fields that will be expanded in the response', - schema: { - nullable: true, - example: 'documents', - type: 'string', - }, - }, - { - name: 'include', - required: false, - in: 'query', - description: 'The comma separated list of fields that will be included in the response', - schema: { - nullable: true, - example: 'attachments,custom_fields', - type: 'string', - }, - }, - { - name: 'job_id', - required: false, - in: 'query', - description: 'Filter for job ID to retrieve a list of applications related to this job', - deprecated: true, - schema: { - nullable: true, - example: 'cxQiyiuasdFKfdsYfer', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of applications was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ApplicationsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Applications', - tags: ['Applications'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'list_applications', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - post: { - operationId: 'ats_create_application', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/AtsCreateApplicationRequestDto', - }, - }, - }, - }, - responses: { - '201': { - description: 'The application was created successfully.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CreateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Create Application', - tags: ['Applications'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'create_application', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/applications/{id}': { - get: { - operationId: 'ats_get_application', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,candidate_id,remote_candidate_id,job_id,remote_job_id,job_posting_id,remote_job_posting_id,interview_stage,interview_stage_id,remote_interview_stage_id,application_stage,application_stage_id,remote_application_stage_id,rejected_reason,rejected_reason_id,remote_rejected_reason_id,rejected_reason_ids,remote_rejected_reason_ids,rejected_reasons,rejected_at,location_id,remote_location_id,location_ids,remote_location_ids,status,application_status,questionnaires,attachments,result_links,source,created_at,updated_at,documents,custom_fields,candidate,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'expand', - required: false, - in: 'query', - description: 'The comma separated list of fields that will be expanded in the response', - schema: { - nullable: true, - example: 'documents', - type: 'string', - }, - }, - { - name: 'include', - required: false, - in: 'query', - description: 'The comma separated list of fields that will be included in the response', - schema: { - nullable: true, - example: 'attachments,custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The application with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ApplicationResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Application', - tags: ['Applications'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'get_application', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - patch: { - operationId: 'ats_update_application', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/AtsUpdateApplicationRequestDto', - }, - }, - }, - }, - responses: { - '200': { - description: 'Record updated successfully.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UpdateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Update Application', - tags: ['Applications'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'update_application', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/applications/{id}/offers': { - get: { - operationId: 'ats_list_applications_offers', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,application_id,remote_application_id,start_date,offer_status,salary,currency,created_at,updated_at,offer_history,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - { - name: 'sync_token', - required: false, - in: 'query', - description: 'The sync token to select the only updated results', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - ], - responses: { - '200': { - description: - 'The offers related to the application with the given identifier were retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/OffersPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Application Offers', - tags: ['Applications', 'Offers'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'list_applications_offers', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/applications/{id}/move': { - post: { - operationId: 'ats_move_application', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/AtsMoveApplicationRequestDto', - }, - }, - }, - }, - responses: { - '200': { - description: 'The application was moved successfully.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/MoveApplicationResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Move Application', - tags: ['Applications'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'move_application', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/applications/{id}/reject': { - post: { - operationId: 'ats_reject_application', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/AtsRejectApplicationRequestDto', - }, - }, - }, - }, - responses: { - '200': { - description: 'The application was rejected successfully.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RejectApplicationResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Reject Application', - tags: ['Applications'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'reject_application', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/applications/{id}/offers/{subResourceId}': { - get: { - operationId: 'ats_get_application_offer', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'subResourceId', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,application_id,remote_application_id,start_date,offer_status,salary,currency,created_at,updated_at,offer_history,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: - 'The offer related to the application with the given identifiers was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/OffersResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Application Offer', - tags: ['Applications', 'Offers'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'get_application_offer', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/applications/{id}/scorecards': { - get: { - operationId: 'ats_list_application_scorecards', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,sections,label,candidate_id,remote_candidate_id,application_id,remote_application_id,interview_id,remote_interview_id,author_id,remote_author_id,overall_recommendation,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - { - name: 'sync_token', - required: false, - in: 'query', - description: 'The sync token to select the only updated results', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - ], - responses: { - '200': { - description: - 'The scorecards related to the application with the given identifier were retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ScorecardsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Application Scorecards', - tags: ['Applications', 'Scorecards'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'list_application_scorecards', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/applications/{id}/scorecards/{subResourceId}': { - get: { - operationId: 'ats_get_application_scorecard', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'subResourceId', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,sections,label,candidate_id,remote_candidate_id,application_id,remote_application_id,interview_id,remote_interview_id,author_id,remote_author_id,overall_recommendation,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: - 'The scorecard related to the application with the given identifiers was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ScorecardsResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Application Scorecard', - tags: ['Applications'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'get_application_scorecard', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/applications/{id}/changes': { - get: { - operationId: 'ats_list_application_changes', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'event_id,remote_event_id,created_at,effective_at,change_type,actor,new_values,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: - 'Filter parameters for application changes (supports created_after and change_type)', - explode: true, - style: 'deepObject', - schema: { - properties: { - created_after: { - description: - 'Use a string with a date to only select results created after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - change_type: { - description: 'Filter by the type of change that occurred to the application', - enum: [ - 'application_status', - 'interview_stage', - 'rejected_reasons', - 'unmapped_value', - ], - type: 'string', - nullable: true, - }, - }, - nullable: true, - type: 'object', - }, - }, - ], - responses: { - '200': { - description: - 'The changes related to the application with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ApplicationChangesPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Application Changes', - tags: ['Applications', 'Application Changes'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'list_application_changes', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/applications/{id}/notes': { - get: { - operationId: 'ats_list_application_notes', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,content,author_id,remote_author_id,visibility,created_at,updated_at,deleted_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - { - name: 'sync_token', - required: false, - in: 'query', - description: 'The sync token to select the only updated results', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - ], - responses: { - '200': { - description: - 'The notes related to the application with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotesPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Application Notes', - tags: ['Applications', 'Notes'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'list_application_notes', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - post: { - operationId: 'ats_create_application_note', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/AtsCreateNotesRequestDto', - }, - }, - }, - }, - responses: { - '201': { - description: 'Record created successfully.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CreateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Create Application Note', - tags: ['Applications', 'Notes'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'create_application_note', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/applications/{id}/notes/{subResourceId}': { - get: { - operationId: 'ats_get_application_note', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'subResourceId', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,content,author_id,remote_author_id,visibility,created_at,updated_at,deleted_at,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: - 'The note with the given identifier related to the application with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NoteResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Application Note', - tags: ['Applications', 'Notes'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'get_application_note', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - patch: { - operationId: 'ats_update_application_note', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'subResourceId', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/AtsUpdateNotesRequestDto', - }, - }, - }, - }, - responses: { - '200': { - description: 'Record updated successfully.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UpdateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Update Application Note', - tags: ['Applications', 'Notes'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'update_application_note', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/applications/{id}/scheduled_interviews': { - get: { - operationId: 'ats_list_applications_scheduled_interviews', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,application_id,remote_application_id,interview_stage_id,remote_interview_stage_id,interview_stage,status,interview_status,interviewer_ids,remote_interviewer_ids,interview_parts,interviewers,start_at,end_at,meeting_url,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - { - name: 'sync_token', - required: false, - in: 'query', - description: 'The sync token to select the only updated results', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of applications scheduled interviews was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ScheduledInterviewsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Applications scheduled interviews', - tags: ['Applications', 'Scheduled Interviews'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'list_applications_scheduled_interviews', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/applications/{id}/scheduled_interviews/{subResourceId}': { - get: { - operationId: 'ats_get_application_scheduled_interview', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'subResourceId', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,candidate_id,remote_candidate_id,job_id,remote_job_id,job_posting_id,remote_job_posting_id,interview_stage,interview_stage_id,remote_interview_stage_id,application_stage,application_stage_id,remote_application_stage_id,rejected_reason,rejected_reason_id,remote_rejected_reason_id,rejected_reason_ids,remote_rejected_reason_ids,rejected_reasons,rejected_at,location_id,remote_location_id,location_ids,remote_location_ids,status,application_status,questionnaires,attachments,result_links,source,created_at,updated_at,documents,custom_fields,candidate,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: - 'The applications scheduled interview with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ScheduledInterviewsResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Applications scheduled interview', - tags: ['Applications', 'Scheduled Interviews'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'get_application_scheduled_interview', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/applications/{id}/documents/upload': { - post: { - operationId: 'ats_upload_application_document', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/AtsDocumentsUploadRequestDto', - }, - }, - }, - }, - responses: { - '201': { - description: - 'The document related to the application with the given identifier was uploaded.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/WriteResultApiModel', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Upload Application Document', - tags: ['Applications', 'Documents'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'upload_application_document', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/applications/{id}/documents/{subResourceId}/download': { - get: { - operationId: 'ats_download_application_document', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'subResourceId', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'format', - required: false, - in: 'query', - description: 'The format to download the file in', - schema: { - nullable: true, - example: 'base64', - type: 'string', - }, - }, - { - name: 'export_format', - required: false, - in: 'query', - description: 'The export format of the file', - schema: { - nullable: true, - example: 'text/plain', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: - 'The document related to the application with the given identifiers was retrieved.', - content: { - 'application/pdf': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'application/msword': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'application/vnd.openxmlformats-officedocument.wordprocessingml.document': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'application/vnd.ms-excel': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'application/vnd.ms-powerpoint': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'application/vnd.openxmlformats-officedocument.presentationml.presentation': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'application/rtf': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'text/plain': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'image/jpeg': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'image/png': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'image/gif': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'image/tiff': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'image/bmp': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'image/heic': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'application/zip': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'application/gzip': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'application/json': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'application/xml': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'text/csv': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'application/vnd.oasis.opendocument.text': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'application/vnd.oasis.opendocument.spreadsheet': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'audio/mpeg': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'video/mp4': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'video/webm': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'text/rtf': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'application/x-rar-compressed': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'application/x-7z-compressed': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'message/rfc822': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'application/vnd.ms-outlook': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'application/octet-stream': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'text/html': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'image/webp': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'application/vnd.oasis.opendocument.presentation': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'audio/wav': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'audio/mp4': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'video/avi': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'video/quicktime': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Download Application Document', - tags: ['Applications', 'Documents'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'download_application_document', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/applications/{id}/documents': { - get: { - operationId: 'ats_list_application_documents', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,type,category,category_id,remote_category_id,contents,created_at,updated_at,remote_url,file_format,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'ATS Document Filter', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - type: { - description: 'Filter to select documents by type', - type: 'string', - nullable: true, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - { - name: 'sync_token', - required: false, - in: 'query', - description: 'The sync token to select the only updated results', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - ], - responses: { - '200': { - description: - 'The documents related to the application with the given identifier were retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/AtsDocumentsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Application Documents', - tags: ['Applications', 'Documents'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'list_application_documents', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/applications/{id}/documents/{subResourceId}': { - get: { - operationId: 'ats_get_application_document', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'subResourceId', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,type,category,category_id,remote_category_id,contents,created_at,updated_at,remote_url,file_format,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: - 'The document related to the application with the given identifiers was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/AtsDocumentResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Application Document', - tags: ['Applications', 'Documents'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'get_application_document', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/candidates': { - get: { - operationId: 'ats_list_candidates', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,first_name,last_name,email,emails,social_links,phone,phone_numbers,company,country,title,application_ids,remote_application_ids,hired_at,custom_fields,tags,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'ATS Candidate Filter', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - created_after: { - description: - 'Use a string with a date to only select results created after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - email: { - description: 'Filter to select candidates by email', - type: 'string', - nullable: true, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - { - name: 'sync_token', - required: false, - in: 'query', - description: 'The sync token to select the only updated results', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'include', - required: false, - in: 'query', - description: 'The comma separated list of fields that will be included in the response', - schema: { - nullable: true, - example: 'custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of candidates was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CandidatesPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Candidates', - tags: ['Candidates'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'list_candidates', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - post: { - operationId: 'ats_create_candidate', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/AtsCreateCandidateRequestDto', - }, - }, - }, - }, - responses: { - '201': { - description: 'The candidate was successfully created.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CreateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Create Candidate', - tags: ['Candidates'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'create_candidate', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/candidates/{id}': { - get: { - operationId: 'ats_get_candidate', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,first_name,last_name,email,emails,social_links,phone,phone_numbers,company,country,title,application_ids,remote_application_ids,hired_at,custom_fields,tags,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'include', - required: false, - in: 'query', - description: 'The comma separated list of fields that will be included in the response', - schema: { - nullable: true, - example: 'custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The candidate with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CandidateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Candidate', - tags: ['Candidates'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'get_candidate', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - patch: { - operationId: 'ats_update_candidate', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/AtsUpdateCandidateRequestDto', - }, - }, - }, - }, - responses: { - '200': { - description: 'The candidate was successfully updated.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CreateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Update Candidate', - tags: ['Candidates'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'update_candidate', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/candidates/{id}/notes': { - get: { - operationId: 'ats_list_candidate_notes', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,content,author_id,remote_author_id,visibility,created_at,updated_at,deleted_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - { - name: 'sync_token', - required: false, - in: 'query', - description: 'The sync token to select the only updated results', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - ], - responses: { - '200': { - description: - 'The notes related to the candidate with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotesPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Candidate Notes', - tags: ['Candidates', 'Notes'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'list_candidate_notes', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - post: { - operationId: 'ats_create_candidate_note', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/AtsCreateNotesRequestDto', - }, - }, - }, - }, - responses: { - '201': { - description: 'Record created successfully.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CreateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Create Candidate Note', - tags: ['Candidates', 'Notes'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'create_candidate_note', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/candidates/{id}/notes/{subResourceId}': { - get: { - operationId: 'ats_get_candidate_note', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'subResourceId', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,content,author_id,remote_author_id,visibility,created_at,updated_at,deleted_at,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: - 'The note with the given identifier related to the candidate with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NoteResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Candidate Note', - tags: ['Candidates', 'Notes'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'get_candidate_note', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/custom_field_definitions/applications': { - get: { - operationId: 'ats_list_application_custom_field_definitions', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,name,description,type,options,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of application custom field definitions was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CustomFieldDefinitionsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Application Custom Field Definitions', - tags: ['Custom Field Definitions'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'list_application_custom_field_definitions', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/custom_field_definitions/applications/{id}': { - get: { - operationId: 'ats_get_application_custom_field_definition', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,name,description,type,options,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The application custom field definition was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CustomFieldDefinitionResultApiModel', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Application Custom Field Definition', - tags: ['Custom Field Definitions'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'get_application_custom_field_definition', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/custom_field_definitions/candidates': { - get: { - operationId: 'ats_list_candidate_custom_field_definitions', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,name,description,type,options,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of candidate custom field definitions was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CustomFieldDefinitionsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Candidate Custom Field Definitions', - tags: ['Custom Field Definitions'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'list_candidate_custom_field_definitions', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/custom_field_definitions/candidates/{id}': { - get: { - operationId: 'ats_get_candidate_custom_field_definition', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,name,description,type,options,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The candidate custom field definition was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CustomFieldDefinitionResultApiModel', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Candidate Custom Field Definition', - tags: ['Custom Field Definitions'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'get_candidate_custom_field_definition', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/custom_field_definitions/jobs': { - get: { - operationId: 'ats_list_job_custom_field_definitions', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,name,description,type,options,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of job custom field definitions was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CustomFieldDefinitionsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Job Custom Field Definitions', - tags: ['Custom Field Definitions'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'list_job_custom_field_definitions', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/custom_field_definitions/jobs/{id}': { - get: { - operationId: 'ats_get_job_custom_field_definition', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,name,description,type,options,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The job custom field definition was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CustomFieldDefinitionResultApiModel', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Job Custom Field Definition', - tags: ['Custom Field Definitions'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'get_job_custom_field_definition', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/departments': { - get: { - operationId: 'ats_list_departments', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,name,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - { - name: 'sync_token', - required: false, - in: 'query', - description: 'The sync token to select the only updated results', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of departments was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/DepartmentsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Departments', - tags: ['Departments'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'list_departments', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/departments/{id}': { - get: { - operationId: 'ats_get_department', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,name,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The department with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/DepartmentResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Department', - tags: ['Departments'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'get_department', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/interview_stages': { - get: { - deprecated: true, - operationId: 'ats_list_interview_stages', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,name,order,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - { - name: 'sync_token', - required: false, - in: 'query', - description: 'The sync token to select the only updated results', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of interview-stages was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InterviewStagesPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Interview Stages', - tags: ['Application Stages'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'list_interview_stages', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/interview_stages/{id}': { - get: { - deprecated: true, - operationId: 'ats_get_interview_stage', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,name,order,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The interview-stage with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InterviewStageResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Interview Stage', - tags: ['Application Stages'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'get_interview_stage', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/application_stages': { - get: { - operationId: 'ats_list_application_stages', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,name,order,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - { - name: 'sync_token', - required: false, - in: 'query', - description: 'The sync token to select the only updated results', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of application stages was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InterviewStagesPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Application Stages', - tags: ['Application Stages'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'list_application_stages', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/application_stages/{id}': { - get: { - operationId: 'ats_get_application_stage', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,name,order,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The application-stage with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InterviewStageResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Application Stage', - tags: ['Application Stages'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'get_application_stage', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/interviews': { - get: { - operationId: 'ats_list_interviews', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,application_id,remote_application_id,interview_stage_id,remote_interview_stage_id,interview_stage,status,interview_status,interviewer_ids,remote_interviewer_ids,interview_parts,interviewers,start_at,end_at,meeting_url,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'ATS Interviews Filter', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - created_after: { - description: - 'Use a string with a date to only select results created after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - { - name: 'sync_token', - required: false, - in: 'query', - description: 'The sync token to select the only updated results', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of interviews was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InterviewsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Interviews', - tags: ['Interviews'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'list_interviews', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/interviews/{id}': { - get: { - operationId: 'ats_get_interview', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,application_id,remote_application_id,interview_stage_id,remote_interview_stage_id,interview_stage,status,interview_status,interviewer_ids,remote_interviewer_ids,interview_parts,interviewers,start_at,end_at,meeting_url,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The interview with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InterviewsResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Interview', - tags: ['Interviews'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'get_interview', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/interviews/{id}/notes': { - post: { - operationId: 'ats_create_interview_note', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/AtsCreateNotesRequestDto', - }, - }, - }, - }, - responses: { - '201': { - description: 'Record created successfully.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CreateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Create Interview Note', - tags: ['Interviews', 'Notes'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'create_interview_note', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/interviews/{id}/notes/{subResourceId}': { - patch: { - operationId: 'ats_update_interview_note', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'subResourceId', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/AtsUpdateNotesRequestDto', - }, - }, - }, - }, - responses: { - '200': { - description: 'Record updated successfully.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UpdateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Update Interview Note', - tags: ['Interviews', 'Notes'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'update_interview_note', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/jobs': { - get: { - operationId: 'ats_list_jobs', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,code,title,description,status,job_status,department_ids,remote_department_ids,location_ids,remote_location_ids,hiring_team,interview_stages,confidential,custom_fields,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'ATS Jobs filters', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - created_after: { - description: - 'Use a string with a date to only select results created after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - status: { - description: 'The status of the job', - enum: ['open', 'draft', null], - nullable: true, - type: 'string', - deprecated: true, - }, - job_status: { - description: 'The job_status of the job', - enum: ['open', 'draft', null], - nullable: true, - type: 'string', - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - { - name: 'sync_token', - required: false, - in: 'query', - description: 'The sync token to select the only updated results', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'expand', - required: false, - in: 'query', - description: 'The comma separated list of fields that will be expanded in the response', - schema: { - nullable: true, - example: 'job_postings,interview_stages', - type: 'string', - }, - }, - { - name: 'include', - required: false, - in: 'query', - description: 'The comma separated list of fields that will be included in the response', - schema: { - nullable: true, - example: 'custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of jobs was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/AtsJobsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Jobs', - tags: ['Jobs'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'list_jobs', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - post: { - operationId: 'ats_create_job', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/AtsCreateJobRequestDto', - }, - }, - }, - }, - responses: { - '201': { - description: 'The job was successfully created.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CreateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Create Job', - tags: ['Jobs'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'create_job', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/jobs/{id}/application_stages': { - get: { - operationId: 'ats_list_job_application_stages', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,name,order,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - { - name: 'sync_token', - required: false, - in: 'query', - description: 'The sync token to select the only updated results', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - ], - responses: { - '200': { - description: - 'A list of all application stages that have been configured for the specified job.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ApplicationStagesPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Job Application Stages', - tags: ['Jobs', 'Application Stages'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'list_job_application_stages', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/jobs/{id}': { - get: { - operationId: 'ats_get_job', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,code,title,description,status,job_status,department_ids,remote_department_ids,location_ids,remote_location_ids,hiring_team,interview_stages,confidential,custom_fields,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'expand', - required: false, - in: 'query', - description: 'The comma separated list of fields that will be expanded in the response', - schema: { - nullable: true, - example: 'job_postings,interview_stages', - type: 'string', - }, - }, - { - name: 'include', - required: false, - in: 'query', - description: 'The comma separated list of fields that will be included in the response', - schema: { - nullable: true, - example: 'custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The job with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/AtsJobResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Job', - tags: ['Jobs'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'get_job', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - patch: { - operationId: 'ats_update_job', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/AtsUpdateJobRequestDto', - }, - }, - }, - }, - responses: { - '200': { - description: 'The job was successfully updated.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CreateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Update Job', - tags: ['Jobs'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'update_job', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/jobs/{id}/application_stages/{subResourceId}': { - get: { - operationId: 'ats_get_job_application_stage', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'subResourceId', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,name,order,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'A application stage that has been configured for the specified job.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ApplicationStageResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Job Application Stage', - tags: ['Jobs', 'Application Stages'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'get_job_application_stage', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/lists': { - get: { - operationId: 'ats_list_lists', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,name,created_at,updated_at,items,type,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The collection of lists was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ListsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get all Lists', - tags: ['Lists'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'list_lists', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/lists/{id}': { - get: { - operationId: 'ats_get_list', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,name,created_at,updated_at,items,type,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ListResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get List', - tags: ['Lists'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'get_list', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/locations': { - get: { - operationId: 'ats_list_locations', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,name,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - { - name: 'sync_token', - required: false, - in: 'query', - description: 'The sync token to select the only updated results', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of locations was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ATSLocationsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List locations', - tags: ['Locations'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'list_locations', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/locations/{id}': { - get: { - operationId: 'ats_get_location', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,name,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The location with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ATSLocationResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Location', - tags: ['Locations'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'get_location', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/rejected_reasons': { - get: { - operationId: 'ats_list_rejected_reasons', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,label,type,rejected_reason_type,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - { - name: 'sync_token', - required: false, - in: 'query', - description: 'The sync token to select the only updated results', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of rejected reasons was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RejectedReasonsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Rejected Reasons', - tags: ['Rejected Reasons'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'list_rejected_reasons', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/rejected_reasons/{id}': { - get: { - operationId: 'ats_get_rejected_reason', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,label,type,rejected_reason_type,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The rejected reason with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RejectedReasonResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Rejected Reason', - tags: ['Rejected Reasons'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'get_rejected_reason', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/users': { - get: { - operationId: 'ats_list_users', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,first_name,last_name,name,email,phone,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - { - name: 'sync_token', - required: false, - in: 'query', - description: 'The sync token to select the only updated results', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of users was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UsersPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Users', - tags: ['Users'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'list_users', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/users/{id}': { - get: { - operationId: 'ats_get_user', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,first_name,last_name,name,email,phone,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The user with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UserResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get User', - tags: ['Users'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'get_user', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/job_postings': { - get: { - operationId: 'ats_list_job_postings', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,title,locations,internal,status,job_id,remote_job_id,content,compensation,employment_type,employment_contract_type,external_url,external_apply_url,questionnaires,start_date,updated_at,created_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'ATS Job Postings Filter', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - created_after: { - description: - 'Use a string with a date to only select results created after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - { - name: 'sync_token', - required: false, - in: 'query', - description: 'The sync token to select the only updated results', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'include', - required: false, - in: 'query', - description: 'The comma separated list of fields that will be included in the response', - schema: { - nullable: true, - example: 'questionnaires', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of job postings was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/JobPostingsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Job Postings', - tags: ['Job Postings'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'list_job_postings', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/job_postings/{id}': { - get: { - operationId: 'ats_get_job_posting', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,title,locations,internal,status,job_id,remote_job_id,content,compensation,employment_type,employment_contract_type,external_url,external_apply_url,questionnaires,start_date,updated_at,created_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'include', - required: false, - in: 'query', - description: 'The comma separated list of fields that will be included in the response', - schema: { - nullable: true, - example: 'questionnaires', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The job with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/JobPostingResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Job Posting', - tags: ['Job Postings'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'get_job_posting', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/offers': { - get: { - operationId: 'ats_list_offers', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,application_id,remote_application_id,start_date,offer_status,salary,currency,created_at,updated_at,offer_history,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - { - name: 'sync_token', - required: false, - in: 'query', - description: 'The sync token to select the only updated results', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of offers was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/OffersPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Offers', - tags: ['Offers'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'list_offers', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - post: { - operationId: 'ats_create_offer', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/AtsCreateOfferRequestDto', - }, - }, - }, - }, - responses: { - '201': { - description: 'The offer was created successfully.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CreateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Create Offer', - tags: ['Offers'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'create_offer', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/offers/{id}': { - get: { - operationId: 'ats_get_offer', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,application_id,remote_application_id,start_date,offer_status,salary,currency,created_at,updated_at,offer_history,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The offer with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/OffersResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Offer', - tags: ['Offers'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'get_offer', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/assessments/packages': { - get: { - operationId: 'ats_list_assessments_packages', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields to return in the response (if empty, all fields are returned)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of assessments packages was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/AssessmentPackagePaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Assessments Packages', - tags: ['Assessments', 'Packages'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'list_assessments_packages', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/assessments/packages/{id}': { - get: { - operationId: 'ats_get_assessments_package', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields to return in the response (if empty, all fields are returned)', - schema: { - nullable: true, - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The assessments package with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/AssessmentPackageResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Assessments Package', - tags: ['Assessments', 'Packages'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'get_assessments_package', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/assessments/orders': { - post: { - operationId: 'ats_order_assessments_request', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/AtsCreateCandidatesAssessmentsRequestDto', - }, - }, - }, - }, - responses: { - '200': { - description: 'The order request of the assessment for candidate.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CreateAssessmentOrderResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Order Assessments Request', - tags: ['Assessments', 'Orders'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'order_assessments_request', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/assessments/orders/{id}/result': { - patch: { - operationId: 'ats_update_assessments_result', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/AtsUpdateCandidatesAssessmentsResultsRequestDto', - }, - }, - }, - }, - responses: { - '200': { - description: 'The result update of the assessment for candidate.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UpdateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Update Assessments Result', - tags: ['Assessments', 'Results'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'update_assessments_result', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/background_checks/packages': { - get: { - operationId: 'ats_list_background_check_packages', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,name,description,tests,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of background check packages was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BackgroundCheckPackagePaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Background Check Packages', - tags: ['Background Checks', 'Packages'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'list_background_check_packages', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - post: { - operationId: 'ats_create_background_check_package', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/AtsCreateBackgroundCheckPackagesRequestDto', - }, - }, - }, - }, - responses: { - '201': { - description: 'Record created successfully.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CreateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Create Background Check Package', - tags: ['Background Checks', 'Packages'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'create_background_check_package', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/background_checks/packages/{id}': { - get: { - operationId: 'ats_get_background_check_package', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,name,description,tests,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The background check package with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BackgroundCheckPackageResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Background Check Package', - tags: ['Background Checks', 'Packages'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'get_background_check_package', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - patch: { - operationId: 'ats_update_background_check_package', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/AtsUpdateBackgroundCheckPackagesRequestDto', - }, - }, - }, - }, - responses: { - '200': { - description: 'Record updated successfully.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UpdateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Update Background Check Package', - tags: ['Background Checks', 'Packages'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'update_background_check_package', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - delete: { - operationId: 'ats_delete_background_check_package', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'Record deleted successfully.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/DeleteResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Delete Background Check Package', - tags: ['Background Checks', 'Packages'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'delete_background_check_package', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/background_checks/orders': { - post: { - operationId: 'ats_order_background_check_request', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/AtsCreateBackgroundCheckOrderRequestDto', - }, - }, - }, - }, - responses: { - '200': { - description: 'The order request of the background check for candidate.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CreateBackgroundCheckOrderResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Order Background Check Request', - tags: ['Background Checks', 'Orders'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'order_background_check_request', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/background_checks/orders/{id}/result': { - patch: { - operationId: 'ats_update_background_check_result', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/AtsUpdateBackgroundCheckResultRequestDto', - }, - }, - }, - }, - responses: { - '200': { - description: 'The result update of the background check for candidate.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UpdateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Update Background Check Result', - tags: ['Background Checks', 'Results'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'update_background_check_result', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/documents/application_categories': { - get: { - operationId: 'ats_list_application_document_categories', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,name,active,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of application document categories were retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ReferencePaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Application Document Categories', - tags: ['Documents'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'list_application_document_categories', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ats/documents/application_categories/{id}': { - get: { - operationId: 'ats_get_application_document_category', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,name,active,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: - 'The application document category with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ReferenceResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Application Document Category', - tags: ['Documents'], - 'x-speakeasy-group': 'ats', - 'x-speakeasy-name-override': 'get_application_document_category', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - }, - info: { - title: 'ATS', - description: 'The documentation for the StackOne Unified API - ATS', - version: '1.0.0', - contact: {}, - }, - tags: [ - { - name: 'Application Changes', - description: - 'Chronological record of changes made to the application (this will only track changes for specific properties of the Application model).', - }, - { - name: 'Application Notes', - description: 'Notes or comments on applications.', - }, - { - name: 'Application Stages', - description: 'Stages of the job application process', - }, - { - name: 'Applications', - description: 'Job applications submitted by candidates.', - }, - { - name: 'Assessments', - description: 'Candidate assessments or tests.', - }, - { - name: 'Background Checks', - description: 'Background screening checks.', - }, - { - name: 'Candidates', - description: 'People applying for jobs.', - }, - { - name: 'Custom Field Definitions', - description: 'Definitions for custom fields on ATS resources.', - }, - { - name: 'Departments', - description: 'Departments within an organization.', - }, - { - name: 'Documents', - description: 'Files and documents related to candidates or jobs.', - }, - { - name: 'Interviews', - description: 'Scheduled interviews with candidates.', - }, - { - name: 'Job Postings', - description: 'Public job advertisements.', - }, - { - name: 'Jobs', - description: 'Open job positions.', - }, - { - name: 'Lists', - description: 'Lists for organizing candidates or jobs.', - }, - { - name: 'Locations', - description: 'Job or office locations.', - }, - { - name: 'Notes', - description: 'General notes or comments.', - }, - { - name: 'Offers', - description: 'Job offers extended to candidates.', - }, - { - name: 'Orders', - description: 'Orders for background checks or assessments.', - }, - { - name: 'Packages', - description: 'Assessment or offer packages.', - }, - { - name: 'Rejected Reasons', - description: 'Reasons for candidate rejection.', - }, - { - name: 'Results', - description: 'Results of assessments or background checks.', - }, - { - name: 'Scheduled Interviews', - description: 'Planned interview sessions.', - }, - { - name: 'Scorecards', - description: 'Evaluation scorecards for candidates.', - }, - { - name: 'Users', - description: 'System users with access to the ATS.', - }, - ], - servers: [ - { - url: 'https://api.stackone.com', - }, - ], - components: { - securitySchemes: { - basic: { - type: 'http', - scheme: 'basic', - }, - }, - schemas: { - Answer: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - type: { - description: 'Type of the answer', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/AnswerEnum', - }, - ], - }, - values: { - description: 'Values of the answer', - example: ['Yes', 'No Travel', 'It sounds pretty cool.', 'Excel', 'Power Point'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - }, - }, - AnswerEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'short_text', - 'long_text', - 'attachment', - 'multi_select', - 'single_select', - 'boolean', - 'number', - 'date', - 'video', - 'reference_check', - 'url', - 'unmapped_value', - null, - ], - description: 'The type of the answer.', - example: 'short_text', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - description: 'The source value of the answer type.', - example: 'Short Text', - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - Application: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - candidate_id: { - type: 'string', - description: 'Unique identifier of the candidate', - example: 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - nullable: true, - }, - remote_candidate_id: { - type: 'string', - description: "Provider's unique identifier of the candidate", - example: 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - nullable: true, - }, - job_id: { - type: 'string', - description: 'Unique identifier of the job', - example: '4071538b-3cac-4fbf-ac76-f78ed250ffdd', - nullable: true, - }, - remote_job_id: { - type: 'string', - description: "Provider's unique identifier of the job", - example: '4071538b-3cac-4fbf-ac76-f78ed250ffdd', - nullable: true, - }, - interview_stage: { - deprecated: true, - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/InterviewStage', - }, - ], - }, - application_stage: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/ApplicationStage', - }, - ], - }, - interview_stage_id: { - type: 'string', - description: 'Unique identifier of the interview stage', - example: '18bcbb1b-3cbc-4198-a999-460861d19480', - deprecated: true, - nullable: true, - }, - remote_interview_stage_id: { - type: 'string', - description: "Provider's unique identifier of the interview stage", - example: '18bcbb1b-3cbc-4198-a999-460861d19480', - deprecated: true, - nullable: true, - }, - application_stage_id: { - type: 'string', - description: 'Unique identifier of the application stage', - example: '18bcbb1b-3cbc-4198-a999-460861d19480', - nullable: true, - }, - remote_application_stage_id: { - type: 'string', - description: 'Unique identifier of the application stage', - example: '18bcbb1b-3cbc-4198-a999-460861d19480', - nullable: true, - }, - rejected_reasons: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RejectedReason', - }, - }, - rejected_reason_ids: { - description: 'Unique identifiers of the rejection reasons', - example: ['f223d7f6-908b-48f0-9237-b201c307f609'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - remote_rejected_reason_ids: { - description: "Provider's unique identifiers of the rejection reasons", - example: ['f223d7f6-908b-48f0-9237-b201c307f609'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - rejected_at: { - type: 'string', - description: 'Date of rejection', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - location_id: { - type: 'string', - description: 'Unique identifier of the location', - example: 'dd8d41d1-5eb8-4408-9c87-9ba44604eae4', - deprecated: true, - nullable: true, - }, - remote_location_id: { - type: 'string', - description: "Provider's unique identifier of the location", - example: 'dd8d41d1-5eb8-4408-9c87-9ba44604eae4', - deprecated: true, - nullable: true, - }, - location_ids: { - description: 'Unique identifiers of the locations', - example: ['dd8d41d1-5eb8-4408-9c87-9ba44604eae4'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - remote_location_ids: { - description: "Remote's unique identifiers of the locations", - example: ['dd8d41d1-5eb8-4408-9c87-9ba44604eae4'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - application_status: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/ApplicationStatusEnum', - }, - ], - }, - questionnaires: { - description: 'Questionnaires associated with the application', - example: { - id: 'right_to_work', - answers: [ - { - id: 'answer1', - type: 'text', - values: ['Yes'], - }, - ], - }, - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/Questionnaire', - }, - }, - candidate: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/ApplicationCandidate', - }, - ], - }, - attachments: { - deprecated: true, - description: 'Use `documents` expand instead', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/ApplicationAttachment', - }, - }, - documents: { - description: - 'The documents attached to this application (eg. resume, cover letter etc.)', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/AtsDocumentApiModel', - }, - }, - result_links: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/ResultLink', - }, - }, - source: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/Source', - }, - ], - }, - created_at: { - type: 'string', - description: 'Date of creation', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'Date of last update', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - custom_fields: { - description: 'The application custom fields', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/CustomFields', - }, - }, - }, - }, - ApplicationAttachment: { - type: 'object', - properties: { - file_name: { - type: 'string', - description: 'The file name of the attachment.', - example: 'resume.pdf', - nullable: true, - }, - content: { - type: 'string', - description: 'The content of the attachment.', - example: 'Base64 encoded content', - nullable: true, - }, - url: { - type: 'string', - description: 'The URL of the attachment.', - example: 'http://example.com/resume.pdf', - nullable: true, - }, - content_type: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/AttachmentContentType', - }, - ], - }, - }, - }, - ApplicationCandidate: { - type: 'object', - properties: { - name: { - type: 'string', - description: 'Candidate name', - example: 'Romain Sestier', - nullable: true, - }, - first_name: { - type: 'string', - description: 'First name of the candidate', - example: 'John', - nullable: true, - }, - last_name: { - type: 'string', - description: 'Last name of the candidate', - example: 'Doe', - nullable: true, - }, - email: { - type: 'string', - description: 'Email of the candidate', - example: 'john.doe@example.com', - nullable: true, - }, - emails: { - description: 'List of candidate emails', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/CandidateEmail', - }, - }, - phone_numbers: { - description: - 'List of candidate phone numbers including the type of the number when available', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/PhoneNumber', - }, - }, - social_links: { - description: 'List of candidate social links', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/SocialLink', - }, - }, - company: { - type: 'string', - description: 'Candidate company', - example: 'Company Inc.', - nullable: true, - }, - title: { - type: 'string', - description: 'Candidate title', - example: 'Software Engineer', - nullable: true, - }, - }, - }, - ApplicationChanges: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - created_at: { - type: 'string', - description: 'Timestamp when the change was created', - example: '2024-01-15T10:30:00Z', - format: 'date-time', - }, - effective_at: { - type: 'string', - description: 'Timestamp when the change became effective', - example: '2024-01-15T10:30:00Z', - format: 'date-time', - nullable: true, - }, - actor: { - description: 'The actor who made the change', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/ChangesActor', - }, - ], - }, - change_type: { - description: 'The type of change that occurred to the application', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/ApplicationChangeTypeEnum', - }, - ], - }, - new_values: { - description: - 'The new values for changed application properties. Only includes fields that commonly change over the application lifecycle.', - allOf: [ - { - $ref: '#/components/schemas/ApplicationChangesDataModel', - }, - ], - }, - }, - required: ['created_at', 'new_values'], - }, - ApplicationChangesDataModel: { - type: 'object', - properties: { - interview_stage_id: { - type: 'string', - description: 'Unique identifier of the interview stage', - example: '18bcbb1b-3cbc-4198-a999-460861d19480', - deprecated: true, - nullable: true, - }, - rejected_reason_ids: { - description: 'Unique identifiers of the rejection reasons', - example: ['f223d7f6-908b-48f0-9237-b201c307f609'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - application_status: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/ApplicationStatusEnum', - }, - ], - }, - }, - }, - ApplicationChangesPaginated: { - type: 'object', - properties: { - next: { - type: 'string', - nullable: true, - }, - data: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/ApplicationChanges', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - }, - ApplicationChangeTypeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'application_status', - 'interview_stage', - 'rejected_reasons', - 'unmapped_value', - null, - ], - description: 'The type of change that occurred to the application', - example: 'application_status', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - description: 'The source value of the change type', - example: 'StatusChange', - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - ApplicationResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/Application', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - ApplicationsPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/Application', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - ApplicationStage: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - name: { - type: 'string', - description: 'Application Stage name', - example: 'Review', - nullable: true, - }, - order: { - type: 'number', - description: 'Application Stage order', - example: '1', - nullable: true, - }, - created_at: { - type: 'string', - description: 'Application Stage created date', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'Application Stage updated date', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - }, - }, - ApplicationStageResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/ApplicationStage', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - ApplicationStagesPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/ApplicationStage', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - ApplicationStatusEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'active', - 'assessment', - 'background_check', - 'converted', - 'declined_by_candidate', - 'hired', - 'interview', - 'lead', - 'offer', - 'reference_check', - 'rejected', - 'review', - 'screen', - 'new', - 'onboarding', - 'created', - 'accepted', - 'short_list', - 'approved', - 'unmapped_value', - null, - ], - description: 'The status of the application.', - example: 'hired', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - description: 'The source value of the application status.', - example: 'Hired', - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - AssessmentPackage: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - description: 'Package name', - example: 'Test 1', - nullable: true, - }, - description: { - type: 'string', - description: 'Package description', - example: "Skills test to gauge a candidate's proficiency in job-specific skills", - nullable: true, - }, - }, - }, - AssessmentPackagePaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/AssessmentPackage', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - AssessmentPackageResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/AssessmentPackage', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - AssessmentTypeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'responsibilities', - 'skills', - 'benefits', - 'company_overview', - 'description', - 'other', - 'unmapped_value', - null, - ], - description: 'The type of the description.', - example: 'responsibilities', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - description: 'The source value of the description type.', - example: 'key_responsibilities', - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - AtsCreateApplicationRequestDto: { - type: 'object', - properties: { - passthrough: { - type: 'object', - description: 'Value to pass through to the provider', - example: { - other_known_names: 'John Doe', - }, - additionalProperties: true, - nullable: true, - }, - job_id: { - type: 'string', - description: 'Unique identifier of the job', - example: '4071538b-3cac-4fbf-ac76-f78ed250ffdd', - nullable: true, - }, - job_posting_id: { - type: 'string', - description: 'Unique identifier of the job posting that is associated with application', - example: '1c702a20-8de8-4d03-ac18-cbf4ac42eb51', - nullable: true, - }, - location_id: { - type: 'string', - description: 'Unique identifier of the location', - example: 'dd8d41d1-5eb8-4408-9c87-9ba44604eae4', - nullable: true, - }, - application_status: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/ApplicationStatusEnum', - }, - ], - }, - questionnaires: { - description: 'Questionnaires associated with the application', - example: { - id: 'right_to_work', - answers: [ - { - id: 'answer1', - type: 'text', - values: ['Yes'], - }, - ], - }, - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/CreateQuestionnaire', - }, - }, - source: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/CreateSource', - }, - ], - }, - candidate_id: { - type: 'string', - description: - 'Unique identifier of the candidate. Provide this OR candidate, but not both.', - example: 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - nullable: true, - }, - candidate: { - description: - 'Candidate Properties. Provide this OR candidate_id, but not both. Providing this attempts to create a new candidate with the application.', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/CreateCandidate', - }, - ], - }, - documents: { - description: - 'Document Properties. Providing this attempts to upload files with the application.', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/AtsDocumentsUploadRequestDto', - }, - }, - }, - }, - AtsCreateBackgroundCheckOrderRequestDto: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - application: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/OrderApplicationApiModel', - }, - ], - }, - job: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/OrderJobApiModel', - }, - ], - }, - candidate: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/OrderCandidateApiModel', - }, - ], - }, - requester: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/OrderJobHiringTeamApiModel', - }, - ], - }, - results_update_url: { - type: 'string', - description: 'Results update url', - example: 'https://exmaple.com/integrations/results/update', - nullable: true, - }, - package: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/OrderBackgroundCheckPackageApiModel', - }, - ], - }, - passthrough: { - type: 'object', - description: 'Value to pass through to the provider', - example: { - other_known_names: 'John Doe', - }, - additionalProperties: true, - nullable: true, - }, - }, - }, - AtsCreateBackgroundCheckPackagesRequestDto: { - type: 'object', - properties: { - name: { - type: 'string', - description: 'Package name', - example: 'Test 1', - nullable: true, - }, - description: { - type: 'string', - description: 'Package description', - example: "Skills test to gauge a candidate's proficiency in job-specific skills", - nullable: true, - }, - tests: { - description: 'Package tests', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/CreatePackage', - }, - }, - passthrough: { - type: 'object', - description: 'Value to pass through to the provider', - example: { - other_known_names: 'John Doe', - }, - additionalProperties: true, - nullable: true, - }, - }, - }, - AtsCreateCandidateRequestDto: { - type: 'object', - properties: { - passthrough: { - type: 'object', - description: 'Value to pass through to the provider', - example: { - other_known_names: 'John Doe', - }, - additionalProperties: true, - nullable: true, - }, - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - phone_number: { - type: 'string', - description: 'The candidate personal phone number', - example: '+1234567890', - deprecated: true, - nullable: true, - }, - phone_numbers: { - description: - 'List of candidate phone numbers including the type of the number when available', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/PhoneNumber', - }, - }, - name: { - type: 'string', - description: 'Candidate name', - example: 'Romain Sestier', - nullable: true, - }, - first_name: { - type: 'string', - description: 'Candidate first name', - example: 'Romain', - nullable: true, - }, - last_name: { - type: 'string', - description: 'Candidate last name', - example: 'Sestier', - nullable: true, - }, - email: { - type: 'string', - description: 'Candidate email', - example: 'sestier.romain123@gmail.com', - nullable: true, - }, - social_links: { - description: 'List of candidate social links', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/SocialLink', - }, - }, - company: { - type: 'string', - description: 'Candidate company', - example: 'Company Inc.', - nullable: true, - }, - title: { - type: 'string', - description: 'Candidate title', - example: 'Software Engineer', - nullable: true, - }, - hired_at: { - type: 'string', - description: 'Candidate hired date', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - country: { - type: 'string', - description: 'Candidate country', - example: 'United States', - nullable: true, - }, - custom_fields: { - description: 'The candidate custom fields', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/CustomFields', - }, - }, - }, - }, - AtsCreateCandidatesAssessmentsRequestDto: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - package: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/OrderPackageApiModel', - }, - ], - }, - application: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/OrderApplicationApiModel', - }, - ], - }, - job: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/OrderJobApiModel', - }, - ], - }, - candidate: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/OrderCandidateApiModel', - }, - ], - }, - requester: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/OrderJobHiringTeamApiModel', - }, - ], - }, - results_update_url: { - type: 'string', - description: 'Results update url', - example: 'https://exmaple.com/integrations/results/update', - nullable: true, - }, - passthrough: { - type: 'object', - description: 'Value to pass through to the provider', - example: { - other_known_names: 'John Doe', - }, - additionalProperties: true, - nullable: true, - }, - }, - }, - AtsCreateJobRequestDto: { - type: 'object', - properties: { - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - code: { - type: 'string', - description: 'Code of the job', - example: '184919', - nullable: true, - }, - title: { - type: 'string', - description: 'Title of the job', - example: 'Software Engineer', - nullable: true, - }, - description: { - type: 'string', - description: 'Description of the job', - example: 'Responsible for identifying business requirements', - nullable: true, - }, - status: { - type: 'string', - deprecated: true, - description: 'Status of the job', - example: 'archived', - nullable: true, - }, - job_status: { - description: 'Status of the job', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/AtsJobStatusEnum', - }, - ], - }, - department_ids: { - description: 'Department ids of the job', - example: ['308570', '308571', '308572'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - location_ids: { - description: 'Location ids of the job', - example: ['668570', '678571', '688572'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - hiring_team: { - description: 'Hiring team for the job.', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/AtsJobHiringTeam', - }, - }, - interview_stages: { - description: 'Interview stages for the job.', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/InterviewStage', - }, - }, - confidential: { - type: 'string', - description: 'Confidential status of the job', - enum: ['true', 'false', 'unmapped_value', null], - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - custom_fields: { - description: 'The job custom fields', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/CustomFields', - }, - }, - passthrough: { - type: 'object', - description: 'Value to pass through to the provider', - example: { - other_known_names: 'John Doe', - }, - additionalProperties: true, - nullable: true, - }, - }, - }, - AtsCreateNotesRequestDto: { - type: 'object', - properties: { - content: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/NoteContentApiModel', - }, - }, - author_id: { - type: 'string', - description: 'Unique identifier of the author', - example: '1234567890', - nullable: true, - }, - visibility: { - description: 'Visibility of the note', - example: 'public', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/NotesVisibilityEnum', - }, - ], - }, - passthrough: { - type: 'object', - description: 'Value to pass through to the provider', - example: { - other_known_names: 'John Doe', - }, - additionalProperties: true, - nullable: true, - }, - }, - }, - AtsCreateOfferRequestDto: { - type: 'object', - properties: { - application_id: { - type: 'string', - nullable: true, - }, - start_date: { - type: 'string', - description: 'Date of creation', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - offer_status: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/OfferStatusEnum', - }, - ], - }, - salary: { - type: 'number', - nullable: true, - }, - currency: { - type: 'string', - nullable: true, - }, - offer_history: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/OfferHistory', - }, - }, - passthrough: { - type: 'object', - description: 'Value to pass through to the provider', - example: { - other_known_names: 'John Doe', - }, - additionalProperties: true, - nullable: true, - }, - }, - }, - AtsDocumentApiModel: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - description: 'The name of the file', - example: 'My Document', - nullable: true, - }, - category: { - description: 'The category of the the document', - example: 'templates, forms, backups, etc.', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/FileCategoryEnumApiModel', - }, - ], - }, - contents: { - description: - 'The content of the file. Deprecated, use `url` and `file_format` one level up instead', - deprecated: true, - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/Content', - }, - }, - category_id: { - type: 'string', - description: 'The categoryId of the documents', - example: '6530', - nullable: true, - }, - created_at: { - type: 'string', - description: 'The creation date of the file', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'The update date of the file', - example: '2021-01-02T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - remote_url: { - type: 'string', - description: 'URL where the file content is located', - example: 'https://example.com/file.pdf', - nullable: true, - }, - file_format: { - description: 'The file format of the file', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/FileFormatEnum', - }, - ], - }, - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - type: { - description: 'The content type of the document', - deprecated: true, - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/AtsDocumentTypeEnum', - }, - ], - }, - }, - }, - AtsDocumentResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/AtsDocumentApiModel', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - AtsDocumentsPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/AtsDocumentApiModel', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - AtsDocumentsUploadCategoryEnumApiModel: { - type: 'object', - properties: { - value: { - type: 'string', - description: 'The category name to associate with the file', - enum: [ - 'resume', - 'avatar', - 'cover_letter', - 'profile_picture', - 'policy', - 'passport', - 'assessment', - 'interview_attachment', - 'take_home_test', - 'offer_letter', - 'signed_offer_letter', - 'national_id', - 'offer_packet', - 'other', - 'unmapped_value', - null, - ], - example: 'resume', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - type: 'string', - description: - 'The provider specific category for associating uploaded files, if provided, the value will be ignored.', - example: '550e8400-e29b-41d4-a716-446655440000', - nullable: true, - }, - }, - }, - AtsDocumentsUploadRequestDto: { - type: 'object', - properties: { - name: { - type: 'string', - description: 'The filename of the file to upload', - example: 'weather-forecast', - nullable: true, - }, - file_format: { - description: 'The file format of the file', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/FileFormatEnum', - }, - ], - }, - content: { - type: 'string', - description: 'The base64 encoded content of the file to upload', - example: - 'VGhpcyBpc24ndCByZWFsbHkgYSBzYW1wbGUgZmlsZSwgYnV0IG5vIG9uZSB3aWxsIGV2ZXIga25vdyE', - nullable: true, - }, - category_id: { - type: 'string', - description: 'The categoryId of the documents', - example: '6530', - nullable: true, - }, - path: { - type: 'string', - description: 'The path for the file to be uploaded to', - example: '/path/to/file', - nullable: true, - }, - confidential: { - description: 'The confidentiality level of the file to be uploaded', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/ConfidentialEnumApiModel', - }, - ], - }, - category: { - description: - 'The category to be associated with the file to be uploaded. Id will take precedence over name.', - example: { - name: 'resume', - id: '550e8400-e29b-41d4-a716-446655440000', - }, - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/AtsDocumentsUploadCategoryEnumApiModel', - }, - ], - }, - }, - }, - AtsDocumentTypeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - description: 'The category of the file', - nullable: true, - enum: [ - 'resume', - 'avatar', - 'cover_letter', - 'profile_picture', - 'policy', - 'passport', - 'assessment', - 'interview_attachment', - 'take_home_test', - 'offer_letter', - 'signed_offer_letter', - 'national_id', - 'offer_packet', - 'other', - 'unmapped_value', - null, - ], - 'x-speakeasy-unknown-values': 'allow', - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - AtsJob: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - code: { - type: 'string', - description: 'Code of the job', - example: '184919', - nullable: true, - }, - title: { - type: 'string', - description: 'Title of the job', - example: 'Software Engineer', - nullable: true, - }, - description: { - type: 'string', - description: 'Description of the job', - example: 'Responsible for identifying business requirements', - nullable: true, - }, - status: { - type: 'string', - deprecated: true, - description: 'Status of the job', - example: 'archived', - nullable: true, - }, - job_status: { - description: 'Status of the job', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/AtsJobStatusEnum', - }, - ], - }, - department_ids: { - description: 'Department ids of the job', - example: ['308570', '308571', '308572'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - remote_department_ids: { - description: "Provider's department ids of the job", - example: 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - location_ids: { - description: 'Location ids of the job', - example: ['668570', '678571', '688572'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - remote_location_ids: { - description: "Provider's location ids of the job", - example: ['668570', '678571', '688572'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - hiring_team: { - description: 'Hiring team for the job.', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/AtsJobHiringTeam', - }, - }, - interview_stages: { - description: 'Interview stages for the job.', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/InterviewStage', - }, - }, - confidential: { - type: 'string', - description: 'Confidential status of the job', - enum: ['true', 'false', 'unmapped_value', null], - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - custom_fields: { - description: 'The job custom fields', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/CustomFields', - }, - }, - created_at: { - type: 'string', - description: 'Date of creation', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'Date of last update', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - }, - }, - AtsJobHiringTeam: { - type: 'object', - properties: { - user_id: { - type: 'string', - example: '123456', - description: 'User ID of the hiring team member.', - nullable: true, - }, - remote_user_id: { - type: 'string', - description: "Provider's unique identifier of the user", - example: 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - nullable: true, - }, - first_name: { - type: 'string', - example: 'John', - description: 'First name of the hiring team member.', - nullable: true, - }, - last_name: { - type: 'string', - example: 'Doe', - description: 'Last name of the hiring team member.', - nullable: true, - }, - email: { - type: 'string', - example: 'john.doe@gmail.com', - description: 'Email of the hiring team member.', - nullable: true, - }, - role: { - type: 'string', - example: 'Software Engineer', - description: 'Role of the hiring team member.', - nullable: true, - }, - }, - }, - AtsJobResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/AtsJob', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - AtsJobsPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/AtsJob', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - AtsJobStatusEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'published', - 'draft', - 'pending', - 'internal', - 'archived', - 'closed', - 'open', - 'deleted', - 'on_hold', - 'unmapped_value', - null, - ], - description: 'The status of the job.', - example: 'published', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - description: 'The source value of the job status.', - example: 'Published', - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - ATSLocation: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - name: { - type: 'string', - nullable: true, - }, - }, - }, - ATSLocationResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/ATSLocation', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - ATSLocationsPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/ATSLocation', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - AtsMoveApplicationRequestDto: { - type: 'object', - properties: { - passthrough: { - type: 'object', - description: 'Value to pass through to the provider', - example: { - other_known_names: 'John Doe', - }, - additionalProperties: true, - nullable: true, - }, - interview_stage_id: { - type: 'string', - description: 'Unique identifier of the application stage.', - example: 'f223d7f6-908b-48f0-9237-b201c307f609', - nullable: true, - }, - }, - }, - AtsRejectApplicationRequestDto: { - type: 'object', - properties: { - passthrough: { - type: 'object', - description: 'Value to pass through to the provider', - example: { - other_known_names: 'John Doe', - }, - additionalProperties: true, - nullable: true, - }, - rejected_reason_id: { - type: 'string', - description: 'Unique identifier of the rejection reason', - example: 'f223d7f6-908b-48f0-9237-b201c307f609', - nullable: true, - }, - }, - }, - AtsUpdateApplicationRequestDto: { - type: 'object', - properties: { - passthrough: { - type: 'object', - description: 'Value to pass through to the provider', - example: { - other_known_names: 'John Doe', - }, - additionalProperties: true, - nullable: true, - }, - custom_fields: { - description: 'The application custom fields', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/CustomFields', - }, - }, - application_status: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/ApplicationStatusEnum', - }, - ], - }, - source: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/CreateSource', - }, - ], - }, - }, - }, - AtsUpdateBackgroundCheckPackagesRequestDto: { - type: 'object', - properties: { - name: { - type: 'string', - description: 'Package name', - example: 'Test 1', - nullable: true, - }, - description: { - type: 'string', - description: 'Package description', - example: "Skills test to gauge a candidate's proficiency in job-specific skills", - nullable: true, - }, - tests: { - description: 'Package tests', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/UpdatePackage', - }, - }, - passthrough: { - type: 'object', - description: 'Value to pass through to the provider', - example: { - other_known_names: 'John Doe', - }, - additionalProperties: true, - nullable: true, - }, - }, - }, - AtsUpdateBackgroundCheckResultRequestDto: { - type: 'object', - properties: { - score: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/ScoreApiModel', - }, - ], - }, - start_date: { - type: 'string', - description: 'The start date of the candidate test', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - submission_date: { - type: 'string', - description: 'The submission date of the candidate test', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - summary: { - type: 'string', - description: 'The summary about the result of the test', - example: 'Test is passed', - nullable: true, - }, - result: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/ResultEnum', - }, - ], - }, - result_url: { - type: 'string', - description: 'The test`s result url', - example: 'https://exmaple.com/result?id=xyz', - nullable: true, - }, - attachments: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/Attachment', - }, - }, - candidate: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/UpdateResultCandidateApiModel', - }, - ], - }, - passthrough: { - type: 'object', - description: 'Value to pass through to the provider', - example: { - other_known_names: 'John Doe', - }, - additionalProperties: true, - nullable: true, - }, - }, - }, - AtsUpdateCandidateRequestDto: { - type: 'object', - properties: { - passthrough: { - type: 'object', - description: 'Value to pass through to the provider', - example: { - other_known_names: 'John Doe', - }, - additionalProperties: true, - nullable: true, - }, - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - name: { - type: 'string', - description: 'Candidate name', - example: 'Romain Sestier', - nullable: true, - }, - first_name: { - type: 'string', - description: 'Candidate first name', - example: 'Romain', - nullable: true, - }, - last_name: { - type: 'string', - description: 'Candidate last name', - example: 'Sestier', - nullable: true, - }, - email: { - type: 'string', - description: 'Candidate email', - example: 'sestier.romain123@gmail.com', - nullable: true, - }, - emails: { - description: 'List of candidate emails', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/CandidateEmail', - }, - }, - social_links: { - description: 'List of candidate social links', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/SocialLink', - }, - }, - phone: { - type: 'string', - description: 'Candidate phone number', - example: '+16178294093', - deprecated: true, - nullable: true, - }, - phone_numbers: { - description: - 'List of candidate phone numbers including the type of the number when available', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/PhoneNumber', - }, - }, - company: { - type: 'string', - description: 'Candidate company', - example: 'Company Inc.', - nullable: true, - }, - title: { - type: 'string', - description: 'Candidate title', - example: 'Software Engineer', - nullable: true, - }, - application_ids: { - description: 'List of candidate application IDs', - example: [ - '123e4567-e89b-12d3-a456-426614174000', - '523e1234-e89b-fdd2-a456-762545121101', - ], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - hired_at: { - type: 'string', - description: 'Candidate hired date', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - country: { - type: 'string', - description: 'Candidate country', - example: 'United States', - nullable: true, - }, - custom_fields: { - description: 'The candidate custom fields', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/CustomFields', - }, - }, - }, - }, - AtsUpdateCandidatesAssessmentsResultsRequestDto: { - type: 'object', - properties: { - score: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/ScoreApiModel', - }, - ], - }, - start_date: { - type: 'string', - description: 'The start date of the candidate test', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - submission_date: { - type: 'string', - description: 'The submission date of the candidate test', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - summary: { - type: 'string', - description: 'The summary about the result of the test', - example: 'Test is passed', - nullable: true, - }, - result: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/ResultEnum', - }, - ], - }, - result_url: { - type: 'string', - description: 'The test`s result url', - example: 'https://exmaple.com/result?id=xyz', - nullable: true, - }, - attachments: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/Attachment', - }, - }, - candidate: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/UpdateResultCandidateApiModel', - }, - ], - }, - passthrough: { - type: 'object', - description: 'Value to pass through to the provider', - example: { - other_known_names: 'John Doe', - }, - additionalProperties: true, - nullable: true, - }, - }, - }, - AtsUpdateJobRequestDto: { - type: 'object', - properties: { - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - code: { - type: 'string', - description: 'Code of the job', - example: '184919', - nullable: true, - }, - title: { - type: 'string', - description: 'Title of the job', - example: 'Software Engineer', - nullable: true, - }, - description: { - type: 'string', - description: 'Description of the job', - example: 'Responsible for identifying business requirements', - nullable: true, - }, - status: { - type: 'string', - deprecated: true, - description: 'Status of the job', - example: 'archived', - nullable: true, - }, - job_status: { - description: 'Status of the job', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/AtsJobStatusEnum', - }, - ], - }, - department_ids: { - description: 'Department ids of the job', - example: ['308570', '308571', '308572'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - location_ids: { - description: 'Location ids of the job', - example: ['668570', '678571', '688572'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - hiring_team: { - description: 'Hiring team for the job.', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/AtsJobHiringTeam', - }, - }, - interview_stages: { - description: 'Interview stages for the job.', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/InterviewStage', - }, - }, - confidential: { - type: 'string', - description: 'Confidential status of the job', - enum: ['true', 'false', 'unmapped_value', null], - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - custom_fields: { - description: 'The job custom fields', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/CustomFields', - }, - }, - passthrough: { - type: 'object', - description: 'Value to pass through to the provider', - example: { - other_known_names: 'John Doe', - }, - additionalProperties: true, - nullable: true, - }, - }, - }, - AtsUpdateNotesRequestDto: { - type: 'object', - properties: { - content: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/NoteContentApiModel', - }, - }, - author_id: { - type: 'string', - description: 'Unique identifier of the author', - example: '1234567890', - nullable: true, - }, - visibility: { - description: 'Visibility of the note', - example: 'public', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/NotesVisibilityEnum', - }, - ], - }, - passthrough: { - type: 'object', - description: 'Value to pass through to the provider', - example: { - other_known_names: 'John Doe', - }, - additionalProperties: true, - nullable: true, - }, - }, - }, - Attachment: { - type: 'object', - properties: { - url: { - type: 'string', - description: 'The URL of the attachment.', - example: 'http://example.com/resume.pdf', - nullable: true, - }, - content_type: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/AttachmentContentType', - }, - ], - }, - }, - }, - AttachmentContentType: { - type: 'object', - properties: { - value: { - type: 'string', - enum: ['text', 'pdf', 'video', 'other', 'unmapped_value', null], - description: 'The content type of the attachment.', - example: 'text', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - description: 'The source value of the content type.', - example: 'Text', - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - BackgroundCheckPackage: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - description: 'Package name', - example: 'Test 1', - nullable: true, - }, - description: { - type: 'string', - description: 'Package description', - example: "Skills test to gauge a candidate's proficiency in job-specific skills", - nullable: true, - }, - tests: { - description: 'Package tests', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/Package', - }, - }, - }, - }, - BackgroundCheckPackagePaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/BackgroundCheckPackage', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - BackgroundCheckPackageResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/BackgroundCheckPackage', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - BadGatewayResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 502, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Bad Gateway', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - BadRequestResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 400, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Bad Request', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - data: { - description: 'Error details', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/UnifiedError', - }, - ], - }, - provider_errors: { - description: 'List of provider-specific errors', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/ProviderError', - }, - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - Candidate: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - name: { - type: 'string', - description: 'Candidate name', - example: 'Romain Sestier', - nullable: true, - }, - first_name: { - type: 'string', - description: 'Candidate first name', - example: 'Romain', - nullable: true, - }, - last_name: { - type: 'string', - description: 'Candidate last name', - example: 'Sestier', - nullable: true, - }, - email: { - type: 'string', - description: 'Candidate email', - example: 'sestier.romain123@gmail.com', - nullable: true, - }, - emails: { - description: 'List of candidate emails', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/CandidateEmail', - }, - }, - social_links: { - description: 'List of candidate social links', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/SocialLink', - }, - }, - phone: { - type: 'string', - description: 'Candidate phone number', - example: '+16178294093', - deprecated: true, - nullable: true, - }, - phone_numbers: { - description: - 'List of candidate phone numbers including the type of the number when available', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/PhoneNumber', - }, - }, - company: { - type: 'string', - description: 'Candidate company', - example: 'Company Inc.', - nullable: true, - }, - title: { - type: 'string', - description: 'Candidate title', - example: 'Software Engineer', - nullable: true, - }, - application_ids: { - description: 'List of candidate application IDs', - example: [ - '123e4567-e89b-12d3-a456-426614174000', - '523e1234-e89b-fdd2-a456-762545121101', - ], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - remote_application_ids: { - description: "Provider's list of candidate application IDs", - example: [ - '123e4567-e89b-12d3-a456-426614174000', - '523e1234-e89b-fdd2-a456-762545121101', - ], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - hired_at: { - type: 'string', - description: 'Candidate hired date', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - country: { - type: 'string', - description: 'Candidate country', - example: 'United States', - nullable: true, - }, - custom_fields: { - description: 'The candidate custom fields', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/CustomFields', - }, - }, - tags: { - description: 'List of candidate tags indicating metadata associated with the candidate', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/Tag', - }, - }, - created_at: { - type: 'string', - description: 'Candidate created date', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'Candidate updated date', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - }, - }, - CandidateEmail: { - type: 'object', - properties: { - type: { - type: 'string', - description: 'Type of the email', - example: 'personal', - nullable: true, - }, - value: { - type: 'string', - description: 'Email value', - example: 'sestier.romain123@gmail.com', - nullable: true, - }, - }, - }, - CandidateResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/Candidate', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - CandidatesPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/Candidate', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - ChangesActor: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - }, - }, - CompensationTypeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'salary', - 'hourly', - 'commission', - 'bonus', - 'equity', - 'other', - 'unmapped_value', - null, - ], - description: 'The type of the compensation.', - example: 'salary', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - description: 'The source value of the compensation type.', - example: 'Salary', - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - ConditionTypeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: ['equals_to', 'contains', 'unmapped_value', null], - description: "The type of the question's condition", - example: 'equals_to', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - description: "The source value of the question's condition type", - example: 'EqualsTo', - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - ConfidentialEnumApiModel: { - type: 'object', - properties: { - value: { - type: 'string', - description: 'Whether the file is confidential or not', - enum: ['true', 'false', 'unmapped_value', null], - example: 'true', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - example: 'public', - nullable: true, - }, - }, - }, - ConflictResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 409, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Conflict', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - Content: { - type: 'object', - properties: { - url: { - type: 'string', - description: 'URL where the file content is located', - example: 'https://example.com/file.pdf', - nullable: true, - }, - unified_url: { - type: 'string', - description: 'Unified download URL for retrieving file content.', - example: - 'https://api.stackone.com/unified/hris/employees/12345/documents/67890/download', - nullable: true, - }, - file_format: { - description: 'The file format of the file', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/FileFormatEnum', - }, - ], - }, - }, - }, - CreateAnswer: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - type: { - description: 'Type of the answer', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/AnswerEnum', - }, - ], - }, - values: { - description: 'Values of the answer', - example: ['Yes', 'No Travel', 'It sounds pretty cool.', 'Excel', 'Power Point'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - }, - }, - CreateAssessmentOrderResult: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - test_url: { - type: 'string', - description: 'Test url', - example: 'https://exmaple.com/integrations/candidate/test', - nullable: true, - }, - }, - }, - CreateBackgroundCheckOrderResult: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - test_url: { - type: 'string', - description: 'Test url', - example: 'https://exmaple.com/integrations/candidate/test', - nullable: true, - }, - }, - }, - CreateCandidate: { - type: 'object', - properties: { - passthrough: { - type: 'object', - description: 'Value to pass through to the provider', - example: { - other_known_names: 'John Doe', - }, - additionalProperties: true, - nullable: true, - }, - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - phone_number: { - type: 'string', - description: 'The candidate personal phone number', - example: '+1234567890', - deprecated: true, - nullable: true, - }, - phone_numbers: { - description: - 'List of candidate phone numbers including the type of the number when available', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/PhoneNumber', - }, - }, - name: { - type: 'string', - description: 'Candidate name', - example: 'Romain Sestier', - nullable: true, - }, - first_name: { - type: 'string', - description: 'Candidate first name', - example: 'Romain', - nullable: true, - }, - last_name: { - type: 'string', - description: 'Candidate last name', - example: 'Sestier', - nullable: true, - }, - email: { - type: 'string', - description: 'Candidate email', - example: 'sestier.romain123@gmail.com', - nullable: true, - }, - social_links: { - description: 'List of candidate social links', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/SocialLink', - }, - }, - company: { - type: 'string', - description: 'Candidate company', - example: 'Company Inc.', - nullable: true, - }, - title: { - type: 'string', - description: 'Candidate title', - example: 'Software Engineer', - nullable: true, - }, - hired_at: { - type: 'string', - description: 'Candidate hired date', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - country: { - type: 'string', - description: 'Candidate country', - example: 'United States', - nullable: true, - }, - custom_fields: { - description: 'The candidate custom fields', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/CustomFields', - }, - }, - }, - }, - CreatePackage: { - type: 'object', - properties: { - name: { - type: 'string', - description: 'Package name', - example: 'Test 1', - nullable: true, - }, - description: { - type: 'string', - description: 'Package description', - example: "Skills test to gauge a candidate's proficiency in job-specific skills", - nullable: true, - }, - }, - }, - CreateQuestionnaire: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - answers: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/CreateAnswer', - }, - }, - }, - }, - CreateResult: { - type: 'object', - properties: { - statusCode: { - type: 'number', - example: 201, - }, - message: { - type: 'string', - example: 'Record created successfully.', - }, - timestamp: { - type: 'string', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - }, - data: { - $ref: '#/components/schemas/CreateResultDataApiModel', - }, - }, - required: ['statusCode', 'message', 'timestamp', 'data'], - }, - CreateResultDataApiModel: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - }, - }, - CreateSource: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - description: 'The source of the application', - example: 'LinkedIn', - nullable: true, - }, - }, - }, - CustomFieldDefinition: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - nullable: true, - }, - description: { - type: 'string', - nullable: true, - }, - type: { - description: 'The type of the custom field.', - example: 'Dropdown', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/CustomFieldTypeEnum', - }, - ], - }, - options: { - description: 'An array of possible options for the custom field.', - example: [ - { - id: 'option_1', - value: 'Not Started', - }, - { - id: 'option_2', - value: 'In Progress', - }, - { - id: 'option_3', - value: 'Completed', - }, - ], - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/CustomFieldOption', - }, - }, - }, - }, - CustomFieldDefinitionResultApiModel: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/CustomFieldDefinition', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - CustomFieldDefinitionsPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/CustomFieldDefinition', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - CustomFieldOption: { - type: 'object', - properties: { - id: { - type: 'string', - description: - 'The unique identifier for the option to be used when updating the custom field', - example: 'option_123', - }, - value: { - description: 'The human readable value of the option', - example: 'Not Started', - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - }, - }, - required: ['id', 'value'], - }, - CustomFields: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - description: 'The name of the custom field.', - example: 'Training Completion Status', - nullable: true, - }, - value: { - description: 'The value associated with the custom field.', - example: 'Completed', - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - { - type: 'string', - format: 'date-time', - }, - ], - nullable: true, - }, - value_id: { - type: 'string', - description: 'The unique identifier for the value of the custom field.', - example: 'value_456', - nullable: true, - }, - remote_value_id: { - type: 'string', - description: "Provider's unique identifier for the value of the custom field.", - example: 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - nullable: true, - }, - }, - }, - CustomFieldTypeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'date', - 'float', - 'integer', - 'list', - 'checkbox', - 'text', - 'boolean', - 'single_select', - 'multi_select', - 'url', - 'other', - 'unmapped_value', - null, - ], - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - DeleteResult: { - type: 'object', - properties: { - statusCode: { - type: 'number', - example: 204, - }, - message: { - type: 'string', - example: 'Record deleted successfully.', - }, - timestamp: { - type: 'string', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - Department: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - name: { - type: 'string', - nullable: true, - }, - }, - }, - DepartmentResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/Department', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - DepartmentsPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/Department', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - DownloadApiModel: { - type: 'object', - properties: { - headers: { - description: 'Headers related to the download', - allOf: [ - { - $ref: '#/components/schemas/DownloadHeadersApiModel', - }, - ], - }, - data: { - type: 'string', - description: 'The file data in binary format', - format: 'binary', - }, - }, - required: ['headers', 'data'], - }, - DownloadHeadersApiModel: { - type: 'object', - properties: { - 'content-disposition': { - type: 'string', - description: 'Value of the Content-Disposition header', - example: 'attachment; filename="example.pdf"', - nullable: true, - }, - 'content-type': { - type: 'string', - description: 'MIME type of the file', - example: 'application/pdf', - nullable: true, - }, - 'content-length': { - type: 'number', - description: 'Size of the content in bytes', - example: 1024, - nullable: true, - }, - 'content-range': { - type: 'string', - description: 'Range of the content being sent', - example: 'bytes 0-1023/2048', - nullable: true, - }, - 'content-encoding': { - type: 'string', - description: 'Encoding of the content', - example: 'gzip', - nullable: true, - }, - 'transfer-encoding': { - type: 'string', - description: 'Transfer encoding type', - example: 'chunked', - nullable: true, - }, - }, - }, - EmploymentContractTypeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: ['full_time', 'shifts', 'part_time', 'unmapped_value', null], - description: 'The employment contract type.', - example: 'full_time', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - description: 'The source value of the employment contract type.', - example: 'FullTime', - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - EmploymentTypeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'contractor', - 'intern', - 'permanent', - 'apprentice', - 'freelance', - 'terminated', - 'temporary', - 'seasonal', - 'volunteer', - 'probation', - 'internal', - 'external', - 'expatriate', - 'employer_of_record', - 'casual', - 'Programme', - 'unmapped_value', - null, - ], - description: 'The type of the employment.', - example: 'permanent', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - description: 'The source value of the employment type.', - example: 'Permanent', - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - Field: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - label: { - type: 'string', - description: 'The label of the field', - example: 'Problem Solving', - nullable: true, - }, - type: { - type: 'string', - description: 'The type of the field', - example: 'text', - enum: [ - 'short_text', - 'long_text', - 'multi_select', - 'single_select', - 'boolean', - 'number', - 'date', - 'phone', - 'email', - 'score', - 'location', - 'unmapped_value', - null, - ], - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - values: { - description: 'The possible values for the field', - example: ['Excellent', 'Good', 'Average', 'Poor'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - required: { - description: 'Indicates if the field is required', - example: true, - oneOf: [ - { - type: 'boolean', - }, - { - type: 'string', - enum: ['true', 'false'], - }, - ], - nullable: true, - }, - }, - }, - FileCategoryEnumApiModel: { - type: 'object', - properties: { - value: { - type: 'string', - description: 'The category of the file', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - FileFormatEnum: { - type: 'object', - properties: { - value: { - type: 'string', - description: 'The file format of the file, expressed as a file extension', - enum: [ - 'unmapped_value', - 'ez', - 'aw', - 'atom', - 'atomcat', - 'atomdeleted', - 'atomsvc', - 'dwd', - 'held', - 'rsat', - 'bdoc', - 'xcs', - 'ccxml', - 'cdfx', - 'cdmia', - 'cdmic', - 'cdmid', - 'cdmio', - 'cdmiq', - 'cu', - 'mpd', - 'davmount', - 'dbk', - 'dssc', - 'xdssc', - 'es', - 'ecma', - 'emma', - 'emotionml', - 'epub', - 'exi', - 'exp', - 'fdt', - 'pfr', - 'geojson', - 'gml', - 'gpx', - 'gxf', - 'gz', - 'hjson', - 'stk', - 'ink', - 'inkml', - 'ipfix', - 'its', - 'jar', - 'war', - 'ear', - 'ser', - 'class', - 'js', - 'mjs', - 'json', - 'map', - 'json5', - 'jsonml', - 'jsonld', - 'lgr', - 'lostxml', - 'hqx', - 'cpt', - 'mads', - 'webmanifest', - 'mrc', - 'mrcx', - 'ma', - 'nb', - 'mb', - 'mathml', - 'mbox', - 'mscml', - 'metalink', - 'meta4', - 'mets', - 'maei', - 'musd', - 'mods', - 'm21', - 'mp21', - 'mp4s', - 'm4p', - 'doc', - 'dot', - 'mxf', - 'nq', - 'nt', - 'cjs', - 'bin', - 'dms', - 'lrf', - 'mar', - 'so', - 'dist', - 'distz', - 'pkg', - 'bpk', - 'dump', - 'elc', - 'deploy', - 'exe', - 'dll', - 'deb', - 'dmg', - 'iso', - 'img', - 'msi', - 'msp', - 'msm', - 'buffer', - 'oda', - 'opf', - 'ogx', - 'omdoc', - 'onetoc', - 'onetoc2', - 'onetmp', - 'onepkg', - 'oxps', - 'relo', - 'xer', - 'pdf', - 'pgp', - 'asc', - 'sig', - 'prf', - 'p10', - 'p7m', - 'p7c', - 'p7s', - 'p8', - 'ac', - 'cer', - 'crl', - 'pkipath', - 'pki', - 'pls', - 'ai', - 'eps', - 'ps', - 'provx', - 'pskcxml', - 'raml', - 'rdf', - 'owl', - 'rif', - 'rnc', - 'rl', - 'rld', - 'rs', - 'rapd', - 'sls', - 'rusd', - 'gbr', - 'mft', - 'roa', - 'rsd', - 'rss', - 'rtf', - 'sbml', - 'scq', - 'scs', - 'spq', - 'spp', - 'sdp', - 'senmlx', - 'sensmlx', - 'setpay', - 'setreg', - 'shf', - 'siv', - 'sieve', - 'smi', - 'smil', - 'rq', - 'srx', - 'gram', - 'grxml', - 'sru', - 'ssdl', - 'ssml', - 'swidtag', - 'tei', - 'teicorpus', - 'tfi', - 'tsd', - 'toml', - 'trig', - 'ttml', - 'ubj', - 'rsheet', - 'td', - 'vxml', - 'wasm', - 'wgt', - 'hlp', - 'wsdl', - 'wspolicy', - 'xaml', - 'xav', - 'xca', - 'xdf', - 'xel', - 'xns', - 'xenc', - 'xhtml', - 'xht', - 'xlf', - 'xml', - 'xsl', - 'xsd', - 'rng', - 'dtd', - 'xop', - 'xpl', - '*xsl', - 'xslt', - 'xspf', - 'mxml', - 'xhvml', - 'xvml', - 'xvm', - 'yang', - 'yin', - 'zip', - '*3gpp', - 'adp', - 'amr', - 'au', - 'snd', - 'mid', - 'midi', - 'kar', - 'rmi', - 'mxmf', - '*mp3', - 'm4a', - 'mp4a', - 'mpga', - 'mp2', - 'mp2a', - 'mp3', - 'm2a', - 'm3a', - 'oga', - 'ogg', - 'spx', - 'opus', - 's3m', - 'sil', - 'wav', - '*wav', - 'weba', - 'xm', - 'ttc', - 'otf', - 'ttf', - 'woff', - 'woff2', - 'exr', - 'apng', - 'avif', - 'bmp', - 'cgm', - 'drle', - 'emf', - 'fits', - 'g3', - 'gif', - 'heic', - 'heics', - 'heif', - 'heifs', - 'hej2', - 'hsj2', - 'ief', - 'jls', - 'jp2', - 'jpg2', - 'jpeg', - 'jpg', - 'jpe', - 'jph', - 'jhc', - 'jpm', - 'jpx', - 'jpf', - 'jxr', - 'jxra', - 'jxrs', - 'jxs', - 'jxsc', - 'jxsi', - 'jxss', - 'ktx', - 'ktx2', - 'png', - 'sgi', - 'svg', - 'svgz', - 't38', - 'tif', - 'tiff', - 'tfx', - 'webp', - 'wmf', - 'disposition-notification', - 'u8msg', - 'u8dsn', - 'u8mdn', - 'u8hdr', - 'eml', - 'mime', - '3mf', - 'gltf', - 'glb', - 'igs', - 'iges', - 'msh', - 'mesh', - 'silo', - 'mtl', - 'obj', - 'stpx', - 'stpz', - 'stpxz', - 'stl', - 'wrl', - 'vrml', - '*x3db', - 'x3dbz', - 'x3db', - '*x3dv', - 'x3dvz', - 'x3d', - 'x3dz', - 'x3dv', - 'appcache', - 'manifest', - 'ics', - 'ifb', - 'coffee', - 'litcoffee', - 'css', - 'csv', - 'html', - 'htm', - 'shtml', - 'jade', - 'jsx', - 'less', - 'markdown', - 'md', - 'mml', - 'mdx', - 'n3', - 'txt', - 'text', - 'conf', - 'def', - 'list', - 'log', - 'in', - 'ini', - 'rtx', - '*rtf', - 'sgml', - 'sgm', - 'shex', - 'slim', - 'slm', - 'spdx', - 'stylus', - 'styl', - 'tsv', - 't', - 'tr', - 'roff', - 'man', - 'me', - 'ms', - 'ttl', - 'uri', - 'uris', - 'urls', - 'vcard', - 'vtt', - '*xml', - 'yaml', - 'yml', - '3gp', - '3gpp', - '3g2', - 'h261', - 'h263', - 'h264', - 'm4s', - 'jpgv', - '*jpm', - 'jpgm', - 'mj2', - 'mjp2', - 'ts', - 'mp4', - 'mp4v', - 'mpg4', - 'mpeg', - 'mpg', - 'mpe', - 'm1v', - 'm2v', - 'ogv', - 'qt', - 'mov', - 'webm', - 'cww', - '1km', - 'plb', - 'psb', - 'pvb', - 'tcap', - 'pwn', - 'aso', - 'imp', - 'acu', - 'atc', - 'acutc', - 'air', - 'fcdt', - 'fxp', - 'fxpl', - 'xdp', - 'xfdf', - 'ahead', - 'azf', - 'azs', - 'azw', - 'acc', - 'ami', - 'apk', - 'cii', - 'fti', - 'atx', - 'mpkg', - 'key', - 'm3u8', - 'numbers', - 'pages', - 'pkpass', - 'swi', - 'iota', - 'aep', - 'bmml', - 'mpm', - 'bmi', - 'rep', - 'cdxml', - 'mmd', - 'cdy', - 'csl', - 'cla', - 'rp9', - 'c4g', - 'c4d', - 'c4f', - 'c4p', - 'c4u', - 'c11amc', - 'c11amz', - 'csp', - 'cdbcmsg', - 'cmc', - 'clkx', - 'clkk', - 'clkp', - 'clkt', - 'clkw', - 'wbs', - 'pml', - 'ppd', - 'car', - 'pcurl', - 'dart', - 'rdz', - 'dbf', - 'uvf', - 'uvvf', - 'uvd', - 'uvvd', - 'uvt', - 'uvvt', - 'uvx', - 'uvvx', - 'uvz', - 'uvvz', - 'fe_launch', - 'dna', - 'mlp', - 'mle', - 'dpg', - 'dfac', - 'kpxx', - 'ait', - 'svc', - 'geo', - 'mag', - 'nml', - 'esf', - 'msf', - 'qam', - 'slt', - 'ssf', - 'es3', - 'et3', - 'ez2', - 'ez3', - 'fdf', - 'mseed', - 'seed', - 'dataless', - 'gph', - 'ftc', - 'fm', - 'frame', - 'maker', - 'book', - 'fnc', - 'ltf', - 'fsc', - 'oas', - 'oa2', - 'oa3', - 'fg5', - 'bh2', - 'ddd', - 'xdw', - 'xbd', - 'fzs', - 'txd', - 'ggb', - 'ggt', - 'gex', - 'gre', - 'gxt', - 'g2w', - 'g3w', - 'gmx', - 'gdoc', - 'gslides', - 'gsheet', - 'kml', - 'kmz', - 'gqf', - 'gqs', - 'gac', - 'ghf', - 'gim', - 'grv', - 'gtm', - 'tpl', - 'vcg', - 'hal', - 'zmm', - 'hbci', - 'les', - 'hpgl', - 'hpid', - 'hps', - 'jlt', - 'pcl', - 'pclxl', - 'sfd-hdstx', - 'mpy', - 'afp', - 'listafp', - 'list3820', - 'irm', - 'sc', - 'icc', - 'icm', - 'igl', - 'ivp', - 'ivu', - 'igm', - 'xpw', - 'xpx', - 'i2g', - 'qbo', - 'qfx', - 'rcprofile', - 'irp', - 'xpr', - 'fcs', - 'jam', - 'rms', - 'jisp', - 'joda', - 'ktz', - 'ktr', - 'karbon', - 'chrt', - 'kfo', - 'flw', - 'kon', - 'kpr', - 'kpt', - 'ksp', - 'kwd', - 'kwt', - 'htke', - 'kia', - 'kne', - 'knp', - 'skp', - 'skd', - 'skt', - 'skm', - 'sse', - 'lasxml', - 'lbd', - 'lbe', - 'apr', - 'pre', - 'nsf', - 'org', - 'scm', - 'lwp', - 'portpkg', - 'mvt', - 'mcd', - 'mc1', - 'cdkey', - 'mwf', - 'mfm', - 'flo', - 'igx', - 'mif', - 'daf', - 'dis', - 'mbk', - 'mqy', - 'msl', - 'plc', - 'txf', - 'mpn', - 'mpc', - 'xul', - 'cil', - 'cab', - 'xls', - 'xlm', - 'xla', - 'xlc', - 'xlt', - 'xlw', - 'xlam', - 'xlsb', - 'xlsm', - 'xltm', - 'eot', - 'chm', - 'ims', - 'lrm', - 'thmx', - 'msg', - 'cat', - '*stl', - 'ppt', - 'pps', - 'pot', - 'ppam', - 'pptm', - 'sldm', - 'ppsm', - 'potm', - 'mpp', - 'mpt', - 'docm', - 'dotm', - 'wps', - 'wks', - 'wcm', - 'wdb', - 'wpl', - 'xps', - 'mseq', - 'mus', - 'msty', - 'taglet', - 'nlu', - 'ntf', - 'nitf', - 'nnd', - 'nns', - 'nnw', - '*ac', - 'ngdat', - 'n-gage', - 'rpst', - 'rpss', - 'edm', - 'edx', - 'ext', - 'odc', - 'otc', - 'odb', - 'odf', - 'odft', - 'odg', - 'otg', - 'odi', - 'oti', - 'odp', - 'otp', - 'ods', - 'ots', - 'odt', - 'odm', - 'ott', - 'oth', - 'xo', - 'dd2', - 'obgx', - 'oxt', - 'osm', - 'pptx', - 'sldx', - 'ppsx', - 'potx', - 'xlsx', - 'xltx', - 'docx', - 'dotx', - 'mgp', - 'dp', - 'esa', - 'pdb', - 'pqa', - 'oprc', - 'paw', - 'str', - 'ei6', - 'efif', - 'wg', - 'plf', - 'pbd', - 'box', - 'mgz', - 'qps', - 'ptid', - 'qxd', - 'qxt', - 'qwd', - 'qwt', - 'qxl', - 'qxb', - 'rar', - 'bed', - 'mxl', - 'musicxml', - 'cryptonote', - 'cod', - 'rm', - 'rmvb', - 'link66', - 'st', - 'see', - 'sema', - 'semd', - 'semf', - 'ifm', - 'itp', - 'iif', - 'ipk', - 'twd', - 'twds', - 'mmf', - 'teacher', - 'fo', - 'sdkm', - 'sdkd', - 'dxp', - 'sfs', - 'sdc', - 'sda', - 'sdd', - 'smf', - 'sdw', - 'vor', - 'sgl', - 'smzip', - 'sm', - 'wadl', - 'sxc', - 'stc', - 'sxd', - 'std', - 'sxi', - 'sti', - 'sxm', - 'sxw', - 'sxg', - 'stw', - 'sus', - 'susp', - 'svd', - 'sis', - 'sisx', - 'xsm', - 'bdm', - 'xdm', - 'ddf', - 'tao', - 'pcap', - 'cap', - 'dmp', - 'tmo', - 'tpt', - 'mxs', - 'tra', - 'ufd', - 'ufdl', - 'utz', - 'umj', - 'unityweb', - 'uoml', - 'vcx', - 'vsd', - 'vst', - 'vss', - 'vsw', - 'vis', - 'vsf', - 'wbxml', - 'wmlc', - 'wmlsc', - 'wtb', - 'nbp', - 'wpd', - 'wqd', - 'stf', - 'xar', - 'xfdl', - 'hvd', - 'hvs', - 'hvp', - 'osf', - 'osfpvg', - 'saf', - 'spf', - 'cmp', - 'zir', - 'zirz', - 'zaz', - '7z', - 'abw', - 'ace', - '*dmg', - 'arj', - 'aab', - 'x32', - 'u32', - 'vox', - 'aam', - 'aas', - 'bcpio', - '*bdoc', - 'torrent', - 'blb', - 'blorb', - 'bz', - 'bz2', - 'boz', - 'cbr', - 'cba', - 'cbt', - 'cbz', - 'cb7', - 'vcd', - 'cfs', - 'chat', - 'pgn', - 'crx', - 'cco', - 'nsc', - 'cpio', - 'csh', - '*deb', - 'udeb', - 'dgc', - 'dir', - 'dcr', - 'dxr', - 'cst', - 'cct', - 'cxt', - 'w3d', - 'fgd', - 'swa', - 'wad', - 'ncx', - 'dtb', - 'res', - 'dvi', - 'evy', - 'eva', - 'bdf', - 'gsf', - 'psf', - 'pcf', - 'snf', - 'pfa', - 'pfb', - 'pfm', - 'afm', - 'arc', - 'spl', - 'gca', - 'ulx', - 'gnumeric', - 'gramps', - 'gtar', - 'hdf', - 'php', - 'install', - '*iso', - '*key', - '*numbers', - '*pages', - 'jardiff', - 'jnlp', - 'kdbx', - 'latex', - 'luac', - 'lzh', - 'lha', - 'run', - 'mie', - 'prc', - 'mobi', - 'application', - 'lnk', - 'wmd', - 'wmz', - 'xbap', - 'mdb', - 'obd', - 'crd', - 'clp', - '*exe', - '*dll', - 'com', - 'bat', - '*msi', - 'mvb', - 'm13', - 'm14', - '*wmf', - '*wmz', - '*emf', - 'emz', - 'mny', - 'pub', - 'scd', - 'trm', - 'wri', - 'nc', - 'cdf', - 'pac', - 'nzb', - 'pl', - 'pm', - '*prc', - '*pdb', - 'p12', - 'pfx', - 'p7b', - 'spc', - 'p7r', - '*rar', - 'rpm', - 'ris', - 'sea', - 'sh', - 'shar', - 'swf', - 'xap', - 'sql', - 'sit', - 'sitx', - 'srt', - 'sv4cpio', - 'sv4crc', - 't3', - 'gam', - 'tar', - 'tcl', - 'tk', - 'tex', - 'tfm', - 'texinfo', - 'texi', - '*obj', - 'ustar', - 'hdd', - 'ova', - 'ovf', - 'vbox', - 'vbox-extpack', - 'vdi', - 'vhd', - 'vmdk', - 'src', - 'webapp', - 'der', - 'crt', - 'pem', - 'fig', - '*xlf', - 'xpi', - 'xz', - 'z1', - 'z2', - 'z3', - 'z4', - 'z5', - 'z6', - 'z7', - 'z8', - 'uva', - 'uvva', - 'eol', - 'dra', - 'dts', - 'dtshd', - 'lvp', - 'pya', - 'ecelp4800', - 'ecelp7470', - 'ecelp9600', - 'rip', - 'aac', - 'aif', - 'aiff', - 'aifc', - 'caf', - 'flac', - '*m4a', - 'mka', - 'm3u', - 'wax', - 'wma', - 'ram', - 'ra', - 'rmp', - '*ra', - 'cdx', - 'cif', - 'cmdf', - 'cml', - 'csml', - 'xyz', - 'btif', - 'pti', - 'psd', - 'azv', - 'uvi', - 'uvvi', - 'uvg', - 'uvvg', - 'djvu', - 'djv', - '*sub', - 'dwg', - 'dxf', - 'fbs', - 'fpx', - 'fst', - 'mmr', - 'rlc', - 'ico', - 'dds', - 'mdi', - 'wdp', - 'npx', - 'b16', - 'tap', - 'vtf', - 'wbmp', - 'xif', - 'pcx', - '3ds', - 'ras', - 'cmx', - 'fh', - 'fhc', - 'fh4', - 'fh5', - 'fh7', - '*ico', - 'jng', - 'sid', - '*bmp', - '*pcx', - 'pic', - 'pct', - 'pnm', - 'pbm', - 'pgm', - 'ppm', - 'rgb', - 'tga', - 'xbm', - 'xpm', - 'xwd', - 'wsc', - 'dae', - 'dwf', - 'gdl', - 'gtw', - 'mts', - 'ogex', - 'x_b', - 'x_t', - 'vds', - 'usdz', - 'bsp', - 'vtu', - 'dsc', - 'curl', - 'dcurl', - 'mcurl', - 'scurl', - 'sub', - 'fly', - 'flx', - 'gv', - '3dml', - 'spot', - 'jad', - 'wml', - 'wmls', - 's', - 'asm', - 'c', - 'cc', - 'cxx', - 'cpp', - 'h', - 'hh', - 'dic', - 'htc', - 'f', - 'for', - 'f77', - 'f90', - 'hbs', - 'java', - 'lua', - 'mkd', - 'nfo', - 'opml', - '*org', - 'p', - 'pas', - 'pde', - 'sass', - 'scss', - 'etx', - 'sfv', - 'ymp', - 'uu', - 'vcs', - 'vcf', - 'uvh', - 'uvvh', - 'uvm', - 'uvvm', - 'uvp', - 'uvvp', - 'uvs', - 'uvvs', - 'uvv', - 'uvvv', - 'dvb', - 'fvt', - 'mxu', - 'm4u', - 'pyv', - 'uvu', - 'uvvu', - 'viv', - 'f4v', - 'fli', - 'flv', - 'm4v', - 'mkv', - 'mk3d', - 'mks', - 'mng', - 'asf', - 'asx', - 'vob', - 'wm', - 'wmv', - 'wmx', - 'wvx', - 'avi', - 'movie', - 'smv', - 'ice', - 'mht', - null, - ], - example: 'pdf', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - example: 'application/pdf', - nullable: true, - }, - }, - }, - ForbiddenResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 403, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Forbidden resource', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - InternalServerErrorResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 500, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Internal server error', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - Interview: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - application_id: { - type: 'string', - nullable: true, - }, - remote_application_id: { - type: 'string', - description: "Provider's unique identifier of the application", - example: 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - nullable: true, - }, - interview_stage_id: { - type: 'string', - nullable: true, - }, - remote_interview_stage_id: { - type: 'string', - description: "Provider's unique identifier of the interview stage", - example: 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - nullable: true, - }, - interview_stage: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/InterviewStage', - }, - ], - }, - interview_status: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/InterviewStatusEnum', - }, - ], - }, - interviewer_ids: { - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - remote_interviewer_ids: { - description: "Provider's unique identifiers of the interviewers", - example: [ - 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - ], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - interview_parts: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/InterviewPart', - }, - }, - interviewers: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/Interviewer', - }, - }, - start_at: { - type: 'string', - description: 'Interview start date', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - end_at: { - type: 'string', - description: 'Interview end date', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - meeting_url: { - type: 'string', - nullable: true, - }, - created_at: { - type: 'string', - description: 'Interview created date', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'Interview updated date', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - }, - }, - Interviewer: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - first_name: { - type: 'string', - nullable: true, - }, - last_name: { - type: 'string', - nullable: true, - }, - name: { - type: 'string', - nullable: true, - }, - email: { - type: 'string', - nullable: true, - }, - }, - }, - InterviewPart: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - type: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/InterviewTypeEnum', - }, - ], - }, - title: { - type: 'string', - description: - 'The title of interview, usually corresponding to the title of an associated calendar event', - example: 'Interview (Informal Interview) - Elon and StackOne', - nullable: true, - }, - interviewer_ids: { - description: 'The user (interviewer) IDs taking part in this specific interview.', - example: ['cx28iQahdfDHa', 'cx28iQokkD78das'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - remote_interviewer_ids: { - description: - "Provider's user (interviewer) IDs taking part in this specific interview.", - example: ['cx28iQahdfDHa', 'cx28iQokkD78das'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - meeting_url: { - type: 'string', - description: - 'The meeting URL for the interview - this may be populated using the underlying location if the location string extracted is a valid url.', - example: 'zoomus://zoom.us/join?confno=123456789', - nullable: true, - }, - meeting_provider: { - type: 'string', - description: 'The video meeting provider used for the interview.', - example: 'zoom', - nullable: true, - }, - start_at: { - type: 'string', - description: "The specific interview part's start date", - example: '2021-01-01T17:00:00.000Z', - format: 'date-time', - nullable: true, - }, - end_at: { - type: 'string', - description: "The specific interview part's end date", - example: '2021-01-01T18:00:00.000Z', - format: 'date-time', - nullable: true, - }, - created_at: { - type: 'string', - description: 'Interview part created date', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'Interview part updated date', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - }, - }, - InterviewsPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/Interview', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - InterviewsResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/Interview', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - InterviewStage: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - name: { - type: 'string', - nullable: true, - }, - order: { - type: 'number', - nullable: true, - }, - created_at: { - type: 'string', - description: 'Interview Stage created date', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'Interview Stage updated date', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - }, - }, - InterviewStageResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/InterviewStage', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - InterviewStagesPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/InterviewStage', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - InterviewStatusEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'unscheduled', - 'scheduled', - 'completed', - 'cancelled', - 'pending_feedback', - 'unmapped_value', - null, - ], - description: 'The status of the interview.', - example: 'unscheduled', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - description: 'The source value of the interview status.', - example: 'Unscheduled', - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - InterviewTypeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'screening', - 'lunch', - 'on_site', - 'presentation', - 'sell', - 'culture', - 'informal', - 'test', - 'phone', - 'video', - 'unmapped_value', - null, - ], - description: 'The type of the interview.', - example: 'on_site', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - description: 'The source value of the interview type.', - example: 'Onsite Interview', - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - JobPosting: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - title: { - type: 'string', - example: 'Software Engineer', - nullable: true, - }, - locations: { - example: [ - { - id: '12345', - name: 'New York', - }, - { - id: '67890', - name: 'Remote', - }, - ], - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/JobPostingLocation', - }, - }, - internal: { - type: 'string', - enum: ['true', 'false', 'unmapped_value', null], - example: 'true', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - status: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/JobPostingStatusEnum', - }, - ], - }, - job_id: { - type: 'string', - example: 'job001', - nullable: true, - }, - remote_job_id: { - type: 'string', - description: "Provider's unique identifier of the job", - example: 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - nullable: true, - }, - content: { - example: { - plain: 'This is a plain text description', - html: '
This is an HTML description
', - }, - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/JobPostingContent', - }, - ], - }, - compensation: { - example: [ - { - title: 'Base Salary', - type: 'salary', - pay_period: 'month', - pay_frequency: 'yearly', - currency: 'USD', - value: '50000', - min_value_range: '45000', - max_value_range: '55000', - }, - { - title: 'Bonus', - type: 'bonus', - pay_frequency: 'quarterly', - currency: 'USD', - value: '10%', - }, - ], - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/JobPostingCompensation', - }, - }, - employment_type: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/EmploymentTypeEnum', - }, - ], - }, - employment_contract_type: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/EmploymentContractTypeEnum', - }, - ], - }, - external_url: { - type: 'string', - example: 'https://www.example.com/job-posting/abcd1234', - nullable: true, - }, - external_apply_url: { - type: 'string', - example: 'https://www.example.com/job-posting/abcd1234/apply', - nullable: true, - }, - questionnaires: { - example: [ - { - id: 'about001', - name: 'About', - internal: 'false', - questions: [ - { - id: 'question001', - text: 'What is your name?', - type: 'short_text', - required: true, - parent_question: null, - }, - { - id: 'question002', - text: 'What are your hobbies?', - type: 'long_text', - required: false, - parent_question: null, - }, - { - id: 'question003', - text: 'What is your favourite animal?', - type: 'single_select', - required: true, - multiple_choice_answers: [ - { - id: '1', - text: 'Dog', - }, - { - id: '2', - text: 'Cat', - }, - { - id: '3', - text: 'Bird', - }, - { - id: '4', - text: 'Other', - }, - ], - parent_question: null, - }, - { - id: 'question004', - text: 'Do you have previous work experience??', - type: 'single_select', - required: true, - multiple_choice_answers: [ - { - id: '1', - text: 'Yes', - }, - { - id: '2', - text: 'No', - }, - ], - parent_question: null, - }, - { - id: 'question005', - text: 'What was the duration of your last employment?', - type: 'single_select', - required: true, - multiple_choice_answers: [ - { - id: '1', - text: 'Less than 1 year', - }, - { - id: '2', - text: '1-2 years', - }, - { - id: '2', - text: 'More than 2 year', - }, - ], - parent_question: { - id: 'question004', - option_ids: ['1'], - condition_type: 'equals_to', - }, - }, - ], - }, - { - id: 'experience001', - name: 'Experience', - internal: 'false', - questions: [ - { - id: 'question004', - text: 'Please upload your resume.', - type: 'attachment', - parent_question: null, - required: true, - }, - { - id: 'question005', - text: 'Select the programming languages you are proficient in.', - type: 'multi_select', - multiple_choice_answers: [ - { - id: '1', - text: 'JavaScript', - }, - { - id: '2', - text: 'Python', - }, - { - id: '3', - text: 'Java', - }, - ], - parent_question: null, - required: true, - }, - { - id: 'question006', - text: 'Are you willing to relocate?', - type: 'boolean', - parent_question: null, - }, - { - id: 'question007', - text: 'How many years of experience do you have?', - type: 'number', - parent_question: null, - }, - { - id: 'question008', - text: 'When did you start your most recent position?', - type: 'date', - parent_question: null, - }, - { - id: 'question009', - text: 'Do you have Project Management Experience?', - type: 'single_select', - multiple_choice_answers: [ - { - id: '1', - text: 'Yes', - }, - { - id: '2', - text: 'No', - }, - ], - parent_question: null, - required: true, - }, - { - id: 'question010', - text: 'How much Project Management experience do you have?', - type: 'single_select', - multiple_choice_answers: [ - { - id: '1', - text: '1-3 years', - }, - { - id: '2', - text: '3-5 years', - }, - { - id: '3', - text: '5-10 years', - }, - { - id: '4', - text: 'More than 10 years', - }, - ], - parent_question: { - id: 'question009', - option_ids: ['1'], - condition_type: 'equals_to', - }, - }, - ], - }, - ], - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/JobPostingQuestionnaire', - }, - }, - start_date: { - type: 'string', - description: 'The posting start date', - example: '2021-01-01T00:00:00.000Z', - format: 'date-time', - nullable: true, - }, - created_at: { - type: 'string', - description: 'Date of creation', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'Date of last update', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - }, - }, - JobPostingCompensation: { - type: 'object', - properties: { - title: { - type: 'string', - nullable: true, - }, - type: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/CompensationTypeEnum', - }, - ], - }, - pay_period: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/PayPeriodEnum', - }, - ], - }, - pay_frequency: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/PayFrequencyEnum', - }, - ], - }, - currency: { - type: 'string', - nullable: true, - }, - value: { - type: 'string', - nullable: true, - }, - min_value_range: { - type: 'string', - nullable: true, - }, - max_value_range: { - type: 'string', - nullable: true, - }, - }, - }, - JobPostingContent: { - type: 'object', - properties: { - plain: { - type: 'string', - nullable: true, - }, - html: { - type: 'string', - nullable: true, - }, - sections: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/JobPostingContentSection', - }, - }, - }, - }, - JobPostingContentSection: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - type: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/AssessmentTypeEnum', - }, - ], - }, - label: { - type: 'string', - example: 'Key Responsibilities', - nullable: true, - }, - content: { - type: 'string', - example: 'This is a plain description', - nullable: true, - }, - }, - }, - JobPostingLocation: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - nullable: true, - }, - }, - }, - JobPostingQuestionnaire: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - nullable: true, - }, - internal: { - oneOf: [ - { - type: 'boolean', - }, - { - type: 'string', - enum: ['true', 'false'], - }, - ], - nullable: true, - }, - questions: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/Question', - }, - }, - }, - }, - JobPostingResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/JobPosting', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - JobPostingsPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/JobPosting', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - JobPostingStatusEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'live', - 'draft', - 'pending', - 'internal', - 'rejected', - 'closed', - 'archived', - 'unmapped_value', - null, - ], - description: 'The status of the job postings.', - example: 'live', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - description: 'The source value of the job postings status.', - example: 'Live', - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - List: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - name: { - type: 'string', - nullable: true, - }, - items: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/ListItem', - }, - }, - created_at: { - type: 'string', - description: 'Timestamp when the list was created', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'Timestamp when the list was last updated', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - type: { - description: 'The list type', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/ListTypeEnum', - }, - ], - }, - }, - }, - ListItem: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - }, - }, - ListResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/List', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - ListsPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/List', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - ListTypeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: ['candidates', 'contacts', 'companies', 'unmapped_value', null], - description: 'The type of the list.', - example: 'contacts', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - description: 'The source value of the list type.', - example: 'Contacts', - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - MoveApplicationResult: { - type: 'object', - properties: { - statusCode: { - type: 'number', - example: 200, - }, - message: { - type: 'string', - example: 'Application moved successfully.', - }, - timestamp: { - type: 'string', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - }, - data: { - $ref: '#/components/schemas/CreateResultDataApiModel', - }, - }, - required: ['statusCode', 'message', 'timestamp', 'data'], - }, - Note: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - content: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/NoteContentApiModel', - }, - }, - author_id: { - type: 'string', - description: 'Unique identifier of the author', - example: '1234567890', - nullable: true, - }, - remote_author_id: { - type: 'string', - description: "Provider's unique identifier of the author", - example: 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - nullable: true, - }, - visibility: { - description: 'Visibility of the note', - example: 'public', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/NotesVisibilityEnum', - }, - ], - }, - created_at: { - type: 'string', - description: 'Date of creation', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'Date of last update', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - deleted_at: { - type: 'string', - description: 'Date of Deletion', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - }, - }, - NoteContentApiModel: { - type: 'object', - properties: { - body: { - type: 'string', - description: 'Body of the note', - example: 'This candidate seems like a good fit for the role', - nullable: true, - }, - }, - }, - NoteResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/Note', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - NotesPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/Note', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - NotesVisibilityEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: ['private', 'public', 'unmapped_value', null], - description: 'The visibility of the notes.', - example: 'public', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - description: 'The source value of the notes visibility.', - example: 'Public', - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - NotFoundResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 404, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Not Found', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - NotImplementedResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 501, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Not Implemented', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - Offer: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - application_id: { - type: 'string', - nullable: true, - }, - remote_application_id: { - type: 'string', - description: "Provider's unique identifier of the application", - example: 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - nullable: true, - }, - start_date: { - type: 'string', - description: 'Date of creation', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - offer_status: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/OfferStatusEnum', - }, - ], - }, - salary: { - type: 'number', - nullable: true, - }, - currency: { - type: 'string', - nullable: true, - }, - created_at: { - type: 'string', - description: 'Date of creation', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'Date of last update', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - offer_history: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/OfferHistory', - }, - }, - }, - }, - OfferHistory: { - type: 'object', - properties: { - start_date: { - type: 'string', - description: 'Start Date of the offer', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - salary: { - type: 'number', - nullable: true, - }, - currency: { - type: 'string', - nullable: true, - }, - created_at: { - type: 'string', - description: 'Date of creation', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'Date of last update', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - }, - }, - OffersPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/Offer', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - OffersResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/Offer', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - OfferStatusEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'pending', - 'retracted', - 'accepted', - 'rejected', - 'created', - 'approved', - 'not_approved', - 'unmapped_value', - null, - ], - description: 'The status of the offer.', - example: 'pending', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - description: 'The source value of the offer status.', - example: 'Pending', - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - OrderApplicationApiModel: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - application_status: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/ApplicationStatusEnum', - }, - ], - }, - passthrough: { - type: 'object', - description: 'Value to pass through to the provider', - example: { - other_known_names: 'John Doe', - }, - additionalProperties: true, - nullable: true, - }, - }, - }, - OrderBackgroundCheckPackageApiModel: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - description: 'Package name', - example: 'Test 1', - nullable: true, - }, - description: { - type: 'string', - description: 'Package description', - example: "Skills test to gauge a candidate's proficiency in job-specific skills", - nullable: true, - }, - tests: { - description: 'Package tests', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/Package', - }, - }, - }, - }, - OrderCandidateApiModel: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - first_name: { - type: 'string', - description: 'Candidate first name', - example: 'Romain', - nullable: true, - }, - last_name: { - type: 'string', - description: 'Candidate last name', - example: 'Sestier', - nullable: true, - }, - emails: { - description: 'List of candidate emails', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/CandidateEmail', - }, - }, - passthrough: { - type: 'object', - description: 'Value to pass through to the provider', - example: { - other_known_names: 'John Doe', - }, - additionalProperties: true, - nullable: true, - }, - profile_url: { - type: 'string', - description: 'Candidate profile url', - example: 'https://exmaple.com/candidate?id=xyz', - nullable: true, - }, - }, - }, - OrderJobApiModel: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - title: { - type: 'string', - description: 'Title of the job', - example: 'Software Engineer', - nullable: true, - }, - hiring_team: { - description: 'Hiring team for the job.', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/AtsJobHiringTeam', - }, - }, - passthrough: { - type: 'object', - description: 'Value to pass through to the provider', - example: { - other_known_names: 'John Doe', - }, - additionalProperties: true, - nullable: true, - }, - }, - }, - OrderJobHiringTeamApiModel: { - type: 'object', - properties: { - user_id: { - type: 'string', - example: '123456', - description: 'User ID of the hiring team member.', - nullable: true, - }, - remote_user_id: { - type: 'string', - description: "Provider's unique identifier of the user", - example: 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - nullable: true, - }, - first_name: { - type: 'string', - example: 'John', - description: 'First name of the hiring team member.', - nullable: true, - }, - last_name: { - type: 'string', - example: 'Doe', - description: 'Last name of the hiring team member.', - nullable: true, - }, - email: { - type: 'string', - example: 'john.doe@gmail.com', - description: 'Email of the hiring team member.', - nullable: true, - }, - role: { - type: 'string', - example: 'Software Engineer', - description: 'Role of the hiring team member.', - nullable: true, - }, - }, - }, - OrderPackageApiModel: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - description: 'Package name', - example: 'Test 1', - nullable: true, - }, - description: { - type: 'string', - description: 'Package description', - example: "Skills test to gauge a candidate's proficiency in job-specific skills", - nullable: true, - }, - }, - }, - Package: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - description: 'Package name', - example: 'Test 1', - nullable: true, - }, - description: { - type: 'string', - description: 'Package description', - example: "Skills test to gauge a candidate's proficiency in job-specific skills", - nullable: true, - }, - }, - }, - ParentQuestion: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - option_ids: { - description: "List of parent questions's option IDs", - example: [ - '123e4567-e89b-12d3-a456-426614174000', - '523e1234-e89b-fdd2-a456-762545121101', - ], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - remote_option_ids: { - description: "Provider's list of parent questions's option IDs", - example: [ - '123e4567-e89b-12d3-a456-426614174000', - '523e1234-e89b-fdd2-a456-762545121101', - ], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - condition_type: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/ConditionTypeEnum', - }, - ], - }, - }, - }, - PayFrequencyEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'hourly', - 'weekly', - 'bi_weekly', - 'four_weekly', - 'semi_monthly', - 'monthly', - 'bi_monthly', - 'quarterly', - 'semi_annually', - 'yearly', - 'thirteen_monthly', - 'pro_rata', - 'unmapped_value', - 'half_yearly', - 'daily', - null, - ], - description: 'The pay frequency of the job postings.', - example: 'hourly', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - description: 'The source value of the pay frequency.', - example: 'Hourly', - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - PayPeriodEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'hour', - 'day', - 'week', - 'every_two_weeks', - 'month', - 'twice_a_month', - 'every_two_months', - 'quarter', - 'every_six_months', - 'year', - 'one_off', - 'none', - 'unmapped_value', - null, - ], - description: 'The pay period of the job postings.', - example: 'hour', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - description: 'The source value of the pay period.', - example: 'Hour', - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - PhoneNumber: { - type: 'object', - properties: { - type: { - type: 'string', - description: 'Type of phone number', - enum: [ - 'personal', - 'work', - 'mobile', - 'home', - 'unknown', - 'other', - 'unmapped_value', - null, - ], - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - phone: { - type: 'string', - description: 'Phone number string', - example: '+447700112233', - nullable: true, - }, - }, - }, - PreconditionFailedResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 412, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Precondition failed', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - ProviderError: { - type: 'object', - properties: { - status: { - type: 'number', - description: 'HTTP status code of the provider error', - example: 400, - nullable: true, - }, - url: { - type: 'string', - description: 'URL that caused the error', - example: 'https://api.provider.com/v1/resource', - nullable: true, - }, - raw: { - type: 'object', - description: 'Raw error response from the provider', - example: { - message: 'Invalid input parameters', - }, - nullable: true, - }, - headers: { - type: 'object', - description: 'Response headers', - example: { - 'content-type': 'application/json', - 'x-request-id': '5678c28b211dace4e0a0f9171e6b88c5', - }, - nullable: true, - }, - }, - }, - ProviderErrorApiModel: { - type: 'object', - properties: { - status: { - type: 'number', - example: 400, - nullable: true, - }, - url: { - type: 'string', - example: 'https://api.someprovider.com/v1/endpoint', - nullable: true, - }, - raw: { - type: 'object', - nullable: true, - }, - headers: { - type: 'object', - example: { - date: 'Tue, 02 Apr 2024 13:52:01 GMT', - 'content-type': 'application/json; charset=utf-8', - 'transfer-encoding': 'chunked', - connection: 'close', - }, - nullable: true, - }, - }, - }, - Question: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - nullable: true, - }, - type: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/QuestionsTypeEnum', - }, - ], - }, - text: { - type: 'string', - nullable: true, - }, - required: { - oneOf: [ - { - type: 'boolean', - }, - { - type: 'string', - enum: ['true', 'false'], - }, - ], - nullable: true, - }, - multiple_choice_answers: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/QuestionMultipleChoiceAnswers', - }, - }, - parent_question: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/ParentQuestion', - }, - ], - }, - }, - }, - QuestionMultipleChoiceAnswers: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - text: { - type: 'string', - nullable: true, - }, - }, - }, - Questionnaire: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - answers: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/Answer', - }, - }, - }, - }, - QuestionsTypeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'short_text', - 'long_text', - 'attachment', - 'multi_select', - 'single_select', - 'boolean', - 'number', - 'date', - 'video', - 'reference_check', - 'url', - 'unmapped_value', - null, - ], - description: 'The type of the questions.', - example: 'short_text', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - description: 'The source value of the questions type.', - example: 'ShortText', - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - RawResponse: { - type: 'object', - properties: { - method: { - type: 'string', - }, - url: { - type: 'string', - }, - body: { - oneOf: [ - { - type: 'string', - }, - { - type: 'object', - }, - { - type: 'array', - items: { - type: 'integer', - format: 'int32', - minimum: 0, - maximum: 255, - }, - }, - ], - additionalProperties: true, - nullable: true, - }, - response: { - oneOf: [ - { - type: 'object', - additionalProperties: true, - }, - { - type: 'array', - items: {}, - }, - { - type: 'string', - }, - ], - nullable: true, - }, - }, - required: ['method', 'url'], - }, - Reference: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'The reference id', - example: '1687-3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - description: 'The reference name', - example: '1687-4', - nullable: true, - }, - active: { - description: 'The reference status', - example: true, - oneOf: [ - { - type: 'boolean', - }, - { - type: 'string', - enum: ['true', 'false'], - }, - ], - nullable: true, - }, - }, - }, - ReferencePaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/Reference', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - ReferenceResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/Reference', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - RejectApplicationResult: { - type: 'object', - properties: { - statusCode: { - type: 'number', - example: 200, - }, - message: { - type: 'string', - example: 'Application rejected successfully.', - }, - timestamp: { - type: 'string', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - }, - data: { - $ref: '#/components/schemas/CreateResultDataApiModel', - }, - }, - required: ['statusCode', 'message', 'timestamp', 'data'], - }, - RejectedReason: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - label: { - type: 'string', - description: 'The label of the rejected reason.', - example: 'Failed Phone Screen', - nullable: true, - }, - type: { - type: 'string', - description: 'The string type of the rejected reason.', - example: 'rejected_by_organization', - deprecated: true, - nullable: true, - }, - rejected_reason_type: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/RejectedReasonTypeEnum', - }, - ], - }, - }, - }, - RejectedReasonResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/RejectedReason', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - RejectedReasonsPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/RejectedReason', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - RejectedReasonTypeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'rejected_by_candidate', - 'rejected_by_organization', - 'other', - 'unknown', - 'unmapped_value', - null, - ], - description: 'The type of the rejected reason.', - example: 'rejected_by_organization', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - description: 'The source value of the rejected reason type.', - example: 'RejectedByOrg', - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - RequestTimedOutResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 408, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Request timed out', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - ResultEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'initiated', - 'in_progress', - 'cancelled', - 'completed', - 'expired', - 'failed', - 'passed', - 'unmapped_value', - null, - ], - description: 'The result of the test.', - example: 'passed', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - description: 'The source value of the test result.', - example: 'Passed', - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - ResultLink: { - type: 'object', - properties: { - label: { - type: 'string', - description: 'The label of the result link.', - example: 'test result link', - nullable: true, - }, - url: { - type: 'string', - description: 'The URL of the result link.', - example: 'http://example.com/test-result/4565765/data', - nullable: true, - }, - }, - }, - ScheduledInterview: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - application_id: { - type: 'string', - nullable: true, - }, - remote_application_id: { - type: 'string', - description: "Provider's unique identifier of the application", - example: 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - nullable: true, - }, - interview_stage_id: { - type: 'string', - nullable: true, - }, - remote_interview_stage_id: { - type: 'string', - description: "Provider's unique identifier of the interview stage", - example: 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - nullable: true, - }, - interview_stage: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/InterviewStage', - }, - ], - }, - interview_status: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/InterviewStatusEnum', - }, - ], - }, - interviewer_ids: { - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - remote_interviewer_ids: { - description: "Provider's unique identifiers of the interviewers", - example: [ - 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - ], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - interview_parts: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/InterviewPart', - }, - }, - interviewers: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/Interviewer', - }, - }, - start_at: { - type: 'string', - description: 'Interview start date', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - end_at: { - type: 'string', - description: 'Interview end date', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - meeting_url: { - type: 'string', - nullable: true, - }, - created_at: { - type: 'string', - description: 'Interview created date', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'Interview updated date', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - }, - }, - ScheduledInterviewsPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/ScheduledInterview', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - ScheduledInterviewsResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/ScheduledInterview', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - ScoreApiModel: { - type: 'object', - properties: { - label: { - type: 'string', - description: 'The label of the score', - example: 'Percentage', - nullable: true, - }, - value: { - type: 'string', - description: 'The value is the actual score', - example: '80', - nullable: true, - }, - min: { - type: 'string', - description: 'The minimum value of the score', - example: '0', - nullable: true, - }, - max: { - type: 'string', - description: 'The maximum value of the score', - example: '100', - nullable: true, - }, - }, - }, - Scorecard: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - sections: { - description: 'The sections in the scorecard', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/ScorecardSection', - }, - }, - label: { - type: 'string', - description: 'The label of the scorecard', - example: 'Technical Interview', - nullable: true, - }, - candidate_id: { - type: 'string', - description: 'The candidate ID associated with the scorecard', - example: '5678-9', - nullable: true, - }, - remote_candidate_id: { - type: 'string', - description: "Provider's unique identifier of the candidate", - example: 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - nullable: true, - }, - application_id: { - type: 'string', - description: 'The application ID associated with the scorecard', - example: '1011-12', - nullable: true, - }, - remote_application_id: { - type: 'string', - description: "Provider's unique identifier of the application", - example: 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - nullable: true, - }, - interview_id: { - type: 'string', - description: 'The interview ID associated with the scorecard', - example: '1314-15', - nullable: true, - }, - remote_interview_id: { - type: 'string', - description: "Provider's unique identifier of the interview", - example: 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - nullable: true, - }, - author_id: { - type: 'string', - description: 'The author ID of the scorecard', - example: '1617-18', - nullable: true, - }, - remote_author_id: { - type: 'string', - description: "Provider's unique identifier of the author", - example: 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - nullable: true, - }, - overall_recommendation: { - type: 'string', - description: 'The overall recommendation', - example: 'recommended', - enum: ['strong_yes', 'yes', 'no', 'strong_no', 'no_decision', 'unmapped_value', null], - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - created_at: { - type: 'string', - description: 'The creation date of the scorecard', - example: '2021-01-01T00:00:00.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'The update date of the scorecard', - example: '2021-01-01T00:00:00.000Z', - format: 'date-time', - nullable: true, - }, - }, - }, - ScorecardSection: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - label: { - type: 'string', - description: 'The label of the section', - example: 'Technical Skills', - nullable: true, - }, - fields: { - description: 'The fields within the section', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/Field', - }, - }, - }, - }, - ScorecardsPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/Scorecard', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - ScorecardsResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/Scorecard', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - SocialLink: { - type: 'object', - properties: { - type: { - type: 'string', - description: 'Type of the social link', - example: 'linkedin', - nullable: true, - }, - url: { - type: 'string', - description: 'URL of the social link', - example: 'https://www.linkedin.com/in/romainsestier/', - nullable: true, - }, - }, - }, - Source: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - description: 'The source of the application', - example: 'LinkedIn', - nullable: true, - }, - }, - }, - Tag: { - type: 'object', - properties: { - remote_id: { - type: 'string', - description: 'Remote ID of the tag', - example: '123e4567-e89b-12d3-a456-426614174000', - nullable: true, - }, - name: { - type: 'string', - description: 'Name of the tag', - example: 'Gold Medalist', - nullable: true, - }, - }, - }, - TooManyRequestsResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 429, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Too many requests', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - UnauthorizedResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 401, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Unauthorized', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - UnifiedError: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 400, - nullable: true, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Bad Request', - nullable: true, - }, - headers: { - type: 'object', - description: 'Response headers', - example: { - 'content-type': 'application/json', - 'x-request-id': '5678c28b211dace4e0a0f9171e6b88c5', - }, - nullable: true, - }, - }, - }, - UnifiedWarningApiModel: { - type: 'object', - properties: { - message: { - type: 'string', - example: 'The provided field type is not supported in the current model.', - nullable: true, - }, - }, - }, - UnprocessableEntityResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 422, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Unprocessable Entity', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - UpdatePackage: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - description: 'Package name', - example: 'Test 1', - nullable: true, - }, - description: { - type: 'string', - description: 'Package description', - example: "Skills test to gauge a candidate's proficiency in job-specific skills", - nullable: true, - }, - }, - }, - UpdateResult: { - type: 'object', - properties: { - statusCode: { - type: 'number', - example: 200, - }, - message: { - type: 'string', - example: 'Record updated successfully.', - }, - timestamp: { - type: 'string', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - UpdateResultCandidateApiModel: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - profile_url: { - type: 'string', - description: 'Candidate profile url', - example: 'https://exmaple.com/candidate?id=xyz', - nullable: true, - }, - }, - }, - User: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - email: { - type: 'string', - nullable: true, - }, - first_name: { - type: 'string', - nullable: true, - }, - last_name: { - type: 'string', - nullable: true, - }, - name: { - type: 'string', - nullable: true, - }, - phone: { - type: 'string', - nullable: true, - }, - }, - }, - UserResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/User', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - UsersPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/User', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - WriteResultApiModel: { - type: 'object', - properties: { - statusCode: { - type: 'number', - example: 201, - nullable: true, - }, - message: { - type: 'string', - example: 'Employee created successfully', - nullable: true, - }, - timestamp: { - type: 'string', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - provider_errors: { - example: [ - { - status: 400, - url: 'https://api.someprovider.com/v1/endpoint', - raw: { - error: 'Bad Request', - message: 'The supplied data is invalid', - }, - headers: { - date: 'Tue, 02 Apr 2024 13:52:01 GMT', - 'content-type': 'application/json; charset=utf-8', - 'transfer-encoding': 'chunked', - connection: 'close', - }, - }, - ], - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/ProviderErrorApiModel', - }, - }, - unified_warnings: { - example: [ - { - message: 'The provided field type is not supported in the current model.', - }, - ], - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/UnifiedWarningApiModel', - }, - }, - }, - }, - }, - }, -}; diff --git a/src/openapi/generated/crm.ts b/src/openapi/generated/crm.ts deleted file mode 100644 index 79fc4ec1..00000000 --- a/src/openapi/generated/crm.ts +++ /dev/null @@ -1,4050 +0,0 @@ -// Generated OpenAPI specification for crm -// DO NOT EDIT THIS FILE DIRECTLY -export const crmSpec = { - openapi: '3.1.0', - paths: { - '/unified/crm/contacts': { - get: { - operationId: 'crm_list_contacts', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,first_name,last_name,company_name,emails,phone_numbers,deal_ids,remote_deal_ids,account_ids,remote_account_ids,custom_fields,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - { - name: 'include', - required: false, - in: 'query', - description: 'The comma separated list of fields that will be included in the response', - schema: { - nullable: true, - example: 'custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of contacts was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ContactsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Contacts', - tags: ['Contacts'], - 'x-speakeasy-group': 'crm', - 'x-speakeasy-name-override': 'list_contacts', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - post: { - operationId: 'crm_create_contact', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CrmCreateContactRequestDto', - }, - }, - }, - }, - responses: { - '200': { - description: 'The contact was successfully created.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ContactResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Create Contact', - tags: ['Contacts'], - 'x-speakeasy-group': 'crm', - 'x-speakeasy-name-override': 'create_contact', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/crm/contacts/{id}': { - get: { - operationId: 'crm_get_contact', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,first_name,last_name,company_name,emails,phone_numbers,deal_ids,remote_deal_ids,account_ids,remote_account_ids,custom_fields,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'include', - required: false, - in: 'query', - description: 'The comma separated list of fields that will be included in the response', - schema: { - nullable: true, - example: 'custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The contact with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ContactResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Contact', - tags: ['Contacts'], - 'x-speakeasy-group': 'crm', - 'x-speakeasy-name-override': 'get_contact', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - patch: { - operationId: 'crm_update_contact', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CrmCreateContactRequestDto', - }, - }, - }, - }, - responses: { - '200': { - description: 'The contact was successfully updated.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ContactResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Update Contact (early access)', - tags: ['Contacts'], - 'x-speakeasy-group': 'crm', - 'x-speakeasy-name-override': 'update_contact', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/crm/accounts': { - get: { - operationId: 'crm_list_accounts', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,owner_id,remote_owner_id,name,description,industries,annual_revenue,website,addresses,phone_numbers,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of accounts was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/AccountsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Accounts', - tags: ['Accounts'], - 'x-speakeasy-group': 'crm', - 'x-speakeasy-name-override': 'list_accounts', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/crm/accounts/{id}': { - get: { - operationId: 'crm_get_account', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,owner_id,remote_owner_id,name,description,industries,annual_revenue,website,addresses,phone_numbers,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The account with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/AccountResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Account', - tags: ['Accounts'], - 'x-speakeasy-group': 'crm', - 'x-speakeasy-name-override': 'get_account', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/crm/lists': { - get: { - operationId: 'crm_list_lists', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,name,created_at,updated_at,items,type,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The collection of lists was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ListsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get all Lists', - tags: ['Lists'], - 'x-speakeasy-group': 'crm', - 'x-speakeasy-name-override': 'list_lists', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/crm/lists/{id}': { - get: { - operationId: 'crm_get_list', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,name,created_at,updated_at,items,type,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ListResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get List', - tags: ['Lists'], - 'x-speakeasy-group': 'crm', - 'x-speakeasy-name-override': 'get_list', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/crm/custom_field_definitions/contacts': { - get: { - operationId: 'crm_list_contact_custom_field_definitions', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,name,description,type,options,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of contacts custom field definitions was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CustomFieldDefinitionsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Contact Custom Field Definitions', - tags: ['Custom Field Definitions'], - 'x-speakeasy-group': 'crm', - 'x-speakeasy-name-override': 'list_contact_custom_field_definitions', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/crm/custom_field_definitions/contacts/{id}': { - get: { - operationId: 'crm_get_contact_custom_field_definition', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,name,description,type,options,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The contact custom field definition was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CustomFieldDefinitionResultApiModel', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Contact Custom Field Definition', - tags: ['Custom Field Definitions'], - 'x-speakeasy-group': 'crm', - 'x-speakeasy-name-override': 'get_contact_custom_field_definition', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - }, - info: { - title: 'CRM', - description: 'The documentation for the StackOne Unified API - CRM', - version: '1.0.0', - contact: {}, - }, - tags: [ - { - name: 'Accounts', - description: 'Customer or business accounts.', - }, - { - name: 'Contacts', - description: 'People or organizations that can be contacted.', - }, - { - name: 'Custom Field Definitions', - description: 'Definitions for custom fields on CRM resources.', - }, - { - name: 'Lists', - description: 'Lists for organizing contacts or accounts.', - }, - ], - servers: [ - { - url: 'https://api.stackone.com', - }, - ], - components: { - securitySchemes: { - basic: { - type: 'http', - scheme: 'basic', - }, - }, - schemas: { - Account: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - owner_id: { - type: 'string', - nullable: true, - }, - remote_owner_id: { - type: 'string', - description: "Provider's unique identifier of the owner", - example: 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - nullable: true, - }, - name: { - type: 'string', - nullable: true, - }, - description: { - type: 'string', - nullable: true, - }, - industries: { - description: 'Values of the industries', - example: [ - 'Information Technology', - 'Airlines & Airports', - 'Personal Care & Household Products', - ], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - annual_revenue: { - type: 'string', - nullable: true, - }, - website: { - type: 'string', - nullable: true, - }, - addresses: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/AccountAddress', - }, - }, - phone_numbers: { - description: 'List of account phone numbers', - example: ['+1123425334'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - created_at: { - type: 'string', - description: 'Timestamp when the account was created', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'Timestamp when the account was last updated', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - }, - }, - AccountAddress: { - type: 'object', - properties: { - street_1: { - type: 'string', - nullable: true, - }, - street_2: { - type: 'string', - nullable: true, - }, - city: { - type: 'string', - nullable: true, - }, - state: { - type: 'string', - nullable: true, - }, - zip_code: { - type: 'string', - nullable: true, - }, - country: { - description: 'The country code', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/CountryEnum', - }, - ], - }, - location_type: { - description: 'The location type', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/LocationTypeEnum', - }, - ], - }, - }, - }, - AccountResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/Account', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - AccountsPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/Account', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - BadGatewayResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 502, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Bad Gateway', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - BadRequestResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 400, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Bad Request', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - data: { - description: 'Error details', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/UnifiedError', - }, - ], - }, - provider_errors: { - description: 'List of provider-specific errors', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/ProviderError', - }, - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - ConflictResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 409, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Conflict', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - Contact: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - first_name: { - type: 'string', - description: 'The contact first name', - example: 'Steve', - nullable: true, - }, - last_name: { - type: 'string', - description: 'The contact last name', - example: 'Wozniak', - nullable: true, - }, - company_name: { - type: 'string', - description: 'The contact company name', - example: 'Apple Inc.', - nullable: true, - }, - emails: { - description: 'List of contact email addresses', - example: ['steve@apple.com'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - phone_numbers: { - description: 'List of contact phone numbers', - example: ['123-456-7890'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - deal_ids: { - description: 'List of associated deal IDs', - example: ['deal-001', 'deal-002'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - remote_deal_ids: { - description: "Provider's list of associated deal IDs", - example: [ - 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - 'e3cb75bf-aa84-466e-a6c1-b8322b257a49', - ], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - account_ids: { - description: 'List of associated account IDs', - example: ['account-123', 'account-456'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - remote_account_ids: { - description: "Provider's list of associated account IDs", - example: [ - 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - 'e3cb75bf-aa84-466e-a6c1-b8322b257a49', - ], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - custom_fields: { - description: 'Contact custom fields', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/CustomFields', - }, - }, - created_at: { - type: 'string', - description: 'Timestamp when the contact was created', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'Timestamp when the contact was last updated', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - }, - }, - ContactResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/Contact', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - ContactsPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/Contact', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - CountryEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'AF', - 'AL', - 'DZ', - 'AS', - 'AD', - 'AO', - 'AI', - 'AQ', - 'AG', - 'AR', - 'AM', - 'AW', - 'AU', - 'AT', - 'AZ', - 'BS', - 'BH', - 'BD', - 'BB', - 'BY', - 'BE', - 'BZ', - 'BJ', - 'BM', - 'BT', - 'BO', - 'BQ', - 'BA', - 'BW', - 'BV', - 'BR', - 'IO', - 'BN', - 'BG', - 'BF', - 'BI', - 'KH', - 'CM', - 'CA', - 'CV', - 'KY', - 'CF', - 'TD', - 'CL', - 'CN', - 'CX', - 'CC', - 'CO', - 'KM', - 'CG', - 'CD', - 'CK', - 'CR', - 'HR', - 'CU', - 'CW', - 'CY', - 'CZ', - 'CI', - 'DK', - 'DJ', - 'DM', - 'DO', - 'EC', - 'EG', - 'SV', - 'GQ', - 'ER', - 'EE', - 'ET', - 'FK', - 'FO', - 'FJ', - 'FI', - 'FR', - 'GF', - 'PF', - 'TF', - 'GA', - 'GM', - 'GE', - 'DE', - 'GH', - 'GI', - 'GR', - 'GL', - 'GD', - 'GP', - 'GU', - 'GT', - 'GG', - 'GN', - 'GW', - 'GY', - 'HT', - 'HM', - 'VA', - 'HN', - 'HK', - 'HU', - 'IS', - 'IN', - 'ID', - 'IR', - 'IQ', - 'IE', - 'IM', - 'IL', - 'IT', - 'JM', - 'JP', - 'JE', - 'JO', - 'KZ', - 'KE', - 'KI', - 'KP', - 'KR', - 'KW', - 'KG', - 'LA', - 'LV', - 'LB', - 'LS', - 'LR', - 'LY', - 'LI', - 'LT', - 'LU', - 'MO', - 'MK', - 'MG', - 'MW', - 'MY', - 'MV', - 'ML', - 'MT', - 'MH', - 'MQ', - 'MR', - 'MU', - 'YT', - 'MX', - 'FM', - 'MD', - 'MC', - 'MN', - 'ME', - 'MS', - 'MA', - 'MZ', - 'MM', - 'NA', - 'NR', - 'NP', - 'NL', - 'NC', - 'NZ', - 'NI', - 'NE', - 'NG', - 'NU', - 'NF', - 'MP', - 'NO', - 'OM', - 'PK', - 'PW', - 'PS', - 'PA', - 'PG', - 'PY', - 'PE', - 'PH', - 'PN', - 'PL', - 'PT', - 'PR', - 'QA', - 'RO', - 'RU', - 'RW', - 'RE', - 'BL', - 'SH', - 'KN', - 'LC', - 'MF', - 'PM', - 'VC', - 'WS', - 'SM', - 'ST', - 'SA', - 'SN', - 'RS', - 'SC', - 'SL', - 'SG', - 'SX', - 'SK', - 'SI', - 'SB', - 'SO', - 'ZA', - 'GS', - 'SS', - 'ES', - 'LK', - 'SD', - 'SR', - 'SJ', - 'SZ', - 'SE', - 'CH', - 'SY', - 'TW', - 'TJ', - 'TZ', - 'TH', - 'TL', - 'TG', - 'TK', - 'TO', - 'TT', - 'TN', - 'TR', - 'TM', - 'TC', - 'TV', - 'UG', - 'UA', - 'AE', - 'GB', - 'US', - 'UM', - 'UY', - 'UZ', - 'VU', - 'VE', - 'VN', - 'VG', - 'VI', - 'WF', - 'EH', - 'YE', - 'ZM', - 'ZW', - 'unmapped_value', - null, - ], - description: 'The ISO 3166-1 alpha-2 code of the country.', - example: 'GB', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - description: 'The source value of the ISO 3166-1 alpha-2 code of the country.', - example: 'GB', - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - CrmCreateContactRequestDto: { - type: 'object', - properties: { - first_name: { - type: 'string', - description: 'The contact first name', - example: 'Steve', - nullable: true, - }, - last_name: { - type: 'string', - description: 'The contact last name', - example: 'Wozniak', - nullable: true, - }, - company_name: { - type: 'string', - description: 'The contact company name', - example: 'Apple Inc.', - nullable: true, - }, - emails: { - description: 'List of contact email addresses', - example: ['steve@apple.com'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - phone_numbers: { - description: 'List of contact phone numbers', - example: ['123-456-7890'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - deal_ids: { - description: 'List of associated deal IDs', - example: ['deal-001', 'deal-002'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - account_ids: { - description: 'List of associated account IDs', - example: ['account-123', 'account-456'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - custom_fields: { - description: 'Contact custom fields', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/CustomFields', - }, - }, - passthrough: { - type: 'object', - description: 'Value to pass through to the provider', - example: { - other_known_names: 'John Doe', - }, - additionalProperties: true, - nullable: true, - }, - }, - }, - CustomFieldDefinition: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - nullable: true, - }, - description: { - type: 'string', - nullable: true, - }, - type: { - description: 'The type of the custom field.', - example: 'Dropdown', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/CustomFieldTypeEnum', - }, - ], - }, - options: { - description: 'An array of possible options for the custom field.', - example: [ - { - id: 'option_1', - value: 'Not Started', - }, - { - id: 'option_2', - value: 'In Progress', - }, - { - id: 'option_3', - value: 'Completed', - }, - ], - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/CustomFieldOption', - }, - }, - }, - }, - CustomFieldDefinitionResultApiModel: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/CustomFieldDefinition', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - CustomFieldDefinitionsPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/CustomFieldDefinition', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - CustomFieldOption: { - type: 'object', - properties: { - id: { - type: 'string', - description: - 'The unique identifier for the option to be used when updating the custom field', - example: 'option_123', - }, - value: { - description: 'The human readable value of the option', - example: 'Not Started', - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - }, - }, - required: ['id', 'value'], - }, - CustomFields: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - description: 'The name of the custom field.', - example: 'Training Completion Status', - nullable: true, - }, - value: { - description: 'The value associated with the custom field.', - example: 'Completed', - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - { - type: 'string', - format: 'date-time', - }, - ], - nullable: true, - }, - value_id: { - type: 'string', - description: 'The unique identifier for the value of the custom field.', - example: 'value_456', - nullable: true, - }, - remote_value_id: { - type: 'string', - description: "Provider's unique identifier for the value of the custom field.", - example: 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - nullable: true, - }, - }, - }, - CustomFieldTypeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'date', - 'float', - 'integer', - 'list', - 'checkbox', - 'text', - 'boolean', - 'single_select', - 'multi_select', - 'url', - 'other', - 'unmapped_value', - null, - ], - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - ForbiddenResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 403, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Forbidden resource', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - InternalServerErrorResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 500, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Internal server error', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - List: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - name: { - type: 'string', - nullable: true, - }, - items: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/ListItem', - }, - }, - created_at: { - type: 'string', - description: 'Timestamp when the list was created', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'Timestamp when the list was last updated', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - type: { - description: 'The list type', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/ListTypeEnum', - }, - ], - }, - }, - }, - ListItem: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - }, - }, - ListResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/List', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - ListsPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/List', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - ListTypeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: ['candidates', 'contacts', 'companies', 'unmapped_value', null], - description: 'The type of the list.', - example: 'contacts', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - description: 'The source value of the list type.', - example: 'Contacts', - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - LocationTypeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: ['home', 'work', 'unmapped_value', null], - description: 'The type of the location.', - example: 'home', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - description: 'The source value of the location type.', - example: 'Home', - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - NotFoundResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 404, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Not Found', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - NotImplementedResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 501, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Not Implemented', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - PreconditionFailedResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 412, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Precondition failed', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - ProviderError: { - type: 'object', - properties: { - status: { - type: 'number', - description: 'HTTP status code of the provider error', - example: 400, - nullable: true, - }, - url: { - type: 'string', - description: 'URL that caused the error', - example: 'https://api.provider.com/v1/resource', - nullable: true, - }, - raw: { - type: 'object', - description: 'Raw error response from the provider', - example: { - message: 'Invalid input parameters', - }, - nullable: true, - }, - headers: { - type: 'object', - description: 'Response headers', - example: { - 'content-type': 'application/json', - 'x-request-id': '5678c28b211dace4e0a0f9171e6b88c5', - }, - nullable: true, - }, - }, - }, - RawResponse: { - type: 'object', - properties: { - method: { - type: 'string', - }, - url: { - type: 'string', - }, - body: { - oneOf: [ - { - type: 'string', - }, - { - type: 'object', - }, - { - type: 'array', - items: { - type: 'integer', - format: 'int32', - minimum: 0, - maximum: 255, - }, - }, - ], - additionalProperties: true, - nullable: true, - }, - response: { - oneOf: [ - { - type: 'object', - additionalProperties: true, - }, - { - type: 'array', - items: {}, - }, - { - type: 'string', - }, - ], - nullable: true, - }, - }, - required: ['method', 'url'], - }, - RequestTimedOutResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 408, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Request timed out', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - TooManyRequestsResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 429, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Too many requests', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - UnauthorizedResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 401, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Unauthorized', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - UnifiedError: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 400, - nullable: true, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Bad Request', - nullable: true, - }, - headers: { - type: 'object', - description: 'Response headers', - example: { - 'content-type': 'application/json', - 'x-request-id': '5678c28b211dace4e0a0f9171e6b88c5', - }, - nullable: true, - }, - }, - }, - UnprocessableEntityResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 422, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Unprocessable Entity', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - }, - }, -}; diff --git a/src/openapi/generated/documents.ts b/src/openapi/generated/documents.ts deleted file mode 100644 index 7bcb1b00..00000000 --- a/src/openapi/generated/documents.ts +++ /dev/null @@ -1,4483 +0,0 @@ -// Generated OpenAPI specification for documents -// DO NOT EDIT THIS FILE DIRECTLY -export const documentsSpec = { - openapi: '3.1.0', - paths: { - '/unified/documents/files/{id}/download': { - get: { - operationId: 'documents_download_file', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'x-stackone-api-session-token', - in: 'header', - description: 'The session token', - required: false, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'format', - required: false, - in: 'query', - description: 'The format to download the file in', - schema: { - nullable: true, - example: 'base64', - type: 'string', - }, - }, - { - name: 'export_format', - required: false, - in: 'query', - description: 'The export format of the file', - schema: { - nullable: true, - example: 'text/plain', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The file with the given identifiers was retrieved.', - content: { - '*/*': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Download File', - tags: ['Files'], - 'x-speakeasy-group': 'documents', - 'x-speakeasy-name-override': 'download_file', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/documents/files/upload': { - post: { - operationId: 'documents_upload_file', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'x-stackone-api-session-token', - in: 'header', - description: 'The session token', - required: false, - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnifiedUploadRequestDto', - }, - }, - }, - }, - responses: { - '201': { - description: 'The file was uploaded.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/WriteResultApiModel', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Upload File', - tags: ['Files'], - 'x-speakeasy-group': 'documents', - 'x-speakeasy-name-override': 'upload_file', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/documents/files': { - get: { - operationId: 'documents_list_files', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'x-stackone-api-session-token', - in: 'header', - description: 'The session token', - required: false, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,description,url,size,file_format,path,owner_id,remote_owner_id,folder_id,remote_folder_id,drive_id,remote_drive_id,export_formats,default_download_format,created_at,updated_at,has_content,has_children,all_parent_folder_ids,remote_all_parent_folder_ids,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Documents Files Filter', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - name: { - description: 'Search if the name of the file contains the string', - example: 'john_doe_resume.pdf', - type: 'string', - nullable: true, - }, - content: { - description: - 'Search if the contents of the file contains the string (contents can include file metadata)', - example: 'FAQ of the project', - type: 'string', - nullable: true, - }, - created_after: { - description: - 'Use a string with a date to only select results created after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - drive_id: { - description: 'Use to only include Files within the specified Drive', - example: '1234567890', - type: 'string', - nullable: true, - }, - folder_id: { - description: - 'Use to only include Files within the specified Folder. Required when requesting nested items', - example: '1234567890', - type: 'string', - nullable: true, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - { - name: 'folder_id', - required: false, - in: 'query', - description: - 'Use to only include Files within the specified Folder. Required when requesting nested items', - schema: { - nullable: true, - example: '1234567890', - type: 'string', - }, - }, - { - name: 'nested_items', - required: false, - in: 'query', - description: - 'When "true" and used with filter[folder_id], the response includes Files and Files within descendant Folders', - schema: { - nullable: true, - default: 'false', - example: 'true', - type: 'string', - }, - }, - { - name: 'include', - required: false, - in: 'query', - description: 'The comma separated list of fields that will be included in the response', - schema: { - nullable: true, - example: 'all_parent_folder_ids', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of files was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/FilesPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Files', - tags: ['Files'], - 'x-speakeasy-group': 'documents', - 'x-speakeasy-name-override': 'list_files', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/documents/files/{id}': { - get: { - operationId: 'documents_get_file', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'x-stackone-api-session-token', - in: 'header', - description: 'The session token', - required: false, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,description,url,size,file_format,path,owner_id,remote_owner_id,folder_id,remote_folder_id,drive_id,remote_drive_id,export_formats,default_download_format,created_at,updated_at,has_content,has_children,all_parent_folder_ids,remote_all_parent_folder_ids,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'include', - required: false, - in: 'query', - description: 'The comma separated list of fields that will be included in the response', - schema: { - nullable: true, - example: 'all_parent_folder_ids', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The file with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/FileResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get File', - tags: ['Files'], - 'x-speakeasy-group': 'documents', - 'x-speakeasy-name-override': 'get_file', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/documents/folders': { - get: { - operationId: 'documents_list_folders', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,description,url,size,path,owner_id,remote_owner_id,parent_folder_id,remote_parent_folder_id,drive_id,remote_drive_id,created_at,updated_at,has_content,has_children,is_root,all_parent_folder_ids,remote_all_parent_folder_ids,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Documents Folders Filter', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - drive_id: { - description: 'Use to only include Folders within the specified Drive', - example: '1234567890', - type: 'string', - nullable: true, - additionalProperties: false, - }, - folder_id: { - description: - 'Use to only include Folders within the specified Folder. Required when requesting nested items', - example: '1234567890', - type: 'string', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - { - name: 'folder_id', - required: false, - in: 'query', - description: - 'Use to only include Folders within the specified Folder. Required when requesting nested items', - schema: { - nullable: true, - example: '1234567890', - type: 'string', - }, - }, - { - name: 'nested_items', - required: false, - in: 'query', - description: - 'When "true" and used with filter[folder_id], the response includes Folders and their descendant Folders', - schema: { - nullable: true, - default: 'false', - example: 'true', - type: 'string', - }, - }, - { - name: 'include', - required: false, - in: 'query', - description: 'The comma separated list of fields that will be included in the response', - schema: { - nullable: true, - example: 'all_parent_folder_ids', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of folders was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/FoldersPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Folders', - tags: ['Folders'], - 'x-speakeasy-group': 'documents', - 'x-speakeasy-name-override': 'list_folders', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/documents/folders/{id}': { - get: { - operationId: 'documents_get_folder', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,description,url,size,path,owner_id,remote_owner_id,parent_folder_id,remote_parent_folder_id,drive_id,remote_drive_id,created_at,updated_at,has_content,has_children,is_root,all_parent_folder_ids,remote_all_parent_folder_ids,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'include', - required: false, - in: 'query', - description: 'The comma separated list of fields that will be included in the response', - schema: { - nullable: true, - example: 'all_parent_folder_ids', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The folder with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/FolderResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Folder', - tags: ['Folders'], - 'x-speakeasy-group': 'documents', - 'x-speakeasy-name-override': 'get_folder', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/documents/drives': { - get: { - operationId: 'documents_list_drives', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,description,url,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of drives was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/DrivesPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Drives', - tags: ['Drives'], - 'x-speakeasy-group': 'documents', - 'x-speakeasy-name-override': 'list_drives', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/documents/drives/{id}': { - get: { - operationId: 'documents_get_drive', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,description,url,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The drive with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/DriveResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Drive', - tags: ['Drives'], - 'x-speakeasy-group': 'documents', - 'x-speakeasy-name-override': 'get_drive', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - }, - info: { - title: 'Documents', - description: 'The documentation for the StackOne Unified API - DOCUMENTS', - version: '1.0.0', - contact: {}, - }, - tags: [ - { - name: 'Files', - description: 'Files that can be uploaded or managed.', - }, - { - name: 'Folders', - description: 'Folders for organizing files.', - }, - { - name: 'Drives', - description: 'Drives for storing and managing files.', - }, - ], - servers: [ - { - url: 'https://api.stackone.com', - }, - ], - components: { - securitySchemes: { - basic: { - type: 'http', - scheme: 'basic', - }, - }, - schemas: { - BadGatewayResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 502, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Bad Gateway', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - BadRequestResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 400, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Bad Request', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - data: { - description: 'Error details', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/UnifiedError', - }, - ], - }, - provider_errors: { - description: 'List of provider-specific errors', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/ProviderError', - }, - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - ConfidentialEnumApiModel: { - type: 'object', - properties: { - value: { - type: 'string', - description: 'Whether the file is confidential or not', - enum: ['true', 'false', 'unmapped_value', null], - example: 'true', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - example: 'public', - nullable: true, - }, - }, - }, - ConflictResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 409, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Conflict', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - DownloadApiModel: { - type: 'object', - properties: { - headers: { - description: 'Headers related to the download', - allOf: [ - { - $ref: '#/components/schemas/DownloadHeadersApiModel', - }, - ], - }, - data: { - type: 'string', - description: 'The file data in binary format', - format: 'binary', - }, - }, - required: ['headers', 'data'], - }, - DownloadHeadersApiModel: { - type: 'object', - properties: { - 'content-disposition': { - type: 'string', - description: 'Value of the Content-Disposition header', - example: 'attachment; filename="example.pdf"', - nullable: true, - }, - 'content-type': { - type: 'string', - description: 'MIME type of the file', - example: 'application/pdf', - nullable: true, - }, - 'content-length': { - type: 'number', - description: 'Size of the content in bytes', - example: 1024, - nullable: true, - }, - 'content-range': { - type: 'string', - description: 'Range of the content being sent', - example: 'bytes 0-1023/2048', - nullable: true, - }, - 'content-encoding': { - type: 'string', - description: 'Encoding of the content', - example: 'gzip', - nullable: true, - }, - 'transfer-encoding': { - type: 'string', - description: 'Transfer encoding type', - example: 'chunked', - nullable: true, - }, - }, - }, - DriveResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/Drives', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - Drives: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'The ID associated with this drive', - example: '16873-IT345', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - description: 'The name associated with this drive', - example: 'USA Development Drive', - nullable: true, - }, - description: { - type: 'string', - description: 'The description associated with this drive', - example: 'Drive with USA Development documents', - nullable: true, - }, - url: { - type: 'string', - description: 'The url of the drive', - example: 'https://test.sharepoint.com/Document%20Library', - nullable: true, - }, - created_at: { - type: 'string', - description: 'The created date of the drive', - example: '2023-02-23T00:00:00.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'The last updated date of the drive', - example: '2024-02-23T00:00:00.000Z', - format: 'date-time', - nullable: true, - }, - }, - }, - DrivesPaginated: { - type: 'object', - properties: { - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/Drives', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - FileFormatEnum: { - type: 'object', - properties: { - value: { - type: 'string', - description: 'The file format of the file, expressed as a file extension', - enum: [ - 'unmapped_value', - 'ez', - 'aw', - 'atom', - 'atomcat', - 'atomdeleted', - 'atomsvc', - 'dwd', - 'held', - 'rsat', - 'bdoc', - 'xcs', - 'ccxml', - 'cdfx', - 'cdmia', - 'cdmic', - 'cdmid', - 'cdmio', - 'cdmiq', - 'cu', - 'mpd', - 'davmount', - 'dbk', - 'dssc', - 'xdssc', - 'es', - 'ecma', - 'emma', - 'emotionml', - 'epub', - 'exi', - 'exp', - 'fdt', - 'pfr', - 'geojson', - 'gml', - 'gpx', - 'gxf', - 'gz', - 'hjson', - 'stk', - 'ink', - 'inkml', - 'ipfix', - 'its', - 'jar', - 'war', - 'ear', - 'ser', - 'class', - 'js', - 'mjs', - 'json', - 'map', - 'json5', - 'jsonml', - 'jsonld', - 'lgr', - 'lostxml', - 'hqx', - 'cpt', - 'mads', - 'webmanifest', - 'mrc', - 'mrcx', - 'ma', - 'nb', - 'mb', - 'mathml', - 'mbox', - 'mscml', - 'metalink', - 'meta4', - 'mets', - 'maei', - 'musd', - 'mods', - 'm21', - 'mp21', - 'mp4s', - 'm4p', - 'doc', - 'dot', - 'mxf', - 'nq', - 'nt', - 'cjs', - 'bin', - 'dms', - 'lrf', - 'mar', - 'so', - 'dist', - 'distz', - 'pkg', - 'bpk', - 'dump', - 'elc', - 'deploy', - 'exe', - 'dll', - 'deb', - 'dmg', - 'iso', - 'img', - 'msi', - 'msp', - 'msm', - 'buffer', - 'oda', - 'opf', - 'ogx', - 'omdoc', - 'onetoc', - 'onetoc2', - 'onetmp', - 'onepkg', - 'oxps', - 'relo', - 'xer', - 'pdf', - 'pgp', - 'asc', - 'sig', - 'prf', - 'p10', - 'p7m', - 'p7c', - 'p7s', - 'p8', - 'ac', - 'cer', - 'crl', - 'pkipath', - 'pki', - 'pls', - 'ai', - 'eps', - 'ps', - 'provx', - 'pskcxml', - 'raml', - 'rdf', - 'owl', - 'rif', - 'rnc', - 'rl', - 'rld', - 'rs', - 'rapd', - 'sls', - 'rusd', - 'gbr', - 'mft', - 'roa', - 'rsd', - 'rss', - 'rtf', - 'sbml', - 'scq', - 'scs', - 'spq', - 'spp', - 'sdp', - 'senmlx', - 'sensmlx', - 'setpay', - 'setreg', - 'shf', - 'siv', - 'sieve', - 'smi', - 'smil', - 'rq', - 'srx', - 'gram', - 'grxml', - 'sru', - 'ssdl', - 'ssml', - 'swidtag', - 'tei', - 'teicorpus', - 'tfi', - 'tsd', - 'toml', - 'trig', - 'ttml', - 'ubj', - 'rsheet', - 'td', - 'vxml', - 'wasm', - 'wgt', - 'hlp', - 'wsdl', - 'wspolicy', - 'xaml', - 'xav', - 'xca', - 'xdf', - 'xel', - 'xns', - 'xenc', - 'xhtml', - 'xht', - 'xlf', - 'xml', - 'xsl', - 'xsd', - 'rng', - 'dtd', - 'xop', - 'xpl', - '*xsl', - 'xslt', - 'xspf', - 'mxml', - 'xhvml', - 'xvml', - 'xvm', - 'yang', - 'yin', - 'zip', - '*3gpp', - 'adp', - 'amr', - 'au', - 'snd', - 'mid', - 'midi', - 'kar', - 'rmi', - 'mxmf', - '*mp3', - 'm4a', - 'mp4a', - 'mpga', - 'mp2', - 'mp2a', - 'mp3', - 'm2a', - 'm3a', - 'oga', - 'ogg', - 'spx', - 'opus', - 's3m', - 'sil', - 'wav', - '*wav', - 'weba', - 'xm', - 'ttc', - 'otf', - 'ttf', - 'woff', - 'woff2', - 'exr', - 'apng', - 'avif', - 'bmp', - 'cgm', - 'drle', - 'emf', - 'fits', - 'g3', - 'gif', - 'heic', - 'heics', - 'heif', - 'heifs', - 'hej2', - 'hsj2', - 'ief', - 'jls', - 'jp2', - 'jpg2', - 'jpeg', - 'jpg', - 'jpe', - 'jph', - 'jhc', - 'jpm', - 'jpx', - 'jpf', - 'jxr', - 'jxra', - 'jxrs', - 'jxs', - 'jxsc', - 'jxsi', - 'jxss', - 'ktx', - 'ktx2', - 'png', - 'sgi', - 'svg', - 'svgz', - 't38', - 'tif', - 'tiff', - 'tfx', - 'webp', - 'wmf', - 'disposition-notification', - 'u8msg', - 'u8dsn', - 'u8mdn', - 'u8hdr', - 'eml', - 'mime', - '3mf', - 'gltf', - 'glb', - 'igs', - 'iges', - 'msh', - 'mesh', - 'silo', - 'mtl', - 'obj', - 'stpx', - 'stpz', - 'stpxz', - 'stl', - 'wrl', - 'vrml', - '*x3db', - 'x3dbz', - 'x3db', - '*x3dv', - 'x3dvz', - 'x3d', - 'x3dz', - 'x3dv', - 'appcache', - 'manifest', - 'ics', - 'ifb', - 'coffee', - 'litcoffee', - 'css', - 'csv', - 'html', - 'htm', - 'shtml', - 'jade', - 'jsx', - 'less', - 'markdown', - 'md', - 'mml', - 'mdx', - 'n3', - 'txt', - 'text', - 'conf', - 'def', - 'list', - 'log', - 'in', - 'ini', - 'rtx', - '*rtf', - 'sgml', - 'sgm', - 'shex', - 'slim', - 'slm', - 'spdx', - 'stylus', - 'styl', - 'tsv', - 't', - 'tr', - 'roff', - 'man', - 'me', - 'ms', - 'ttl', - 'uri', - 'uris', - 'urls', - 'vcard', - 'vtt', - '*xml', - 'yaml', - 'yml', - '3gp', - '3gpp', - '3g2', - 'h261', - 'h263', - 'h264', - 'm4s', - 'jpgv', - '*jpm', - 'jpgm', - 'mj2', - 'mjp2', - 'ts', - 'mp4', - 'mp4v', - 'mpg4', - 'mpeg', - 'mpg', - 'mpe', - 'm1v', - 'm2v', - 'ogv', - 'qt', - 'mov', - 'webm', - 'cww', - '1km', - 'plb', - 'psb', - 'pvb', - 'tcap', - 'pwn', - 'aso', - 'imp', - 'acu', - 'atc', - 'acutc', - 'air', - 'fcdt', - 'fxp', - 'fxpl', - 'xdp', - 'xfdf', - 'ahead', - 'azf', - 'azs', - 'azw', - 'acc', - 'ami', - 'apk', - 'cii', - 'fti', - 'atx', - 'mpkg', - 'key', - 'm3u8', - 'numbers', - 'pages', - 'pkpass', - 'swi', - 'iota', - 'aep', - 'bmml', - 'mpm', - 'bmi', - 'rep', - 'cdxml', - 'mmd', - 'cdy', - 'csl', - 'cla', - 'rp9', - 'c4g', - 'c4d', - 'c4f', - 'c4p', - 'c4u', - 'c11amc', - 'c11amz', - 'csp', - 'cdbcmsg', - 'cmc', - 'clkx', - 'clkk', - 'clkp', - 'clkt', - 'clkw', - 'wbs', - 'pml', - 'ppd', - 'car', - 'pcurl', - 'dart', - 'rdz', - 'dbf', - 'uvf', - 'uvvf', - 'uvd', - 'uvvd', - 'uvt', - 'uvvt', - 'uvx', - 'uvvx', - 'uvz', - 'uvvz', - 'fe_launch', - 'dna', - 'mlp', - 'mle', - 'dpg', - 'dfac', - 'kpxx', - 'ait', - 'svc', - 'geo', - 'mag', - 'nml', - 'esf', - 'msf', - 'qam', - 'slt', - 'ssf', - 'es3', - 'et3', - 'ez2', - 'ez3', - 'fdf', - 'mseed', - 'seed', - 'dataless', - 'gph', - 'ftc', - 'fm', - 'frame', - 'maker', - 'book', - 'fnc', - 'ltf', - 'fsc', - 'oas', - 'oa2', - 'oa3', - 'fg5', - 'bh2', - 'ddd', - 'xdw', - 'xbd', - 'fzs', - 'txd', - 'ggb', - 'ggt', - 'gex', - 'gre', - 'gxt', - 'g2w', - 'g3w', - 'gmx', - 'gdoc', - 'gslides', - 'gsheet', - 'kml', - 'kmz', - 'gqf', - 'gqs', - 'gac', - 'ghf', - 'gim', - 'grv', - 'gtm', - 'tpl', - 'vcg', - 'hal', - 'zmm', - 'hbci', - 'les', - 'hpgl', - 'hpid', - 'hps', - 'jlt', - 'pcl', - 'pclxl', - 'sfd-hdstx', - 'mpy', - 'afp', - 'listafp', - 'list3820', - 'irm', - 'sc', - 'icc', - 'icm', - 'igl', - 'ivp', - 'ivu', - 'igm', - 'xpw', - 'xpx', - 'i2g', - 'qbo', - 'qfx', - 'rcprofile', - 'irp', - 'xpr', - 'fcs', - 'jam', - 'rms', - 'jisp', - 'joda', - 'ktz', - 'ktr', - 'karbon', - 'chrt', - 'kfo', - 'flw', - 'kon', - 'kpr', - 'kpt', - 'ksp', - 'kwd', - 'kwt', - 'htke', - 'kia', - 'kne', - 'knp', - 'skp', - 'skd', - 'skt', - 'skm', - 'sse', - 'lasxml', - 'lbd', - 'lbe', - 'apr', - 'pre', - 'nsf', - 'org', - 'scm', - 'lwp', - 'portpkg', - 'mvt', - 'mcd', - 'mc1', - 'cdkey', - 'mwf', - 'mfm', - 'flo', - 'igx', - 'mif', - 'daf', - 'dis', - 'mbk', - 'mqy', - 'msl', - 'plc', - 'txf', - 'mpn', - 'mpc', - 'xul', - 'cil', - 'cab', - 'xls', - 'xlm', - 'xla', - 'xlc', - 'xlt', - 'xlw', - 'xlam', - 'xlsb', - 'xlsm', - 'xltm', - 'eot', - 'chm', - 'ims', - 'lrm', - 'thmx', - 'msg', - 'cat', - '*stl', - 'ppt', - 'pps', - 'pot', - 'ppam', - 'pptm', - 'sldm', - 'ppsm', - 'potm', - 'mpp', - 'mpt', - 'docm', - 'dotm', - 'wps', - 'wks', - 'wcm', - 'wdb', - 'wpl', - 'xps', - 'mseq', - 'mus', - 'msty', - 'taglet', - 'nlu', - 'ntf', - 'nitf', - 'nnd', - 'nns', - 'nnw', - '*ac', - 'ngdat', - 'n-gage', - 'rpst', - 'rpss', - 'edm', - 'edx', - 'ext', - 'odc', - 'otc', - 'odb', - 'odf', - 'odft', - 'odg', - 'otg', - 'odi', - 'oti', - 'odp', - 'otp', - 'ods', - 'ots', - 'odt', - 'odm', - 'ott', - 'oth', - 'xo', - 'dd2', - 'obgx', - 'oxt', - 'osm', - 'pptx', - 'sldx', - 'ppsx', - 'potx', - 'xlsx', - 'xltx', - 'docx', - 'dotx', - 'mgp', - 'dp', - 'esa', - 'pdb', - 'pqa', - 'oprc', - 'paw', - 'str', - 'ei6', - 'efif', - 'wg', - 'plf', - 'pbd', - 'box', - 'mgz', - 'qps', - 'ptid', - 'qxd', - 'qxt', - 'qwd', - 'qwt', - 'qxl', - 'qxb', - 'rar', - 'bed', - 'mxl', - 'musicxml', - 'cryptonote', - 'cod', - 'rm', - 'rmvb', - 'link66', - 'st', - 'see', - 'sema', - 'semd', - 'semf', - 'ifm', - 'itp', - 'iif', - 'ipk', - 'twd', - 'twds', - 'mmf', - 'teacher', - 'fo', - 'sdkm', - 'sdkd', - 'dxp', - 'sfs', - 'sdc', - 'sda', - 'sdd', - 'smf', - 'sdw', - 'vor', - 'sgl', - 'smzip', - 'sm', - 'wadl', - 'sxc', - 'stc', - 'sxd', - 'std', - 'sxi', - 'sti', - 'sxm', - 'sxw', - 'sxg', - 'stw', - 'sus', - 'susp', - 'svd', - 'sis', - 'sisx', - 'xsm', - 'bdm', - 'xdm', - 'ddf', - 'tao', - 'pcap', - 'cap', - 'dmp', - 'tmo', - 'tpt', - 'mxs', - 'tra', - 'ufd', - 'ufdl', - 'utz', - 'umj', - 'unityweb', - 'uoml', - 'vcx', - 'vsd', - 'vst', - 'vss', - 'vsw', - 'vis', - 'vsf', - 'wbxml', - 'wmlc', - 'wmlsc', - 'wtb', - 'nbp', - 'wpd', - 'wqd', - 'stf', - 'xar', - 'xfdl', - 'hvd', - 'hvs', - 'hvp', - 'osf', - 'osfpvg', - 'saf', - 'spf', - 'cmp', - 'zir', - 'zirz', - 'zaz', - '7z', - 'abw', - 'ace', - '*dmg', - 'arj', - 'aab', - 'x32', - 'u32', - 'vox', - 'aam', - 'aas', - 'bcpio', - '*bdoc', - 'torrent', - 'blb', - 'blorb', - 'bz', - 'bz2', - 'boz', - 'cbr', - 'cba', - 'cbt', - 'cbz', - 'cb7', - 'vcd', - 'cfs', - 'chat', - 'pgn', - 'crx', - 'cco', - 'nsc', - 'cpio', - 'csh', - '*deb', - 'udeb', - 'dgc', - 'dir', - 'dcr', - 'dxr', - 'cst', - 'cct', - 'cxt', - 'w3d', - 'fgd', - 'swa', - 'wad', - 'ncx', - 'dtb', - 'res', - 'dvi', - 'evy', - 'eva', - 'bdf', - 'gsf', - 'psf', - 'pcf', - 'snf', - 'pfa', - 'pfb', - 'pfm', - 'afm', - 'arc', - 'spl', - 'gca', - 'ulx', - 'gnumeric', - 'gramps', - 'gtar', - 'hdf', - 'php', - 'install', - '*iso', - '*key', - '*numbers', - '*pages', - 'jardiff', - 'jnlp', - 'kdbx', - 'latex', - 'luac', - 'lzh', - 'lha', - 'run', - 'mie', - 'prc', - 'mobi', - 'application', - 'lnk', - 'wmd', - 'wmz', - 'xbap', - 'mdb', - 'obd', - 'crd', - 'clp', - '*exe', - '*dll', - 'com', - 'bat', - '*msi', - 'mvb', - 'm13', - 'm14', - '*wmf', - '*wmz', - '*emf', - 'emz', - 'mny', - 'pub', - 'scd', - 'trm', - 'wri', - 'nc', - 'cdf', - 'pac', - 'nzb', - 'pl', - 'pm', - '*prc', - '*pdb', - 'p12', - 'pfx', - 'p7b', - 'spc', - 'p7r', - '*rar', - 'rpm', - 'ris', - 'sea', - 'sh', - 'shar', - 'swf', - 'xap', - 'sql', - 'sit', - 'sitx', - 'srt', - 'sv4cpio', - 'sv4crc', - 't3', - 'gam', - 'tar', - 'tcl', - 'tk', - 'tex', - 'tfm', - 'texinfo', - 'texi', - '*obj', - 'ustar', - 'hdd', - 'ova', - 'ovf', - 'vbox', - 'vbox-extpack', - 'vdi', - 'vhd', - 'vmdk', - 'src', - 'webapp', - 'der', - 'crt', - 'pem', - 'fig', - '*xlf', - 'xpi', - 'xz', - 'z1', - 'z2', - 'z3', - 'z4', - 'z5', - 'z6', - 'z7', - 'z8', - 'uva', - 'uvva', - 'eol', - 'dra', - 'dts', - 'dtshd', - 'lvp', - 'pya', - 'ecelp4800', - 'ecelp7470', - 'ecelp9600', - 'rip', - 'aac', - 'aif', - 'aiff', - 'aifc', - 'caf', - 'flac', - '*m4a', - 'mka', - 'm3u', - 'wax', - 'wma', - 'ram', - 'ra', - 'rmp', - '*ra', - 'cdx', - 'cif', - 'cmdf', - 'cml', - 'csml', - 'xyz', - 'btif', - 'pti', - 'psd', - 'azv', - 'uvi', - 'uvvi', - 'uvg', - 'uvvg', - 'djvu', - 'djv', - '*sub', - 'dwg', - 'dxf', - 'fbs', - 'fpx', - 'fst', - 'mmr', - 'rlc', - 'ico', - 'dds', - 'mdi', - 'wdp', - 'npx', - 'b16', - 'tap', - 'vtf', - 'wbmp', - 'xif', - 'pcx', - '3ds', - 'ras', - 'cmx', - 'fh', - 'fhc', - 'fh4', - 'fh5', - 'fh7', - '*ico', - 'jng', - 'sid', - '*bmp', - '*pcx', - 'pic', - 'pct', - 'pnm', - 'pbm', - 'pgm', - 'ppm', - 'rgb', - 'tga', - 'xbm', - 'xpm', - 'xwd', - 'wsc', - 'dae', - 'dwf', - 'gdl', - 'gtw', - 'mts', - 'ogex', - 'x_b', - 'x_t', - 'vds', - 'usdz', - 'bsp', - 'vtu', - 'dsc', - 'curl', - 'dcurl', - 'mcurl', - 'scurl', - 'sub', - 'fly', - 'flx', - 'gv', - '3dml', - 'spot', - 'jad', - 'wml', - 'wmls', - 's', - 'asm', - 'c', - 'cc', - 'cxx', - 'cpp', - 'h', - 'hh', - 'dic', - 'htc', - 'f', - 'for', - 'f77', - 'f90', - 'hbs', - 'java', - 'lua', - 'mkd', - 'nfo', - 'opml', - '*org', - 'p', - 'pas', - 'pde', - 'sass', - 'scss', - 'etx', - 'sfv', - 'ymp', - 'uu', - 'vcs', - 'vcf', - 'uvh', - 'uvvh', - 'uvm', - 'uvvm', - 'uvp', - 'uvvp', - 'uvs', - 'uvvs', - 'uvv', - 'uvvv', - 'dvb', - 'fvt', - 'mxu', - 'm4u', - 'pyv', - 'uvu', - 'uvvu', - 'viv', - 'f4v', - 'fli', - 'flv', - 'm4v', - 'mkv', - 'mk3d', - 'mks', - 'mng', - 'asf', - 'asx', - 'vob', - 'wm', - 'wmv', - 'wmx', - 'wvx', - 'avi', - 'movie', - 'smv', - 'ice', - 'mht', - null, - ], - example: 'pdf', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - example: 'application/pdf', - nullable: true, - }, - }, - }, - FileResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/Files', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - Files: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - description: 'The name associated with this file', - example: 'Information-Technology', - nullable: true, - }, - description: { - type: 'string', - description: 'The description of the file', - example: 'This is the description associated to the file.', - nullable: true, - }, - size: { - type: 'number', - description: 'The size of this file', - example: 1024, - nullable: true, - }, - url: { - type: 'string', - description: 'The url of the file', - example: 'https://drive.google.com/file/d/nd8932h9d/view', - nullable: true, - }, - file_format: { - description: 'The file format of the file', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/FileFormatEnum', - }, - ], - }, - path: { - type: 'string', - description: 'The path where the file is stored', - example: '/path/to/file', - nullable: true, - }, - owner_id: { - type: 'string', - description: 'The user ID of owner of this file', - example: 'c28xyrc55866bvuv', - nullable: true, - }, - export_formats: { - description: 'List of supported export formats', - example: ['application/pdf'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - default_download_format: { - type: 'string', - description: 'Default download format', - example: 'application/pdf', - nullable: true, - }, - remote_owner_id: { - type: 'string', - description: "Provider's unique identifier of the owner of this file", - example: 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - nullable: true, - }, - folder_id: { - type: 'string', - description: 'The parent folder ID associated with this file', - example: 'c28xyrc55866bvuv', - nullable: true, - }, - remote_folder_id: { - type: 'string', - description: - "Provider's unique identifier of the parent folder associated with this file", - example: 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - nullable: true, - }, - drive_id: { - type: 'string', - description: 'The parent drive ID associated with this file', - example: 'c28xyrc55866bvuv', - nullable: true, - }, - remote_drive_id: { - type: 'string', - description: - "Provider's unique identifier of the parent drive associated with this file", - example: 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - nullable: true, - }, - created_at: { - type: 'string', - description: 'The created date of the file', - example: '2023-02-23T00:00:00.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'The last updated date of the file', - example: '2024-02-23T00:00:00.000Z', - format: 'date-time', - nullable: true, - }, - has_content: { - description: 'Whether the file has content', - example: true, - oneOf: [ - { - type: 'boolean', - }, - { - type: 'string', - enum: ['true', 'false'], - }, - ], - nullable: true, - }, - has_children: { - description: 'Whether the file has children', - example: true, - oneOf: [ - { - type: 'boolean', - }, - { - type: 'string', - enum: ['true', 'false'], - }, - ], - nullable: true, - }, - all_parent_folder_ids: { - description: 'List of containing parent Folder IDs in descending order', - example: ['0123456789'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - }, - }, - FilesPaginated: { - type: 'object', - properties: { - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/Files', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - FolderResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/Folders', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - Folders: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - description: 'The name associated with this folder', - example: 'Information-Technology', - nullable: true, - }, - description: { - type: 'string', - description: 'The description of the folder', - example: 'This is the description associated to the folder.', - nullable: true, - }, - size: { - type: 'number', - description: 'The size of this folder in bytes', - example: 1024, - nullable: true, - }, - url: { - type: 'string', - description: 'The url of the folder', - example: 'https://drive.google.com/folder/d/nd8932h9d/view', - nullable: true, - }, - path: { - type: 'string', - description: 'The path where the folder is stored', - example: '/path/to/folder', - nullable: true, - }, - owner_id: { - type: 'string', - description: 'The user ID of owner of this folder', - example: 'c28xyrc55866bvuv', - nullable: true, - }, - remote_owner_id: { - type: 'string', - description: "Provider's unique identifier of the owner of this folder", - example: 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - nullable: true, - }, - parent_folder_id: { - type: 'string', - description: 'The parent folder ID associated with this folder', - example: 'c28xyrc55866bvuv', - nullable: true, - }, - remote_parent_folder_id: { - type: 'string', - description: - "Provider's unique identifier of the parent folder associated with this folder", - example: 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - nullable: true, - }, - drive_id: { - type: 'string', - description: 'The parent drive ID associated with this folder', - example: 'c28xyrc55866bvuv', - nullable: true, - }, - remote_drive_id: { - type: 'string', - description: - "Provider's unique identifier of the parent drive associated with this folder", - example: 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - nullable: true, - }, - created_at: { - type: 'string', - description: 'The created date of the folder', - example: '2023-02-23T00:00:00.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'The last updated date of the folder', - example: '2024-02-23T00:00:00.000Z', - format: 'date-time', - nullable: true, - }, - has_content: { - description: 'Whether the folder has content', - example: true, - oneOf: [ - { - type: 'boolean', - }, - { - type: 'string', - enum: ['true', 'false'], - }, - ], - nullable: true, - }, - has_children: { - description: 'Whether the folder has children', - example: true, - oneOf: [ - { - type: 'boolean', - }, - { - type: 'string', - enum: ['true', 'false'], - }, - ], - nullable: true, - }, - is_root: { - description: 'Whether the folder is at the root level of the drive', - example: true, - oneOf: [ - { - type: 'boolean', - }, - { - type: 'string', - enum: ['true', 'false'], - }, - ], - nullable: true, - }, - all_parent_folder_ids: { - description: 'List of containing parent Folder IDs in descending order', - example: ['0123456789'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - }, - }, - FoldersPaginated: { - type: 'object', - properties: { - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/Folders', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - ForbiddenResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 403, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Forbidden resource', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - InternalServerErrorResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 500, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Internal server error', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - NotFoundResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 404, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Not Found', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - NotImplementedResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 501, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Not Implemented', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - PreconditionFailedResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 412, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Precondition failed', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - ProviderError: { - type: 'object', - properties: { - status: { - type: 'number', - description: 'HTTP status code of the provider error', - example: 400, - nullable: true, - }, - url: { - type: 'string', - description: 'URL that caused the error', - example: 'https://api.provider.com/v1/resource', - nullable: true, - }, - raw: { - type: 'object', - description: 'Raw error response from the provider', - example: { - message: 'Invalid input parameters', - }, - nullable: true, - }, - headers: { - type: 'object', - description: 'Response headers', - example: { - 'content-type': 'application/json', - 'x-request-id': '5678c28b211dace4e0a0f9171e6b88c5', - }, - nullable: true, - }, - }, - }, - ProviderErrorApiModel: { - type: 'object', - properties: { - status: { - type: 'number', - example: 400, - nullable: true, - }, - url: { - type: 'string', - example: 'https://api.someprovider.com/v1/endpoint', - nullable: true, - }, - raw: { - type: 'object', - nullable: true, - }, - headers: { - type: 'object', - example: { - date: 'Tue, 02 Apr 2024 13:52:01 GMT', - 'content-type': 'application/json; charset=utf-8', - 'transfer-encoding': 'chunked', - connection: 'close', - }, - nullable: true, - }, - }, - }, - RawResponse: { - type: 'object', - properties: { - method: { - type: 'string', - }, - url: { - type: 'string', - }, - body: { - oneOf: [ - { - type: 'string', - }, - { - type: 'object', - }, - { - type: 'array', - items: { - type: 'integer', - format: 'int32', - minimum: 0, - maximum: 255, - }, - }, - ], - additionalProperties: true, - nullable: true, - }, - response: { - oneOf: [ - { - type: 'object', - additionalProperties: true, - }, - { - type: 'array', - items: {}, - }, - { - type: 'string', - }, - ], - nullable: true, - }, - }, - required: ['method', 'url'], - }, - RequestTimedOutResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 408, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Request timed out', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - TooManyRequestsResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 429, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Too many requests', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - UnauthorizedResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 401, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Unauthorized', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - UnifiedError: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 400, - nullable: true, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Bad Request', - nullable: true, - }, - headers: { - type: 'object', - description: 'Response headers', - example: { - 'content-type': 'application/json', - 'x-request-id': '5678c28b211dace4e0a0f9171e6b88c5', - }, - nullable: true, - }, - }, - }, - UnifiedUploadCategoryEnumApiModel: { - type: 'object', - properties: { - value: { - type: 'string', - description: 'The category name for associating uploaded files.', - example: 'reports, resumes', - nullable: true, - }, - source_value: { - type: 'string', - description: - 'The provider specific category for associating uploaded files, if provided, the value will be ignored.', - example: '550e8400-e29b-41d4-a716-446655440000, CUSTOM_CATEGORY_NAME', - nullable: true, - }, - }, - }, - UnifiedUploadRequestDto: { - type: 'object', - properties: { - name: { - type: 'string', - description: 'The filename of the file to upload', - example: 'weather-forecast', - nullable: true, - }, - file_format: { - description: 'The file format of the file', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/FileFormatEnum', - }, - ], - }, - content: { - type: 'string', - description: 'The base64 encoded content of the file to upload', - example: - 'VGhpcyBpc24ndCByZWFsbHkgYSBzYW1wbGUgZmlsZSwgYnV0IG5vIG9uZSB3aWxsIGV2ZXIga25vdyE', - nullable: true, - }, - category_id: { - type: 'string', - description: 'The categoryId of the documents', - example: '6530', - nullable: true, - }, - path: { - type: 'string', - description: 'The path for the file to be uploaded to', - example: '/path/to/file', - nullable: true, - }, - category: { - description: - 'The category object for associating uploaded files. If both an ID and a name are provided, the ID takes precedence.', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/UnifiedUploadCategoryEnumApiModel', - }, - ], - }, - confidential: { - description: 'The confidentiality level of the file to be uploaded', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/ConfidentialEnumApiModel', - }, - ], - }, - }, - }, - UnifiedWarningApiModel: { - type: 'object', - properties: { - message: { - type: 'string', - example: 'The provided field type is not supported in the current model.', - nullable: true, - }, - }, - }, - UnprocessableEntityResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 422, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Unprocessable Entity', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - WriteResultApiModel: { - type: 'object', - properties: { - statusCode: { - type: 'number', - example: 201, - nullable: true, - }, - message: { - type: 'string', - example: 'Employee created successfully', - nullable: true, - }, - timestamp: { - type: 'string', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - provider_errors: { - example: [ - { - status: 400, - url: 'https://api.someprovider.com/v1/endpoint', - raw: { - error: 'Bad Request', - message: 'The supplied data is invalid', - }, - headers: { - date: 'Tue, 02 Apr 2024 13:52:01 GMT', - 'content-type': 'application/json; charset=utf-8', - 'transfer-encoding': 'chunked', - connection: 'close', - }, - }, - ], - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/ProviderErrorApiModel', - }, - }, - unified_warnings: { - example: [ - { - message: 'The provided field type is not supported in the current model.', - }, - ], - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/UnifiedWarningApiModel', - }, - }, - }, - }, - }, - }, -}; diff --git a/src/openapi/generated/hris.ts b/src/openapi/generated/hris.ts deleted file mode 100644 index 58e68e56..00000000 --- a/src/openapi/generated/hris.ts +++ /dev/null @@ -1,29334 +0,0 @@ -// Generated OpenAPI specification for hris -// DO NOT EDIT THIS FILE DIRECTLY -export const hrisSpec = { - openapi: '3.1.0', - paths: { - '/unified/hris/companies': { - get: { - operationId: 'hris_list_companies', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,full_name,display_name,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of Companies was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CompaniesPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Companies', - tags: ['Companies'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'list_companies', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/companies/{id}': { - get: { - operationId: 'hris_get_company', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,full_name,display_name,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The Company with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CompanyResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Company', - tags: ['Companies'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'get_company', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/custom_field_definitions/employees': { - get: { - operationId: 'hris_list_employee_custom_field_definitions', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,name,description,type,options,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of employee custom field definitions was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CustomFieldDefinitionsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List employee Custom Field Definitions', - tags: ['Custom Field Definitions'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'list_employee_custom_field_definitions', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/custom_field_definitions/employees/{id}': { - get: { - operationId: 'hris_get_employee_custom_field_definition', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,name,description,type,options,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The employee custom field definition was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CustomFieldDefinitionResultApiModel', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get employee Custom Field Definition', - tags: ['Custom Field Definitions'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'get_employee_custom_field_definition', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/employees': { - get: { - operationId: 'hris_list_employees', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,title,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,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,created_at,updated_at,benefits,employee_number,national_identity_number,national_identity_numbers,bank_details,skills,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'HRIS Employees filters', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - email: { - description: 'Filter to select employees by email', - type: 'string', - nullable: true, - }, - employee_number: { - description: 'Filter to select employees by employee_number', - type: 'string', - nullable: true, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - { - name: 'expand', - required: false, - in: 'query', - description: 'The comma separated list of fields that will be expanded in the response', - schema: { - nullable: true, - example: 'company,employments,work_location,home_location,groups,skills', - type: 'string', - }, - }, - { - name: 'include', - required: false, - in: 'query', - description: 'The comma separated list of fields that will be included in the response', - schema: { - nullable: true, - example: 'avatar_url,avatar,custom_fields,job_description,benefits,bank_details', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of employees was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/EmployeesPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Employees', - tags: ['Employees'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'list_employees', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - 'x-speakeasy-usage-example': { - title: 'List Employees', - position: 1, - }, - }, - post: { - operationId: 'hris_create_employee', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/HrisCreateEmployeeRequestDto', - }, - }, - }, - }, - responses: { - '201': { - description: 'The employee was created successfully.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CreateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Create Employee', - tags: ['Employees'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'create_employee', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/employees/{id}': { - get: { - operationId: 'hris_get_employee', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,title,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,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,created_at,updated_at,benefits,employee_number,national_identity_number,national_identity_numbers,bank_details,skills,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'expand', - required: false, - in: 'query', - description: 'The comma separated list of fields that will be expanded in the response', - schema: { - nullable: true, - example: 'company,employments,work_location,home_location,groups,skills', - type: 'string', - }, - }, - { - name: 'include', - required: false, - in: 'query', - description: 'The comma separated list of fields that will be included in the response', - schema: { - nullable: true, - example: 'avatar_url,avatar,custom_fields,job_description,benefits,bank_details', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The employee with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/EmployeeResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Employee', - tags: ['Employees'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'get_employee', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - patch: { - operationId: 'hris_update_employee', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/HrisUpdateEmployeeRequestDto', - }, - }, - }, - }, - responses: { - '200': { - description: 'Record updated successfully', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UpdateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Update Employee', - tags: ['Employees'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'update_employee', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/employees/{id}/invite': { - post: { - operationId: 'hris_invite_employee', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/HrisInviteEmployeeRequestDto', - }, - }, - }, - }, - responses: { - '200': { - description: 'Record invited successfully', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InviteEmployeeResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Invite Employee', - tags: ['Employees'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'invite_employee', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/employees/{id}/shifts': { - get: { - operationId: 'hris_list_employee_shifts', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields to return in the response (if empty, all fields are returned)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'HRIS Employee Shifts filters', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - status: { - description: 'Filter to select shifts by status', - type: 'string', - nullable: true, - enum: ['draft', 'published', 'confirmed', 'cancelled', 'unmapped_value'], - }, - starts_after: { - description: 'Filter shifts that start after this date', - type: 'string', - format: 'datetime-local', - example: '2024-01-15T09:00', - }, - ends_before: { - description: 'Filter shifts that end before this date', - type: 'string', - format: 'datetime-local', - example: '2024-01-15T17:00', - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: - 'The shifts related to the employee with the given identifier were retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/HrisShiftsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Employee Shifts', - tags: ['Employees', 'Shifts'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'list_employee_shifts', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/employees/{id}/shifts/{subResourceId}': { - get: { - operationId: 'hris_get_employee_shift', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'subResourceId', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields to return in the response (if empty, all fields are returned)', - schema: { - nullable: true, - type: 'string', - }, - }, - ], - responses: { - '200': { - description: - 'The shift with the given identifier for the specified employee was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/HrisShiftResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Employee Shift', - tags: ['Employees', 'Shifts'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'get_employee_shift', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/employees/{id}/time_off': { - get: { - operationId: 'hris_list_employee_time_off_requests', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,employee_id,remote_employee_id,approver_id,remote_approver_id,status,type,start_date,end_date,start_half_day,end_half_day,time_off_policy_id,remote_time_off_policy_id,reason,comment,duration,created_at,updated_at,policy,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'HRIS Time Off filters', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - policy_ids: { - description: 'List of time off policy ids to filter by.', - nullable: true, - type: 'array', - items: { - type: 'string', - }, - additionalProperties: false, - }, - start_date: { - description: - 'Filter to include time off requests that start on or after this date.', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - nullable: true, - format: 'date-time', - additionalProperties: false, - }, - end_date: { - description: - 'Filter to include time off requests that end on or before this date.', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - nullable: true, - format: 'date-time', - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - { - name: 'expand', - required: false, - in: 'query', - description: 'The comma separated list of fields that will be expanded in the response', - schema: { - nullable: true, - example: 'policy', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: - 'The time off requests related to the employee with the given identifier were retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TimeOffPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Employee Time Off Requests', - tags: ['Employees', 'Time Off'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'list_employee_time_off_requests', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - post: { - operationId: 'hris_create_employee_time_off_request', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/HrisCreateTimeOffRequestDto', - }, - }, - }, - }, - responses: { - '201': { - description: 'Record created successfully.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CreateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Create Employee Time Off Request', - tags: ['Employees', 'Time Off'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'create_employee_time_off_request', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/employees/{id}/time_off/{subResourceId}': { - get: { - operationId: 'hris_get_employees_time_off_request', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'subResourceId', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,employee_id,remote_employee_id,approver_id,remote_approver_id,status,type,start_date,end_date,start_half_day,end_half_day,time_off_policy_id,remote_time_off_policy_id,reason,comment,duration,created_at,updated_at,policy,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'expand', - required: false, - in: 'query', - description: 'The comma separated list of fields that will be expanded in the response', - schema: { - nullable: true, - example: 'policy', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: - 'The time off request related to the employee with the given identifiers was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TimeOffResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Employees Time Off Request', - tags: ['Employees', 'Time Off'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'get_employees_time_off_request', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - patch: { - operationId: 'hris_update_employee_time_off_request', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'subResourceId', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/HrisCreateTimeOffRequestDto', - }, - }, - }, - }, - responses: { - '200': { - description: 'Record updated successfully', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CreateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Update Employee Time Off Request', - tags: ['Employees', 'Time Off'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'update_employee_time_off_request', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - delete: { - operationId: 'hris_cancel_employee_time_off_request', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'subResourceId', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'Record cancelled successfully.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/DeleteResult', - }, - }, - }, - }, - '204': { - description: - 'The time off request was cancelled successfully but no content was returned.', - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Cancel Employee Time Off Request', - tags: ['Employees', 'Time Off'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'cancel_employee_time_off_request', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/employees/{id}/documents/upload/batch': { - post: { - operationId: 'hris_batch_upload_employee_document', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/HrisBatchDocumentUploadRequestDto', - }, - }, - }, - }, - responses: { - '202': { - description: 'Batch operation accepted', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BatchResultApiModel', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Batch Upload Employee Document', - tags: ['Employees', 'Documents'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'batch_upload_employee_document', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/employees/{id}/documents/upload': { - post: { - operationId: 'hris_upload_employee_document', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/HrisDocumentsUploadRequestDto', - }, - }, - }, - }, - responses: { - '201': { - description: - 'The document related to the employee with the given identifier was uploaded.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/WriteResultApiModel', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Upload Employee Document', - tags: ['Employees', 'Documents'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'upload_employee_document', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/employees/{id}/documents/{subResourceId}/download': { - get: { - operationId: 'hris_download_employee_document', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'subResourceId', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'format', - required: false, - in: 'query', - description: 'The format to download the file in', - schema: { - nullable: true, - example: 'base64', - type: 'string', - }, - }, - { - name: 'export_format', - required: false, - in: 'query', - description: 'The export format of the file', - schema: { - nullable: true, - example: 'text/plain', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: - 'The document related to the employee with the given identifiers was retrieved.', - content: { - 'application/pdf': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'application/msword': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'application/vnd.openxmlformats-officedocument.wordprocessingml.document': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'application/vnd.ms-excel': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'application/vnd.ms-powerpoint': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'application/vnd.openxmlformats-officedocument.presentationml.presentation': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'application/rtf': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'text/plain': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'image/jpeg': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'image/png': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'image/gif': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'image/tiff': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'image/bmp': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'image/heic': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'application/zip': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'application/gzip': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'application/json': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'application/xml': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'text/csv': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'application/vnd.oasis.opendocument.text': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'application/vnd.oasis.opendocument.spreadsheet': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'audio/mpeg': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'video/mp4': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'video/webm': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'text/rtf': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'application/x-rar-compressed': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'application/x-7z-compressed': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'message/rfc822': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'application/vnd.ms-outlook': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'application/octet-stream': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'text/html': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'image/webp': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'application/vnd.oasis.opendocument.presentation': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'audio/wav': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'audio/mp4': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'video/avi': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - 'video/quicktime': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Download Employee Document', - tags: ['Employees', 'Documents'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'download_employee_document', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/employees/{id}/documents': { - get: { - operationId: 'hris_list_employee_documents', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,type,category,category_id,remote_category_id,contents,created_at,updated_at,remote_url,file_format,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: - 'The documents related to the employee with the given identifier were retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/HrisDocumentsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Employee Documents', - tags: ['Employees', 'Documents'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'list_employee_documents', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/employees/{id}/documents/{subResourceId}': { - get: { - operationId: 'hris_get_employee_document', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'subResourceId', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,type,category,category_id,remote_category_id,contents,created_at,updated_at,remote_url,file_format,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: - 'The document related to the employee with the given identifiers was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/HrisDocumentResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Employee Document', - tags: ['Employees', 'Documents'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'get_employee_document', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/documents/employee_categories': { - get: { - operationId: 'hris_list_employee_categories', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,name,active,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of employee document categories were retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ReferencePaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Employee Document Categories', - tags: ['Documents'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'list_employee_categories', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/documents/employee_categories/{id}': { - get: { - operationId: 'hris_get_employee_document_category', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,name,active,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The employee document category with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ReferenceResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Employee Document Category', - tags: ['Documents'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'get_employee_document_category', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/employees/{id}/work_eligibility': { - get: { - operationId: 'hris_list_employee_work_eligibility', - parameters: [ - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,type,sub_type,document,valid_from,valid_to,issued_by,number,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - ], - responses: { - '200': { - description: - 'The work eligibility of the employee with the given identifier were retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/WorkEligibilityPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Employee Work Eligibility', - tags: ['Employees', 'Work Eligibility'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'list_employee_work_eligibility', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - post: { - operationId: 'hris_create_employee_work_eligibility_request', - parameters: [ - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/HrisCreateWorkEligibilityRequestDto', - }, - }, - }, - }, - responses: { - '201': { - description: 'Record created successfully.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CreateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Create Employee Work Eligibility Request', - tags: ['Employees', 'Work Eligibility'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'create_employee_work_eligibility_request', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/employees/{id}/work_eligibility/{subResourceId}': { - get: { - operationId: 'hris_get_employees_work_eligibility', - parameters: [ - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'subResourceId', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,type,sub_type,document,valid_from,valid_to,issued_by,number,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - ], - responses: { - '200': { - description: - 'The work eligibility of the employee with the given identifiers was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/WorkEligibilityResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Employees Work Eligibility', - tags: ['Employees', 'Work Eligibility'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'get_employees_work_eligibility', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - patch: { - operationId: 'hris_update_employee_work_eligibility_request', - parameters: [ - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'subResourceId', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/HrisCreateWorkEligibilityRequestDto', - }, - }, - }, - }, - responses: { - '200': { - description: '', - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Update Employee Work Eligibility Request', - tags: ['Employees', 'Work Eligibility'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'update_employee_work_eligibility_request', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/employees/{id}/time_off_balances': { - get: { - operationId: 'hris_list_employee_time_off_balances', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,employee_id,remote_employee_id,policy_id,remote_policy_id,policy,current_balance,initial_balance,balance_unit,balance_start_date,balance_expiry_date,is_unlimited,updated_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'HRIS Time Off Balance filters', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - policy_ids: { - description: 'List of policy ids to filter time off balances by.', - type: 'array', - nullable: true, - items: { - type: 'string', - }, - additionalProperties: false, - required: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - { - name: 'expand', - required: false, - in: 'query', - description: 'The comma separated list of fields that will be expanded in the response', - schema: { - nullable: true, - example: 'policy', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: - 'The list of time off balances of the employee with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TimeOffBalancesPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Employee Time Off Balances', - tags: ['Employees', 'Time Off Balances'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'list_employee_time_off_balances', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/employees/{id}/time_off_balances/{subResourceId}': { - get: { - operationId: 'hris_get_employee_time_off_balance', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'subResourceId', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,employee_id,remote_employee_id,policy_id,remote_policy_id,policy,current_balance,initial_balance,balance_unit,balance_start_date,balance_expiry_date,is_unlimited,updated_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'expand', - required: false, - in: 'query', - description: 'The comma separated list of fields that will be expanded in the response', - schema: { - nullable: true, - example: 'policy', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: - 'The time off balance of the employee with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TimeOffBalanceResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Employee Time Off Balance', - tags: ['Employees', 'Time Off Balances'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'get_employee_time_off_balance', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/employments': { - get: { - operationId: 'hris_list_employments', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,employee_id,remote_employee_id,job_title,pay_rate,pay_period,pay_frequency,pay_currency,effective_date,end_date,employment_type,employment_contract_type,type,contract_type,change_reason,grade,work_time,payroll_code,fte,created_at,updated_at,start_date,active,department,team,cost_center,cost_centers,division,job,manager,groups,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - { - name: 'expand', - required: false, - in: 'query', - description: 'The comma separated list of fields that will be expanded in the response', - schema: { - nullable: true, - example: 'groups', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of Employments was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/EmploymentsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Employments', - tags: ['Employments'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'list_employments', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/employments/{id}': { - get: { - operationId: 'hris_get_employment', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,employee_id,remote_employee_id,job_title,pay_rate,pay_period,pay_frequency,pay_currency,effective_date,end_date,employment_type,employment_contract_type,type,contract_type,change_reason,grade,work_time,payroll_code,fte,created_at,updated_at,start_date,active,department,team,cost_center,cost_centers,division,job,manager,groups,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'expand', - required: false, - in: 'query', - description: 'The comma separated list of fields that will be expanded in the response', - schema: { - nullable: true, - example: 'groups', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The Employment with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/EmploymentResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Employment', - tags: ['Employments'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'get_employment', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/employees/{id}/employments': { - get: { - operationId: 'hris_list_employee_employments', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,employee_id,remote_employee_id,job_title,pay_rate,pay_period,pay_frequency,pay_currency,effective_date,end_date,employment_type,employment_contract_type,type,contract_type,change_reason,grade,work_time,payroll_code,fte,created_at,updated_at,start_date,active,department,team,cost_center,cost_centers,division,job,manager,groups,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - { - name: 'expand', - required: false, - in: 'query', - description: 'The comma separated list of fields that will be expanded in the response', - schema: { - nullable: true, - example: 'groups', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of Employee Employments was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/EmploymentsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Employee Employments', - tags: ['Employees', 'Employments'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'list_employee_employments', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - post: { - operationId: 'hris_create_employee_employment', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/HrisCreateEmploymentRequestDto', - }, - }, - }, - }, - responses: { - '201': { - description: 'The employee employment was created successfully.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CreateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Create Employee Employment', - tags: ['Employees', 'Employments'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'create_employee_employment', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/employees/{id}/employments/{subResourceId}': { - get: { - operationId: 'hris_get_employee_employment', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'subResourceId', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,employee_id,remote_employee_id,job_title,pay_rate,pay_period,pay_frequency,pay_currency,effective_date,end_date,employment_type,employment_contract_type,type,contract_type,change_reason,grade,work_time,payroll_code,fte,created_at,updated_at,start_date,active,department,team,cost_center,cost_centers,division,job,manager,groups,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'expand', - required: false, - in: 'query', - description: 'The comma separated list of fields that will be expanded in the response', - schema: { - nullable: true, - example: 'groups', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The Employee Employment with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/EmploymentResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Employee Employment', - tags: ['Employees', 'Employments'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'get_employee_employment', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - patch: { - operationId: 'hris_update_employee_employment', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'subResourceId', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/HrisUpdateEmploymentRequestDto', - }, - }, - }, - }, - responses: { - '200': { - description: 'The employee employment was updated successfully.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UpdateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Update Employee Employment', - tags: ['Employees', 'Employments'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'update_employee_employment', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/groups': { - get: { - operationId: 'hris_list_groups', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,type,parent_ids,remote_parent_ids,owner_ids,remote_owner_ids,company_id,remote_company_id,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of groups was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/HRISGroupsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Groups', - tags: ['Groups'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'list_groups', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/groups/departments': { - get: { - operationId: 'hris_list_department_groups', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,type,parent_ids,remote_parent_ids,owner_ids,remote_owner_ids,company_id,remote_company_id,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of department groups was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/HRISDepartmentsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Department Groups', - tags: ['Groups'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'list_department_groups', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/groups/cost_centers': { - get: { - operationId: 'hris_list_cost_center_groups', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,type,distribution_percentage,parent_ids,remote_parent_ids,owner_ids,remote_owner_ids,company_id,remote_company_id,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of cost center groups was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/HRISCostCenterPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Cost Center Groups', - tags: ['Groups'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'list_cost_center_groups', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/groups/teams': { - get: { - operationId: 'hris_list_team_groups', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,type,parent_ids,remote_parent_ids,owner_ids,remote_owner_ids,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of team groups was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/HRISTeamsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Team Groups', - tags: ['Groups'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'list_team_groups', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/groups/divisions': { - get: { - operationId: 'hris_list_division_groups', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,type,parent_ids,remote_parent_ids,owner_ids,remote_owner_ids,company_id,remote_company_id,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of division groups was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/HRISDivisionsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Division Groups', - tags: ['Groups'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'list_division_groups', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/groups/companies': { - get: { - operationId: 'hris_list_companies_groups', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,full_name,display_name,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of companies groups was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CompaniesPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Companies Groups', - tags: ['Groups'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'list_companies_groups', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/groups/{id}': { - get: { - operationId: 'hris_get_group', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,type,parent_ids,remote_parent_ids,owner_ids,remote_owner_ids,company_id,remote_company_id,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The group with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/HRISGroupsResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Group', - tags: ['Groups'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'get_group', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/groups/departments/{id}': { - get: { - operationId: 'hris_get_department_group', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,type,parent_ids,remote_parent_ids,owner_ids,remote_owner_ids,company_id,remote_company_id,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The department group with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/HRISDepartmentsResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Department Group', - tags: ['Groups'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'get_department_group', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/groups/cost_centers/{id}': { - get: { - operationId: 'hris_get_cost_center_group', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,type,distribution_percentage,parent_ids,remote_parent_ids,owner_ids,remote_owner_ids,company_id,remote_company_id,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The cost center group with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/HRISCostCenterResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Cost Center Group', - tags: ['Groups'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'get_cost_center_group', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/groups/teams/{id}': { - get: { - operationId: 'hris_get_team_group', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,type,parent_ids,remote_parent_ids,owner_ids,remote_owner_ids,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The team group with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/HRISTeamsResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Team Group', - tags: ['Groups'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'get_team_group', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/groups/divisions/{id}': { - get: { - operationId: 'hris_get_division_group', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,type,parent_ids,remote_parent_ids,owner_ids,remote_owner_ids,company_id,remote_company_id,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The division group with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/HRISDivisionsResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Division Group', - tags: ['Groups'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'get_division_group', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/groups/companies/{id}': { - get: { - operationId: 'hris_get_company_group', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,full_name,display_name,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The company group with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CompanyResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Company Group', - tags: ['Groups'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'get_company_group', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/jobs': { - get: { - operationId: 'hris_list_jobs', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,code,title,description,status,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of jobs was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/HrisJobsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Jobs', - tags: ['Jobs'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'list_jobs', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/jobs/{id}': { - get: { - operationId: 'hris_get_job', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,code,title,description,status,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The job with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/HrisJobResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Job', - tags: ['Jobs'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'get_job', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/locations': { - get: { - operationId: 'hris_list_locations', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,employee_id,remote_employee_id,name,phone_number,street_1,street_2,city,state,zip_code,country,location_type,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of work locations was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/HRISLocationsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Work Locations', - tags: ['Locations'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'list_locations', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/locations/{id}': { - get: { - operationId: 'hris_get_location', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,employee_id,remote_employee_id,name,phone_number,street_1,street_2,city,state,zip_code,country,location_type,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The work location with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/HRISLocationResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Work Location', - tags: ['Locations'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'get_location', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/positions': { - get: { - operationId: 'hris_list_positions', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields to return in the response (if empty, all fields are returned)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - { - name: 'status', - required: false, - in: 'query', - description: 'Filter positions by status', - 'x-speakeasy-unknown-values': 'allow', - schema: { - nullable: true, - example: 'open', - type: 'string', - enum: ['open', 'draft', 'closed', 'paused', 'unmapped_value', null], - }, - }, - ], - responses: { - '200': { - description: 'The list of positions was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PositionsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Positions', - tags: ['Positions'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'list_positions', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/positions/{id}': { - get: { - operationId: 'hris_get_position', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields to return in the response (if empty, all fields are returned)', - schema: { - nullable: true, - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The position with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PositionResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Position', - tags: ['Positions'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'get_position', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/time_entries': { - get: { - operationId: 'hris_list_time_entries', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,employee_id,remote_employee_id,start_time,end_time,hours_worked,break_duration,labor_type,location,status,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'HRIS Time Entries filters', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - employee_id: { - description: 'Filter to select time entries by employee_id', - type: 'string', - nullable: true, - additionalProperties: false, - }, - start_time: { - description: 'Filter to select time entries after a given time', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - nullable: true, - additionalProperties: false, - }, - end_time: { - description: 'Filter to select time entries before a given time', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of time entries was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TimeEntriesPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Time Entries', - tags: ['Time Entries'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'list_time_entries', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/time_entries/{id}': { - get: { - operationId: 'hris_get_time_entries', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,employee_id,remote_employee_id,start_time,end_time,hours_worked,break_duration,labor_type,location,status,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The time entry with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TimeEntriesResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Time Entry', - tags: ['Time Entries'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'get_time_entries', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/time_off': { - get: { - operationId: 'hris_list_time_off_requests', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,employee_id,remote_employee_id,approver_id,remote_approver_id,status,type,start_date,end_date,start_half_day,end_half_day,time_off_policy_id,remote_time_off_policy_id,reason,comment,duration,created_at,updated_at,policy,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'HRIS Time Off filters', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - policy_ids: { - description: 'List of time off policy ids to filter by.', - nullable: true, - type: 'array', - items: { - type: 'string', - }, - additionalProperties: false, - }, - start_date: { - description: - 'Filter to include time off requests that start on or after this date.', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - nullable: true, - format: 'date-time', - additionalProperties: false, - }, - end_date: { - description: - 'Filter to include time off requests that end on or before this date.', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - nullable: true, - format: 'date-time', - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - { - name: 'expand', - required: false, - in: 'query', - description: 'The comma separated list of fields that will be expanded in the response', - schema: { - nullable: true, - example: 'policy', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of time off requests was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TimeOffPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List time off requests', - tags: ['Time Off'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'list_time_off_requests', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/time_off/{id}': { - get: { - operationId: 'hris_get_time_off_request', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,employee_id,remote_employee_id,approver_id,remote_approver_id,status,type,start_date,end_date,start_half_day,end_half_day,time_off_policy_id,remote_time_off_policy_id,reason,comment,duration,created_at,updated_at,policy,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'expand', - required: false, - in: 'query', - description: 'The comma separated list of fields that will be expanded in the response', - schema: { - nullable: true, - example: 'policy', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The time off request with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TimeOffResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get time off request', - tags: ['Time Off'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'get_time_off_request', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/shifts': { - get: { - operationId: 'hris_list_shifts', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields to return in the response (if empty, all fields are returned)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'HRIS Shifts filters', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - status: { - description: 'Filter to select shifts by status', - type: 'string', - nullable: true, - enum: ['draft', 'published', 'confirmed', 'cancelled', 'unmapped_value'], - }, - starts_after: { - description: 'Filter shifts that start after this date', - type: 'string', - format: 'datetime-local', - example: '2024-01-15T09:00', - }, - ends_before: { - description: 'Filter shifts that end before this date', - type: 'string', - format: 'datetime-local', - example: '2024-01-15T17:00', - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of shifts was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/HrisShiftsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Shifts', - tags: ['Shifts'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'list_shifts', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/shifts/{id}': { - get: { - operationId: 'hris_get_shift', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields to return in the response (if empty, all fields are returned)', - schema: { - nullable: true, - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The shift with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/HrisShiftResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Shift', - tags: ['Shifts'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'get_shift', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/time_off_types': { - get: { - deprecated: true, - operationId: 'hris_list_time_off_types', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,name,active,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of time off types was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ReferencePaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List time off types', - tags: ['Time Off'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'list_time_off_types', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/time_off_types/{id}': { - get: { - deprecated: true, - operationId: 'hris_get_time_off_type', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,name,active,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The time off type with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ReferenceResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get time off type', - tags: ['Time Off'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'get_time_off_type', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/time_off_policies': { - get: { - operationId: 'hris_list_time_off_policies', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,description,type,duration_unit,reasons,updated_at,created_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'HRIS Time-Off Policies filters', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - type: { - description: 'Filter to select time-off policies by type', - enum: [ - 'sick', - 'unmapped_value', - 'vacation', - 'long_term_disability', - 'short_term_disability', - 'absent', - 'comp_time', - 'training', - 'annual_leave', - 'leave_of_absence', - 'break', - 'child_care_leave', - 'maternity_leave', - 'jury_duty', - 'sabbatical', - 'accident', - 'paid', - 'unpaid', - 'holiday', - 'personal', - 'in_lieu', - 'bereavement', - 'other', - null, - ], - nullable: true, - type: 'string', - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of time off policies was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TimeOffPoliciesPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Time Off Policies', - tags: ['Time Off Policies'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'list_time_off_policies', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/time_off_policies/{id}': { - get: { - operationId: 'hris_get_time_off_policy', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,description,type,duration_unit,reasons,updated_at,created_at,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The time off policy with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TimeOffPolicyResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Time Off Policy', - tags: ['Time Off Policies'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'get_time_off_policy', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/employees/{id}/time_off_policies': { - get: { - operationId: 'hris_list_employee_time_off_policies', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,description,type,duration_unit,reasons,updated_at,created_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'HRIS Time-Off Policies filters', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - type: { - description: 'Filter to select time-off policies by type', - enum: [ - 'sick', - 'unmapped_value', - 'vacation', - 'long_term_disability', - 'short_term_disability', - 'absent', - 'comp_time', - 'training', - 'annual_leave', - 'leave_of_absence', - 'break', - 'child_care_leave', - 'maternity_leave', - 'jury_duty', - 'sabbatical', - 'accident', - 'paid', - 'unpaid', - 'holiday', - 'personal', - 'in_lieu', - 'bereavement', - 'other', - null, - ], - nullable: true, - type: 'string', - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: - 'The time off policies related to the employee with the given identifier were retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TimeOffPoliciesPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Assigned Time Off Policies', - tags: ['Employees', 'Time Off Policies'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'list_employee_time_off_policies', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/benefits': { - get: { - operationId: 'hris_list_benefits', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,benefit_type,provider,description,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of Benefits was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/HRISBenefitsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List benefits', - tags: ['Benefits'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'list_benefits', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/benefits/{id}': { - get: { - operationId: 'hris_get_benefit', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,benefit_type,provider,description,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The Benefit with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/HRISBenefitResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Benefit', - tags: ['Benefits'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'get_benefit', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/employees/{id}/skills': { - get: { - operationId: 'hris_list_employee_skills', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,active,language,maximum_proficiency,minimum_proficiency,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: - 'The skills related to the employee with the given identifier were retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/EntitySkillsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Employee Skills', - tags: ['Employees', 'Skills'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'list_employee_skills', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - post: { - operationId: 'hris_create_employee_skill', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/EntitySkillsCreateRequestDto', - }, - }, - }, - }, - responses: { - '201': { - description: 'The skill was created successfully.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CreateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Create Employee Skill', - tags: ['Employees', 'Skills'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'create_employee_skill', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/employees/{id}/skills/{subResourceId}': { - get: { - operationId: 'hris_get_employee_skill', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'subResourceId', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,active,language,maximum_proficiency,minimum_proficiency,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: - 'The skill related to the employee with the given identifiers was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/EntitySkillResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Employee Skill', - tags: ['Employees', 'Skills'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'get_employee_skill', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/employees/{id}/tasks': { - get: { - operationId: 'hris_list_employee_tasks', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,employee_id,remote_employee_id,name,description,type,status,due_date,completion_date,assigned_by_employee_id,remote_assigned_by_employee_id,assigned_by_employee_name,link_to_task,extracted_links,next_task_id,remote_next_task_id,parent_process_name,comments,attachments,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - }, - created_after: { - description: - 'Use a string with a date to only select results created after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - }, - }, - additionalProperties: false, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - { - name: 'expand', - required: false, - in: 'query', - description: 'The comma separated list of fields that will be expanded in the response', - schema: { - nullable: true, - example: 'attachments', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: - 'The list of tasks for the employee with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TasksPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Employee Tasks', - tags: ['Employees', 'Tasks'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'list_employee_tasks', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/employees/{id}/tasks/{subResourceId}': { - get: { - operationId: 'hris_get_employee_task', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'subResourceId', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,employee_id,remote_employee_id,name,description,type,status,due_date,completion_date,assigned_by_employee_id,remote_assigned_by_employee_id,assigned_by_employee_name,link_to_task,extracted_links,next_task_id,remote_next_task_id,parent_process_name,comments,attachments,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'expand', - required: false, - in: 'query', - description: 'The comma separated list of fields that will be expanded in the response', - schema: { - nullable: true, - example: 'attachments', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The task with the given identifier for the employee was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TaskResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Employee Task', - tags: ['Employees', 'Tasks'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'get_employee_task', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - patch: { - operationId: 'hris_update_employee_task', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'subResourceId', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UpdateTaskRequestDto', - }, - }, - }, - }, - responses: { - '200': { - description: 'The task has been successfully updated.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UpdateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Update Employee Task', - tags: ['Employees', 'Tasks'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'update_employee_task', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/tasks': { - get: { - operationId: 'hris_list_tasks', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,employee_id,remote_employee_id,name,description,type,status,due_date,completion_date,assigned_by_employee_id,remote_assigned_by_employee_id,assigned_by_employee_name,link_to_task,extracted_links,next_task_id,remote_next_task_id,parent_process_name,comments,attachments,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - }, - created_after: { - description: - 'Use a string with a date to only select results created after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - }, - }, - additionalProperties: false, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - { - name: 'expand', - required: false, - in: 'query', - description: 'The comma separated list of fields that will be expanded in the response', - schema: { - nullable: true, - example: 'attachments', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of tasks was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TasksPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Tasks', - tags: ['Tasks'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'list_tasks', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/hris/tasks/{id}': { - get: { - operationId: 'hris_get_task', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,employee_id,remote_employee_id,name,description,type,status,due_date,completion_date,assigned_by_employee_id,remote_assigned_by_employee_id,assigned_by_employee_name,link_to_task,extracted_links,next_task_id,remote_next_task_id,parent_process_name,comments,attachments,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'expand', - required: false, - in: 'query', - description: 'The comma separated list of fields that will be expanded in the response', - schema: { - nullable: true, - example: 'attachments', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The task with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TaskResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Task', - tags: ['Tasks'], - 'x-speakeasy-group': 'hris', - 'x-speakeasy-name-override': 'get_task', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - }, - info: { - title: 'HRIS', - description: 'The documentation for the StackOne Unified API - HRIS', - version: '1.0.0', - contact: {}, - }, - tags: [ - { - name: 'Benefits', - description: 'Employee benefits and entitlements.', - }, - { - name: 'Companies', - description: 'Organizations or legal entities.', - }, - { - name: 'Custom Field Definitions', - description: 'Definitions for custom fields.', - }, - { - name: 'Documents', - description: 'Employee related documents.', - }, - { - name: 'Employees', - description: 'People employed by the company.', - }, - { - name: 'Employments', - description: "Details of an employee's employment.", - }, - { - name: 'Groups', - description: 'Organizational groups or teams.', - }, - { - name: 'Jobs', - description: 'Job positions or roles.', - }, - { - name: 'Locations', - description: 'Physical or virtual work locations.', - }, - { - name: 'Positions', - description: 'Job positions available for hiring.', - }, - { - name: 'Shifts', - description: 'Employee work shifts and schedules.', - }, - { - name: 'Skills', - description: 'Skills and competencies tracked for employees.', - }, - { - name: 'Tasks', - description: 'Tasks or assignments for employees.', - }, - { - name: 'Time Entries', - description: 'Records of hours worked or activities performed.', - }, - { - name: 'Time Off', - description: 'Employee leave and time off records.', - }, - { - name: 'Time Off Balances', - description: 'Available leave balances for employees.', - }, - { - name: 'Time Off Policies', - description: 'Rules and policies for employee leave.', - }, - { - name: 'Training', - description: 'Training records for employees.', - }, - { - name: 'Training Content', - description: 'Training content for employees.', - }, - { - name: 'Work Eligibility', - description: 'Eligibility status for employment.', - }, - ], - servers: [ - { - url: 'https://api.stackone.com', - }, - ], - components: { - securitySchemes: { - basic: { - type: 'http', - scheme: 'basic', - }, - }, - schemas: { - BadGatewayResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 502, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Bad Gateway', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - BadRequestResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 400, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Bad Request', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - data: { - description: 'Error details', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/UnifiedError', - }, - ], - }, - provider_errors: { - description: 'List of provider-specific errors', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/ProviderError', - }, - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - BankAccountTypeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - description: 'The type of bank account', - enum: [ - 'savings', - 'checking', - 'current', - 'business', - 'personal', - 'other', - 'unmapped_value', - null, - ], - example: 'checking', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - example: 'checking', - nullable: true, - }, - }, - }, - BatchResultApiModel: { - type: 'object', - properties: { - statusCode: { - type: 'number', - example: 202, - nullable: true, - }, - message: { - type: 'string', - example: 'Batch operation accepted', - nullable: true, - }, - timestamp: { - type: 'string', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - errors: { - type: 'array', - example: [['Missing field: name'], [], []], - items: { - type: 'array', - items: { - type: 'string', - }, - }, - nullable: true, - }, - }, - }, - BenefitsTypeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - description: 'The type of the benefit', - enum: [ - 'retirement_savings', - 'health_savings', - 'other', - 'health_insurance', - 'insurance', - 'unmapped_value', - null, - ], - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - ClearingCode: { - type: 'object', - properties: { - type: { - description: 'The type of clearing code', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/ClearingCodeTypeEnum', - }, - ], - }, - value: { - type: 'string', - description: 'The clearing code value', - example: '12-34-56', - nullable: true, - }, - }, - }, - ClearingCodeTypeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - description: 'The type of clearing code', - enum: [ - 'sort_code', - 'building_society_reference', - 'aba_routing', - 'chips_participant_id', - 'transit_number', - 'institution_number', - 'bsb_code', - 'ifsc_code', - 'micr_code', - 'clabe', - 'cnaps_code', - 'ch_bank_clearing_code', - 'ch_sic_code', - 'zengin_code', - 'nz_clearing_code', - 'hk_bank_code', - 'blz', - 'at_bankleitzahl', - 'nuban', - 'se_bankgiro_code', - 'unmapped_value', - null, - ], - example: 'sort_code', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - example: 'sort_code', - nullable: true, - }, - }, - }, - CompaniesPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/Company', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - Company: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - name: { - type: 'string', - description: 'The name of the company', - example: 'StackOne Technologies PLC', - nullable: true, - }, - full_name: { - type: 'string', - description: 'The full name of the company', - example: 'American Express Company', - nullable: true, - }, - display_name: { - type: 'string', - description: 'The display name of the company', - example: 'StackOne', - nullable: true, - }, - created_at: { - type: 'string', - description: 'The created_at date', - example: '2023-02-23T00:00:00.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'The updated_at date', - example: '2024-02-23T00:00:00.000Z', - format: 'date-time', - nullable: true, - }, - }, - }, - CompanyResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/Company', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - ConfidentialEnumApiModel: { - type: 'object', - properties: { - value: { - type: 'string', - description: 'Whether the file is confidential or not', - enum: ['true', 'false', 'unmapped_value', null], - example: 'true', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - example: 'public', - nullable: true, - }, - }, - }, - ConflictResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 409, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Conflict', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - Content: { - type: 'object', - properties: { - url: { - type: 'string', - description: 'URL where the file content is located', - example: 'https://example.com/file.pdf', - nullable: true, - }, - unified_url: { - type: 'string', - description: 'Unified download URL for retrieving file content.', - example: - 'https://api.stackone.com/unified/hris/employees/12345/documents/67890/download', - nullable: true, - }, - file_format: { - description: 'The file format of the file', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/FileFormatEnum', - }, - ], - }, - }, - }, - ContractTypeApiModel: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - label: { - type: 'string', - description: 'The label of the employment type', - example: 'Full-Time', - nullable: true, - }, - contract_type: { - description: 'The employment work schedule type (e.g., full-time, part-time)', - example: 'full_time', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/ContractTypeEnum', - }, - ], - }, - }, - }, - ContractTypeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: ['full_time', 'shifts', 'part_time', 'unmapped_value', null], - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - CostCenters: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - example: 'R&D', - nullable: true, - }, - distribution_percentage: { - type: 'number', - example: 100, - nullable: true, - }, - }, - }, - CountryCodeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'AF', - 'AL', - 'DZ', - 'AS', - 'AD', - 'AO', - 'AI', - 'AQ', - 'AG', - 'AR', - 'AM', - 'AW', - 'AU', - 'AT', - 'AZ', - 'BS', - 'BH', - 'BD', - 'BB', - 'BY', - 'BE', - 'BZ', - 'BJ', - 'BM', - 'BT', - 'BO', - 'BQ', - 'BA', - 'BW', - 'BV', - 'BR', - 'IO', - 'BN', - 'BG', - 'BF', - 'BI', - 'KH', - 'CM', - 'CA', - 'CV', - 'KY', - 'CF', - 'TD', - 'CL', - 'CN', - 'CX', - 'CC', - 'CO', - 'KM', - 'CG', - 'CD', - 'CK', - 'CR', - 'HR', - 'CU', - 'CW', - 'CY', - 'CZ', - 'CI', - 'DK', - 'DJ', - 'DM', - 'DO', - 'EC', - 'EG', - 'SV', - 'GQ', - 'ER', - 'EE', - 'ET', - 'FK', - 'FO', - 'FJ', - 'FI', - 'FR', - 'GF', - 'PF', - 'TF', - 'GA', - 'GM', - 'GE', - 'DE', - 'GH', - 'GI', - 'GR', - 'GL', - 'GD', - 'GP', - 'GU', - 'GT', - 'GG', - 'GN', - 'GW', - 'GY', - 'HT', - 'HM', - 'VA', - 'HN', - 'HK', - 'HU', - 'IS', - 'IN', - 'ID', - 'IR', - 'IQ', - 'IE', - 'IM', - 'IL', - 'IT', - 'JM', - 'JP', - 'JE', - 'JO', - 'KZ', - 'KE', - 'KI', - 'KP', - 'KR', - 'KW', - 'KG', - 'LA', - 'LV', - 'LB', - 'LS', - 'LR', - 'LY', - 'LI', - 'LT', - 'LU', - 'MO', - 'MK', - 'MG', - 'MW', - 'MY', - 'MV', - 'ML', - 'MT', - 'MH', - 'MQ', - 'MR', - 'MU', - 'YT', - 'MX', - 'FM', - 'MD', - 'MC', - 'MN', - 'ME', - 'MS', - 'MA', - 'MZ', - 'MM', - 'NA', - 'NR', - 'NP', - 'NL', - 'NC', - 'NZ', - 'NI', - 'NE', - 'NG', - 'NU', - 'NF', - 'MP', - 'NO', - 'OM', - 'PK', - 'PW', - 'PS', - 'PA', - 'PG', - 'PY', - 'PE', - 'PH', - 'PN', - 'PL', - 'PT', - 'PR', - 'QA', - 'RO', - 'RU', - 'RW', - 'RE', - 'BL', - 'SH', - 'KN', - 'LC', - 'MF', - 'PM', - 'VC', - 'WS', - 'SM', - 'ST', - 'SA', - 'SN', - 'RS', - 'SC', - 'SL', - 'SG', - 'SX', - 'SK', - 'SI', - 'SB', - 'SO', - 'ZA', - 'GS', - 'SS', - 'ES', - 'LK', - 'SD', - 'SR', - 'SJ', - 'SZ', - 'SE', - 'CH', - 'SY', - 'TW', - 'TJ', - 'TZ', - 'TH', - 'TL', - 'TG', - 'TK', - 'TO', - 'TT', - 'TN', - 'TR', - 'TM', - 'TC', - 'TV', - 'UG', - 'UA', - 'AE', - 'GB', - 'US', - 'UM', - 'UY', - 'UZ', - 'VU', - 'VE', - 'VN', - 'VG', - 'VI', - 'WF', - 'EH', - 'YE', - 'ZM', - 'ZW', - 'unmapped_value', - null, - ], - description: 'The ISO3166-1 Alpha2 Code of the Country', - example: 'US', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - CreateCostCenterApiModel: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - example: 'R&D', - nullable: true, - }, - distribution_percentage: { - type: 'number', - example: 100, - nullable: true, - }, - }, - }, - CreateEmployeeEmploymentApiModel: { - type: 'object', - properties: { - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - job_title: { - type: 'string', - description: 'The job title of the employee', - example: 'Software Engineer', - nullable: true, - }, - pay_rate: { - type: 'string', - description: 'The amount of compensation for the employee', - example: '40.00', - nullable: true, - }, - pay_period: { - description: 'The time period over which the pay rate is calculated', - example: 'monthly', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/PayPeriodEnum', - }, - ], - }, - pay_frequency: { - description: 'How often the employee is paid', - example: 'hourly', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/PayFrequencyEnum', - }, - ], - }, - pay_currency: { - type: 'string', - description: 'The currency used for pay', - example: 'USD', - nullable: true, - }, - end_date: { - type: 'string', - description: 'The end date of employment', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - grade: { - description: 'Represents the employee’s position within the organizational hierarchy.', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/EmploymentGradeApiModel', - }, - ], - }, - employment_type: { - description: 'The type of employment (e.g., contractor, permanent)', - example: 'permanent', - deprecated: true, - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/EmploymentTypeEnum', - }, - ], - }, - employment_contract_type: { - description: 'The employment work schedule type (e.g., full-time, part-time)', - example: 'full_time', - deprecated: true, - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/EmploymentScheduleTypeEnum', - }, - ], - }, - type: { - description: 'The type of employment', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/TypeApiModel', - }, - ], - }, - contract_type: { - description: 'The employment work schedule type', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/ContractTypeApiModel', - }, - ], - }, - work_time: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/WorkTimeApiModel', - }, - ], - }, - payroll_code: { - type: 'string', - description: 'The payroll code of the employee', - example: 'PC1', - nullable: true, - }, - passthrough: { - type: 'object', - description: 'Value to pass through to the provider', - example: { - other_known_names: 'John Doe', - }, - additionalProperties: true, - nullable: true, - }, - effective_date: { - type: 'string', - description: 'The employee effective date', - example: '2021-01-01T00:00:00.000Z', - format: 'date-time', - deprecated: true, - nullable: true, - }, - }, - }, - CreateEmployeeLocationApiModel: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - description: 'The name of the location', - example: 'Woolsthorpe Manor', - nullable: true, - }, - phone_number: { - type: 'string', - description: 'The phone number of the location', - example: '+44 1476 860 364', - nullable: true, - }, - street_1: { - type: 'string', - description: 'The first line of the address', - example: 'Water Lane', - nullable: true, - }, - street_2: { - type: 'string', - description: 'The second line of the address', - example: 'Woolsthorpe by Colsterworth', - nullable: true, - }, - city: { - type: 'string', - description: 'The city where the location is situated', - example: 'Grantham', - nullable: true, - }, - zip_code: { - type: 'string', - description: 'The ZIP code/Postal code of the location', - example: 'NG33 5NR', - nullable: true, - }, - country: { - description: 'The country code', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/CountryCodeEnum', - }, - ], - }, - passthrough: { - type: 'object', - description: 'Value to pass through to the provider', - example: { - other_known_names: 'John Doe', - }, - additionalProperties: true, - nullable: true, - }, - state: { - description: 'The ISO3166-2 sub division where the location is situated', - example: 'GB-LIN', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/ISO3166_2SubDivisionEnum', - }, - ], - }, - }, - }, - CreateEmploymentApiModel: { - type: 'object', - properties: { - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - job_title: { - type: 'string', - description: 'The job title of the employee', - example: 'Software Engineer', - nullable: true, - }, - pay_rate: { - type: 'string', - description: 'The amount of compensation for the employee', - example: '40.00', - nullable: true, - }, - pay_period: { - description: 'The time period over which the pay rate is calculated', - example: 'monthly', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/PayPeriodEnum', - }, - ], - }, - pay_frequency: { - description: 'How often the employee is paid', - example: 'hourly', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/PayFrequencyEnum', - }, - ], - }, - pay_currency: { - type: 'string', - description: 'The currency used for pay', - example: 'USD', - nullable: true, - }, - effective_date: { - type: 'string', - description: 'The effective date of the employment contract', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - end_date: { - type: 'string', - description: 'The end date of employment', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - grade: { - description: 'Represents the employee’s position within the organizational hierarchy.', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/EmploymentGradeApiModel', - }, - ], - }, - employment_type: { - description: 'The type of employment (e.g., contractor, permanent)', - example: 'permanent', - deprecated: true, - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/EmploymentTypeEnum', - }, - ], - }, - employment_contract_type: { - description: 'The employment work schedule type (e.g., full-time, part-time)', - example: 'full_time', - deprecated: true, - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/EmploymentScheduleTypeEnum', - }, - ], - }, - type: { - description: 'The type of employment', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/TypeApiModel', - }, - ], - }, - contract_type: { - description: 'The employment work schedule type', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/ContractTypeApiModel', - }, - ], - }, - work_time: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/WorkTimeApiModel', - }, - ], - }, - payroll_code: { - type: 'string', - description: 'The payroll code of the employee', - example: 'PC1', - nullable: true, - }, - job_id: { - type: 'string', - description: 'The employee job id', - example: '5290', - nullable: true, - }, - }, - }, - CreateHRISBenefit: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - description: 'The name of the benefit', - example: 'Health Insurance', - nullable: true, - }, - benefit_type: { - description: 'The type of the benefit', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/BenefitsTypeEnum', - }, - ], - }, - provider: { - type: 'string', - description: 'The provider of the benefit', - example: 'Aetna', - nullable: true, - }, - description: { - type: 'string', - description: 'The description of the benefit', - example: 'Health insurance for employees', - nullable: true, - }, - created_at: { - type: 'string', - description: 'The date and time the benefit was created', - example: '2021-01-01T00:00:00Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'The date and time the benefit was last updated', - example: '2021-01-01T00:00:00Z', - format: 'date-time', - nullable: true, - }, - }, - }, - CreateResult: { - type: 'object', - properties: { - statusCode: { - type: 'number', - example: 201, - }, - message: { - type: 'string', - example: 'Record created successfully.', - }, - timestamp: { - type: 'string', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - }, - data: { - $ref: '#/components/schemas/CreateResultDataApiModel', - }, - }, - required: ['statusCode', 'message', 'timestamp', 'data'], - }, - CreateResultDataApiModel: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - }, - }, - CurrencyCodeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'AED', - 'AFN', - 'ALL', - 'AMD', - 'ANG', - 'AOA', - 'ARS', - 'AUD', - 'AWG', - 'AZN', - 'BAM', - 'BBD', - 'BDT', - 'BGN', - 'BHD', - 'BIF', - 'BMD', - 'BND', - 'BOB', - 'BRL', - 'BSD', - 'BTN', - 'BWP', - 'BYN', - 'BZD', - 'CAD', - 'CDF', - 'CHF', - 'CLP', - 'CNY', - 'COP', - 'CRC', - 'CUC', - 'CUP', - 'CVE', - 'CZK', - 'DJF', - 'DKK', - 'DOP', - 'DZD', - 'EGP', - 'ERN', - 'ETB', - 'EUR', - 'FJD', - 'FKP', - 'GBP', - 'GEL', - 'GHS', - 'GIP', - 'GMD', - 'GNF', - 'GTQ', - 'GYD', - 'HKD', - 'HNL', - 'HRK', - 'HTG', - 'HUF', - 'IDR', - 'ILS', - 'INR', - 'IQD', - 'IRR', - 'ISK', - 'JMD', - 'JOD', - 'JPY', - 'KES', - 'KGS', - 'KHR', - 'KMF', - 'KPW', - 'KRW', - 'KWD', - 'KYD', - 'KZT', - 'LAK', - 'LBP', - 'LKR', - 'LRD', - 'LSL', - 'LYD', - 'MAD', - 'MDL', - 'MGA', - 'MKD', - 'MMK', - 'MNT', - 'MOP', - 'MRU', - 'MUR', - 'MVR', - 'MWK', - 'MXN', - 'MYR', - 'MZN', - 'NAD', - 'NGN', - 'NIO', - 'NOK', - 'NPR', - 'NZD', - 'OMR', - 'PAB', - 'PEN', - 'PGK', - 'PHP', - 'PKR', - 'PLN', - 'PYG', - 'QAR', - 'RON', - 'RSD', - 'RUB', - 'RWF', - 'SAR', - 'SBD', - 'SCR', - 'SDG', - 'SEK', - 'SGD', - 'SHP', - 'SLL', - 'SOS', - 'SRD', - 'SSP', - 'STN', - 'SYP', - 'SZL', - 'THB', - 'TJS', - 'TMT', - 'TND', - 'TOP', - 'TRY', - 'TTD', - 'TWD', - 'TZS', - 'UAH', - 'UGX', - 'USD', - 'UYU', - 'UZS', - 'VES', - 'VND', - 'VUV', - 'WST', - 'XAF', - 'XCD', - 'XDR', - 'XOF', - 'XPF', - 'YER', - 'ZAR', - 'ZMW', - 'ZWL', - 'unmapped_value', - null, - ], - description: 'ISO 4217 currency code', - example: 'USD', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - example: 'USD', - nullable: true, - }, - }, - }, - CustomFieldDefinition: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - nullable: true, - }, - description: { - type: 'string', - nullable: true, - }, - type: { - description: 'The type of the custom field.', - example: 'Dropdown', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/CustomFieldTypeEnum', - }, - ], - }, - options: { - description: 'An array of possible options for the custom field.', - example: [ - { - id: 'option_1', - value: 'Not Started', - }, - { - id: 'option_2', - value: 'In Progress', - }, - { - id: 'option_3', - value: 'Completed', - }, - ], - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/CustomFieldOption', - }, - }, - }, - }, - CustomFieldDefinitionResultApiModel: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/CustomFieldDefinition', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - CustomFieldDefinitionsPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/CustomFieldDefinition', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - CustomFieldOption: { - type: 'object', - properties: { - id: { - type: 'string', - description: - 'The unique identifier for the option to be used when updating the custom field', - example: 'option_123', - }, - value: { - description: 'The human readable value of the option', - example: 'Not Started', - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - }, - }, - required: ['id', 'value'], - }, - CustomFields: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - description: 'The name of the custom field.', - example: 'Training Completion Status', - nullable: true, - }, - value: { - description: 'The value associated with the custom field.', - example: 'Completed', - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - { - type: 'string', - format: 'date-time', - }, - ], - nullable: true, - }, - value_id: { - type: 'string', - description: 'The unique identifier for the value of the custom field.', - example: 'value_456', - nullable: true, - }, - remote_value_id: { - type: 'string', - description: "Provider's unique identifier for the value of the custom field.", - example: 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - nullable: true, - }, - }, - }, - CustomFieldTypeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'date', - 'float', - 'integer', - 'list', - 'checkbox', - 'text', - 'boolean', - 'single_select', - 'multi_select', - 'url', - 'other', - 'unmapped_value', - null, - ], - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - DeleteResult: { - type: 'object', - properties: { - statusCode: { - type: 'number', - example: 204, - }, - message: { - type: 'string', - example: 'Record deleted successfully.', - }, - timestamp: { - type: 'string', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - DepartmentTypeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'department', - 'company', - 'division', - 'group', - 'project', - 'team', - 'unmapped_value', - null, - ], - example: 'department', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - DivisionTypeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'department', - 'company', - 'division', - 'group', - 'project', - 'cost_center', - 'team', - 'unmapped_value', - null, - ], - example: 'division', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - DownloadApiModel: { - type: 'object', - properties: { - headers: { - description: 'Headers related to the download', - allOf: [ - { - $ref: '#/components/schemas/DownloadHeadersApiModel', - }, - ], - }, - data: { - type: 'string', - description: 'The file data in binary format', - format: 'binary', - }, - }, - required: ['headers', 'data'], - }, - DownloadHeadersApiModel: { - type: 'object', - properties: { - 'content-disposition': { - type: 'string', - description: 'Value of the Content-Disposition header', - example: 'attachment; filename="example.pdf"', - nullable: true, - }, - 'content-type': { - type: 'string', - description: 'MIME type of the file', - example: 'application/pdf', - nullable: true, - }, - 'content-length': { - type: 'number', - description: 'Size of the content in bytes', - example: 1024, - nullable: true, - }, - 'content-range': { - type: 'string', - description: 'Range of the content being sent', - example: 'bytes 0-1023/2048', - nullable: true, - }, - 'content-encoding': { - type: 'string', - description: 'Encoding of the content', - example: 'gzip', - nullable: true, - }, - 'transfer-encoding': { - type: 'string', - description: 'Transfer encoding type', - example: 'chunked', - nullable: true, - }, - }, - }, - Employee: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - title: { - type: 'string', - description: "The prefix of the employee's name (e.g., Mr, Ms, Dr)", - example: 'Mr', - nullable: true, - }, - first_name: { - type: 'string', - description: 'The employee first name', - example: 'Isaac', - nullable: true, - }, - last_name: { - type: 'string', - description: 'The employee last name', - example: 'Newton', - nullable: true, - }, - name: { - type: 'string', - description: 'The employee name', - example: 'Isaac Newton', - nullable: true, - }, - display_name: { - type: 'string', - description: 'The employee display name', - example: 'Sir Isaac Newton', - nullable: true, - }, - avatar_url: { - type: 'string', - description: 'The employee avatar Url', - example: 'https://example.com/avatar.png', - nullable: true, - }, - personal_email: { - type: 'string', - description: 'The employee personal email', - example: 'isaac.newton@example.com', - nullable: true, - }, - personal_phone_number: { - type: 'string', - description: 'The employee personal phone number', - example: '+1234567890', - nullable: true, - }, - work_email: { - type: 'string', - description: 'The employee work email', - example: 'newton@example.com', - nullable: true, - }, - work_phone_number: { - type: 'string', - description: 'The employee work phone number', - example: '+1234567890', - nullable: true, - }, - job_id: { - type: 'string', - description: 'The employee job id', - example: '5290', - deprecated: true, - nullable: true, - }, - job_title: { - type: 'string', - description: 'The employee job title', - example: 'Physicist', - nullable: true, - }, - job_description: { - description: 'The employee job description', - example: 'Testing the laws of motion', - deprecated: true, - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/JobDescriptionApiModel', - }, - ], - }, - department_id: { - type: 'string', - description: 'The employee department id', - example: '3093', - deprecated: true, - nullable: true, - }, - department: { - type: 'string', - description: 'The employee department', - example: 'Physics', - deprecated: true, - nullable: true, - }, - groups: { - description: 'The employee groups', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/HRISGroup', - }, - }, - cost_centers: { - description: 'The employee cost centers', - deprecated: true, - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/CostCenters', - }, - }, - manager_id: { - type: 'string', - description: 'The employee manager ID', - example: '67890', - deprecated: true, - nullable: true, - }, - remote_manager_id: { - type: 'string', - description: "Provider's unique identifier of the manager", - example: 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - deprecated: true, - nullable: true, - }, - gender: { - description: 'The employee gender', - example: 'male', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/GenderEnum', - }, - ], - }, - preferred_language: { - description: 'The employee preferred language', - example: 'en_US', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/PreferredLanguageEnum', - }, - ], - }, - ethnicity: { - description: 'The employee ethnicity', - example: 'white', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/EthnicityEnum', - }, - ], - }, - date_of_birth: { - type: 'string', - description: 'The date when the employee was born', - example: '1990-01-01T00:00:00.000Z', - format: 'date-time', - nullable: true, - }, - birthday: { - type: 'string', - description: 'The next birthday of the employee (upcoming birthday)', - example: '2021-01-01T00:00:00Z', - format: 'date-time', - nullable: true, - }, - marital_status: { - description: 'The employee marital status', - example: 'single', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/MaritalStatusEnum', - }, - ], - }, - avatar: { - description: 'The employee avatar', - example: 'https://example.com/avatar.png', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/Image', - }, - ], - }, - hire_date: { - type: 'string', - description: 'The employee hire date', - example: '2021-01-01T00:00:00.000Z', - format: 'date-time', - nullable: true, - }, - start_date: { - type: 'string', - description: 'The employee start date', - example: '2021-01-01T00:00:00.000Z', - format: 'date-time', - nullable: true, - }, - tenure: { - type: 'number', - description: 'The employee tenure', - example: 2, - nullable: true, - }, - work_anniversary: { - type: 'string', - description: 'The employee work anniversary', - example: '2021-01-01T00:00:00Z', - format: 'date-time', - nullable: true, - }, - employment_type: { - description: 'The employee employment type', - example: 'full_time', - deprecated: true, - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/EmploymentTypeEnum', - }, - ], - }, - employment_contract_type: { - description: 'The employment work schedule type (e.g., full-time, part-time)', - example: 'full_time', - deprecated: true, - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/EmploymentScheduleTypeEnum', - }, - ], - }, - employment_status: { - description: 'The employee employment status', - example: 'active', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/EmploymentStatusEnum', - }, - ], - }, - termination_date: { - type: 'string', - description: 'The employee termination date', - example: '2021-01-01T00:00:00Z', - format: 'date-time', - nullable: true, - }, - company_name: { - type: 'string', - description: 'The employee company name', - example: 'Example Corp', - deprecated: true, - nullable: true, - }, - company_id: { - type: 'string', - description: 'The employee company id', - example: '1234567890', - nullable: true, - }, - citizenships: { - description: 'The citizenships of the Employee', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/CountryCodeEnum', - }, - }, - home_location: { - description: 'The employee home location', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/HRISLocation', - }, - ], - }, - work_location: { - description: 'The employee work location', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/HRISLocation', - }, - ], - }, - company: { - description: 'The employee company', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/Company', - }, - ], - }, - employments: { - description: 'The employee employments', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/Employment', - }, - }, - custom_fields: { - description: 'The employee custom fields', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/CustomFields', - }, - }, - benefits: { - description: 'Current benefits of the employee', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/HRISBenefit', - }, - }, - employee_number: { - type: 'string', - description: 'The assigned employee number', - example: '125', - nullable: true, - }, - bank_details: { - description: 'Bank account details for the employee', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/HRISBankDetails', - }, - }, - national_identity_number: { - description: 'The national identity number', - deprecated: true, - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/NationalIdentityNumberApiModel', - }, - ], - }, - national_identity_numbers: { - description: 'The national identity numbers', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/NationalIdentityNumberApiModel', - }, - }, - skills: { - description: 'The employee skills', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/EntitySkills', - }, - }, - created_at: { - type: 'string', - description: 'The created_at date', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'The updated_at date', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - }, - }, - EmployeeResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/Employee', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - EmployeesPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/Employee', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - Employment: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - job_title: { - type: 'string', - description: 'The job title of the employee', - example: 'Software Engineer', - nullable: true, - }, - pay_rate: { - type: 'string', - description: 'The amount of compensation for the employee', - example: '40.00', - nullable: true, - }, - pay_period: { - description: 'The time period over which the pay rate is calculated', - example: 'monthly', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/PayPeriodEnum', - }, - ], - }, - pay_frequency: { - description: 'How often the employee is paid', - example: 'hourly', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/PayFrequencyEnum', - }, - ], - }, - pay_currency: { - type: 'string', - description: 'The currency used for pay', - example: 'USD', - nullable: true, - }, - effective_date: { - type: 'string', - description: 'The effective date of the employment contract', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - end_date: { - type: 'string', - description: 'The end date of employment', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - grade: { - description: 'Represents the employee’s position within the organizational hierarchy.', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/EmploymentGradeApiModel', - }, - ], - }, - employment_type: { - description: 'The type of employment (e.g., contractor, permanent)', - example: 'permanent', - deprecated: true, - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/EmploymentTypeEnum', - }, - ], - }, - employment_contract_type: { - description: 'The employment work schedule type (e.g., full-time, part-time)', - example: 'full_time', - deprecated: true, - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/EmploymentScheduleTypeEnum', - }, - ], - }, - type: { - description: 'The type of employment', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/TypeApiModel', - }, - ], - }, - contract_type: { - description: 'The employment work schedule type', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/ContractTypeApiModel', - }, - ], - }, - work_time: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/WorkTimeApiModel', - }, - ], - }, - payroll_code: { - type: 'string', - description: 'The payroll code of the employee', - example: 'PC1', - nullable: true, - }, - employee_id: { - type: 'string', - description: 'The employee ID associated with this employment', - example: '1687-3', - nullable: true, - }, - remote_employee_id: { - type: 'string', - description: - "Provider's unique identifier of the employee associated with this employment", - example: 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - nullable: true, - }, - fte: { - type: 'number', - description: "the employee's working percentage relative to a full-time employee", - example: '1', - nullable: true, - }, - created_at: { - type: 'string', - description: 'The created_at date', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'The updated_at date', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - start_date: { - type: 'string', - description: 'The start_date of employment', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - deprecated: true, - nullable: true, - }, - active: { - description: 'The employment active status', - example: true, - oneOf: [ - { - type: 'boolean', - }, - { - type: 'string', - enum: ['true', 'false'], - }, - ], - nullable: true, - }, - department: { - description: 'The employee department', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/HRISGroup', - }, - ], - }, - cost_center: { - description: 'The employee cost_center', - deprecated: true, - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/HRISGroup', - }, - ], - }, - cost_centers: { - description: 'The employee cost_centers', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/HRISCostCenter', - }, - }, - division: { - description: 'The employee division', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/HRISGroup', - }, - ], - }, - job: { - description: 'The job of employee', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/EmploymentJobApiModel', - }, - ], - }, - manager: { - description: 'The employee manager', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/EmploymentManagerApiModel', - }, - }, - }, - }, - EmploymentGradeApiModel: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'The reference id', - example: '1687-3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - description: 'The reference name', - example: '1687-4', - nullable: true, - }, - description: { - type: 'string', - description: 'description of the grade', - example: 'Mid-level employee demonstrating proficiency and autonomy.', - nullable: true, - }, - }, - }, - EmploymentJobApiModel: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - title: { - type: 'string', - description: 'Title of the job', - example: 'Software Engineer', - nullable: true, - }, - description: { - description: 'The employee job description', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/JobDescriptionApiModel', - }, - ], - }, - owner_id: { - type: 'string', - description: 'The owner_id of the job', - example: '5356', - nullable: true, - }, - parent_id: { - type: 'string', - description: 'The parent_id of the job', - example: '7577', - nullable: true, - }, - }, - }, - EmploymentManagerApiModel: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - description: 'The manager name', - example: 'John Doe', - nullable: true, - }, - email: { - type: 'string', - description: 'The manager email', - example: 'john.doe@example.com', - nullable: true, - }, - role: { - description: 'The role of manager', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/ManagerRoleApiModel', - }, - ], - }, - }, - }, - EmploymentResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/Employment', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - EmploymentScheduleTypeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: ['full_time', 'shifts', 'part_time', 'unmapped_value', null], - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - EmploymentsPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/Employment', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - EmploymentStatusEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'active', - 'pending', - 'terminated', - 'leave', - 'inactive', - 'unknown', - 'unmapped_value', - null, - ], - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - EmploymentTypeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'contractor', - 'intern', - 'permanent', - 'apprentice', - 'freelance', - 'terminated', - 'temporary', - 'seasonal', - 'volunteer', - 'probation', - 'internal', - 'external', - 'expatriate', - 'employer_of_record', - 'casual', - 'Programme', - 'unmapped_value', - null, - ], - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - EntitySkillResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/EntitySkills', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - EntitySkills: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'The ID associated with this skill', - example: '16873-IT345', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - description: 'The name associated with this skill', - example: 'Information-Technology', - nullable: true, - }, - active: { - description: 'Whether the skill is active and therefore available for use', - example: true, - oneOf: [ - { - type: 'boolean', - }, - { - type: 'string', - enum: ['true', 'false'], - }, - ], - nullable: true, - }, - language: { - description: 'The language associated with this skill', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/LanguageEnum', - }, - ], - }, - maximum_proficiency: { - description: 'The proficiency level of the skill', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/Proficiency', - }, - ], - }, - minimum_proficiency: { - description: 'The proficiency level of the skill', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/Proficiency', - }, - ], - }, - }, - }, - EntitySkillsCreateRequestDto: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'The ID associated with this skill', - example: '16873-IT345', - nullable: true, - }, - name: { - type: 'string', - description: 'The name associated with this skill', - example: 'Information-Technology', - nullable: true, - }, - maximum_proficiency: { - description: 'The proficiency level of the skill', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/Proficiency', - }, - ], - }, - minimum_proficiency: { - description: 'The proficiency level of the skill', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/Proficiency', - }, - ], - }, - }, - }, - EntitySkillsPaginated: { - type: 'object', - properties: { - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/EntitySkills', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - EthnicityEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'white', - 'black_or_african_american', - 'asian', - 'hispanic_or_latino', - 'american_indian_or_alaska_native', - 'native_hawaiian_or_pacific_islander', - 'two_or_more_races', - 'not_disclosed', - 'other', - 'unmapped_value', - null, - ], - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - File: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - description: 'The name of the file', - example: 'My Document', - nullable: true, - }, - category: { - description: 'The category of the file', - example: 'templates, forms, backups, etc.', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/FileCategoryEnumApiModel', - }, - ], - }, - contents: { - description: - 'The content of the file. Deprecated, use `url` and `file_format` one level up instead', - deprecated: true, - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/Content', - }, - }, - category_id: { - type: 'string', - description: 'The categoryId of the documents', - example: '6530', - nullable: true, - }, - created_at: { - type: 'string', - description: 'The creation date of the file', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'The update date of the file', - example: '2021-01-02T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - remote_url: { - type: 'string', - description: 'URL where the file content is located', - example: 'https://example.com/file.pdf', - nullable: true, - }, - file_format: { - description: 'The file format of the file', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/FileFormatEnum', - }, - ], - }, - }, - }, - FileCategoryEnumApiModel: { - type: 'object', - properties: { - value: { - type: 'string', - description: 'The category of the file', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - FileFormatEnum: { - type: 'object', - properties: { - value: { - type: 'string', - description: 'The file format of the file, expressed as a file extension', - enum: [ - 'unmapped_value', - 'ez', - 'aw', - 'atom', - 'atomcat', - 'atomdeleted', - 'atomsvc', - 'dwd', - 'held', - 'rsat', - 'bdoc', - 'xcs', - 'ccxml', - 'cdfx', - 'cdmia', - 'cdmic', - 'cdmid', - 'cdmio', - 'cdmiq', - 'cu', - 'mpd', - 'davmount', - 'dbk', - 'dssc', - 'xdssc', - 'es', - 'ecma', - 'emma', - 'emotionml', - 'epub', - 'exi', - 'exp', - 'fdt', - 'pfr', - 'geojson', - 'gml', - 'gpx', - 'gxf', - 'gz', - 'hjson', - 'stk', - 'ink', - 'inkml', - 'ipfix', - 'its', - 'jar', - 'war', - 'ear', - 'ser', - 'class', - 'js', - 'mjs', - 'json', - 'map', - 'json5', - 'jsonml', - 'jsonld', - 'lgr', - 'lostxml', - 'hqx', - 'cpt', - 'mads', - 'webmanifest', - 'mrc', - 'mrcx', - 'ma', - 'nb', - 'mb', - 'mathml', - 'mbox', - 'mscml', - 'metalink', - 'meta4', - 'mets', - 'maei', - 'musd', - 'mods', - 'm21', - 'mp21', - 'mp4s', - 'm4p', - 'doc', - 'dot', - 'mxf', - 'nq', - 'nt', - 'cjs', - 'bin', - 'dms', - 'lrf', - 'mar', - 'so', - 'dist', - 'distz', - 'pkg', - 'bpk', - 'dump', - 'elc', - 'deploy', - 'exe', - 'dll', - 'deb', - 'dmg', - 'iso', - 'img', - 'msi', - 'msp', - 'msm', - 'buffer', - 'oda', - 'opf', - 'ogx', - 'omdoc', - 'onetoc', - 'onetoc2', - 'onetmp', - 'onepkg', - 'oxps', - 'relo', - 'xer', - 'pdf', - 'pgp', - 'asc', - 'sig', - 'prf', - 'p10', - 'p7m', - 'p7c', - 'p7s', - 'p8', - 'ac', - 'cer', - 'crl', - 'pkipath', - 'pki', - 'pls', - 'ai', - 'eps', - 'ps', - 'provx', - 'pskcxml', - 'raml', - 'rdf', - 'owl', - 'rif', - 'rnc', - 'rl', - 'rld', - 'rs', - 'rapd', - 'sls', - 'rusd', - 'gbr', - 'mft', - 'roa', - 'rsd', - 'rss', - 'rtf', - 'sbml', - 'scq', - 'scs', - 'spq', - 'spp', - 'sdp', - 'senmlx', - 'sensmlx', - 'setpay', - 'setreg', - 'shf', - 'siv', - 'sieve', - 'smi', - 'smil', - 'rq', - 'srx', - 'gram', - 'grxml', - 'sru', - 'ssdl', - 'ssml', - 'swidtag', - 'tei', - 'teicorpus', - 'tfi', - 'tsd', - 'toml', - 'trig', - 'ttml', - 'ubj', - 'rsheet', - 'td', - 'vxml', - 'wasm', - 'wgt', - 'hlp', - 'wsdl', - 'wspolicy', - 'xaml', - 'xav', - 'xca', - 'xdf', - 'xel', - 'xns', - 'xenc', - 'xhtml', - 'xht', - 'xlf', - 'xml', - 'xsl', - 'xsd', - 'rng', - 'dtd', - 'xop', - 'xpl', - '*xsl', - 'xslt', - 'xspf', - 'mxml', - 'xhvml', - 'xvml', - 'xvm', - 'yang', - 'yin', - 'zip', - '*3gpp', - 'adp', - 'amr', - 'au', - 'snd', - 'mid', - 'midi', - 'kar', - 'rmi', - 'mxmf', - '*mp3', - 'm4a', - 'mp4a', - 'mpga', - 'mp2', - 'mp2a', - 'mp3', - 'm2a', - 'm3a', - 'oga', - 'ogg', - 'spx', - 'opus', - 's3m', - 'sil', - 'wav', - '*wav', - 'weba', - 'xm', - 'ttc', - 'otf', - 'ttf', - 'woff', - 'woff2', - 'exr', - 'apng', - 'avif', - 'bmp', - 'cgm', - 'drle', - 'emf', - 'fits', - 'g3', - 'gif', - 'heic', - 'heics', - 'heif', - 'heifs', - 'hej2', - 'hsj2', - 'ief', - 'jls', - 'jp2', - 'jpg2', - 'jpeg', - 'jpg', - 'jpe', - 'jph', - 'jhc', - 'jpm', - 'jpx', - 'jpf', - 'jxr', - 'jxra', - 'jxrs', - 'jxs', - 'jxsc', - 'jxsi', - 'jxss', - 'ktx', - 'ktx2', - 'png', - 'sgi', - 'svg', - 'svgz', - 't38', - 'tif', - 'tiff', - 'tfx', - 'webp', - 'wmf', - 'disposition-notification', - 'u8msg', - 'u8dsn', - 'u8mdn', - 'u8hdr', - 'eml', - 'mime', - '3mf', - 'gltf', - 'glb', - 'igs', - 'iges', - 'msh', - 'mesh', - 'silo', - 'mtl', - 'obj', - 'stpx', - 'stpz', - 'stpxz', - 'stl', - 'wrl', - 'vrml', - '*x3db', - 'x3dbz', - 'x3db', - '*x3dv', - 'x3dvz', - 'x3d', - 'x3dz', - 'x3dv', - 'appcache', - 'manifest', - 'ics', - 'ifb', - 'coffee', - 'litcoffee', - 'css', - 'csv', - 'html', - 'htm', - 'shtml', - 'jade', - 'jsx', - 'less', - 'markdown', - 'md', - 'mml', - 'mdx', - 'n3', - 'txt', - 'text', - 'conf', - 'def', - 'list', - 'log', - 'in', - 'ini', - 'rtx', - '*rtf', - 'sgml', - 'sgm', - 'shex', - 'slim', - 'slm', - 'spdx', - 'stylus', - 'styl', - 'tsv', - 't', - 'tr', - 'roff', - 'man', - 'me', - 'ms', - 'ttl', - 'uri', - 'uris', - 'urls', - 'vcard', - 'vtt', - '*xml', - 'yaml', - 'yml', - '3gp', - '3gpp', - '3g2', - 'h261', - 'h263', - 'h264', - 'm4s', - 'jpgv', - '*jpm', - 'jpgm', - 'mj2', - 'mjp2', - 'ts', - 'mp4', - 'mp4v', - 'mpg4', - 'mpeg', - 'mpg', - 'mpe', - 'm1v', - 'm2v', - 'ogv', - 'qt', - 'mov', - 'webm', - 'cww', - '1km', - 'plb', - 'psb', - 'pvb', - 'tcap', - 'pwn', - 'aso', - 'imp', - 'acu', - 'atc', - 'acutc', - 'air', - 'fcdt', - 'fxp', - 'fxpl', - 'xdp', - 'xfdf', - 'ahead', - 'azf', - 'azs', - 'azw', - 'acc', - 'ami', - 'apk', - 'cii', - 'fti', - 'atx', - 'mpkg', - 'key', - 'm3u8', - 'numbers', - 'pages', - 'pkpass', - 'swi', - 'iota', - 'aep', - 'bmml', - 'mpm', - 'bmi', - 'rep', - 'cdxml', - 'mmd', - 'cdy', - 'csl', - 'cla', - 'rp9', - 'c4g', - 'c4d', - 'c4f', - 'c4p', - 'c4u', - 'c11amc', - 'c11amz', - 'csp', - 'cdbcmsg', - 'cmc', - 'clkx', - 'clkk', - 'clkp', - 'clkt', - 'clkw', - 'wbs', - 'pml', - 'ppd', - 'car', - 'pcurl', - 'dart', - 'rdz', - 'dbf', - 'uvf', - 'uvvf', - 'uvd', - 'uvvd', - 'uvt', - 'uvvt', - 'uvx', - 'uvvx', - 'uvz', - 'uvvz', - 'fe_launch', - 'dna', - 'mlp', - 'mle', - 'dpg', - 'dfac', - 'kpxx', - 'ait', - 'svc', - 'geo', - 'mag', - 'nml', - 'esf', - 'msf', - 'qam', - 'slt', - 'ssf', - 'es3', - 'et3', - 'ez2', - 'ez3', - 'fdf', - 'mseed', - 'seed', - 'dataless', - 'gph', - 'ftc', - 'fm', - 'frame', - 'maker', - 'book', - 'fnc', - 'ltf', - 'fsc', - 'oas', - 'oa2', - 'oa3', - 'fg5', - 'bh2', - 'ddd', - 'xdw', - 'xbd', - 'fzs', - 'txd', - 'ggb', - 'ggt', - 'gex', - 'gre', - 'gxt', - 'g2w', - 'g3w', - 'gmx', - 'gdoc', - 'gslides', - 'gsheet', - 'kml', - 'kmz', - 'gqf', - 'gqs', - 'gac', - 'ghf', - 'gim', - 'grv', - 'gtm', - 'tpl', - 'vcg', - 'hal', - 'zmm', - 'hbci', - 'les', - 'hpgl', - 'hpid', - 'hps', - 'jlt', - 'pcl', - 'pclxl', - 'sfd-hdstx', - 'mpy', - 'afp', - 'listafp', - 'list3820', - 'irm', - 'sc', - 'icc', - 'icm', - 'igl', - 'ivp', - 'ivu', - 'igm', - 'xpw', - 'xpx', - 'i2g', - 'qbo', - 'qfx', - 'rcprofile', - 'irp', - 'xpr', - 'fcs', - 'jam', - 'rms', - 'jisp', - 'joda', - 'ktz', - 'ktr', - 'karbon', - 'chrt', - 'kfo', - 'flw', - 'kon', - 'kpr', - 'kpt', - 'ksp', - 'kwd', - 'kwt', - 'htke', - 'kia', - 'kne', - 'knp', - 'skp', - 'skd', - 'skt', - 'skm', - 'sse', - 'lasxml', - 'lbd', - 'lbe', - 'apr', - 'pre', - 'nsf', - 'org', - 'scm', - 'lwp', - 'portpkg', - 'mvt', - 'mcd', - 'mc1', - 'cdkey', - 'mwf', - 'mfm', - 'flo', - 'igx', - 'mif', - 'daf', - 'dis', - 'mbk', - 'mqy', - 'msl', - 'plc', - 'txf', - 'mpn', - 'mpc', - 'xul', - 'cil', - 'cab', - 'xls', - 'xlm', - 'xla', - 'xlc', - 'xlt', - 'xlw', - 'xlam', - 'xlsb', - 'xlsm', - 'xltm', - 'eot', - 'chm', - 'ims', - 'lrm', - 'thmx', - 'msg', - 'cat', - '*stl', - 'ppt', - 'pps', - 'pot', - 'ppam', - 'pptm', - 'sldm', - 'ppsm', - 'potm', - 'mpp', - 'mpt', - 'docm', - 'dotm', - 'wps', - 'wks', - 'wcm', - 'wdb', - 'wpl', - 'xps', - 'mseq', - 'mus', - 'msty', - 'taglet', - 'nlu', - 'ntf', - 'nitf', - 'nnd', - 'nns', - 'nnw', - '*ac', - 'ngdat', - 'n-gage', - 'rpst', - 'rpss', - 'edm', - 'edx', - 'ext', - 'odc', - 'otc', - 'odb', - 'odf', - 'odft', - 'odg', - 'otg', - 'odi', - 'oti', - 'odp', - 'otp', - 'ods', - 'ots', - 'odt', - 'odm', - 'ott', - 'oth', - 'xo', - 'dd2', - 'obgx', - 'oxt', - 'osm', - 'pptx', - 'sldx', - 'ppsx', - 'potx', - 'xlsx', - 'xltx', - 'docx', - 'dotx', - 'mgp', - 'dp', - 'esa', - 'pdb', - 'pqa', - 'oprc', - 'paw', - 'str', - 'ei6', - 'efif', - 'wg', - 'plf', - 'pbd', - 'box', - 'mgz', - 'qps', - 'ptid', - 'qxd', - 'qxt', - 'qwd', - 'qwt', - 'qxl', - 'qxb', - 'rar', - 'bed', - 'mxl', - 'musicxml', - 'cryptonote', - 'cod', - 'rm', - 'rmvb', - 'link66', - 'st', - 'see', - 'sema', - 'semd', - 'semf', - 'ifm', - 'itp', - 'iif', - 'ipk', - 'twd', - 'twds', - 'mmf', - 'teacher', - 'fo', - 'sdkm', - 'sdkd', - 'dxp', - 'sfs', - 'sdc', - 'sda', - 'sdd', - 'smf', - 'sdw', - 'vor', - 'sgl', - 'smzip', - 'sm', - 'wadl', - 'sxc', - 'stc', - 'sxd', - 'std', - 'sxi', - 'sti', - 'sxm', - 'sxw', - 'sxg', - 'stw', - 'sus', - 'susp', - 'svd', - 'sis', - 'sisx', - 'xsm', - 'bdm', - 'xdm', - 'ddf', - 'tao', - 'pcap', - 'cap', - 'dmp', - 'tmo', - 'tpt', - 'mxs', - 'tra', - 'ufd', - 'ufdl', - 'utz', - 'umj', - 'unityweb', - 'uoml', - 'vcx', - 'vsd', - 'vst', - 'vss', - 'vsw', - 'vis', - 'vsf', - 'wbxml', - 'wmlc', - 'wmlsc', - 'wtb', - 'nbp', - 'wpd', - 'wqd', - 'stf', - 'xar', - 'xfdl', - 'hvd', - 'hvs', - 'hvp', - 'osf', - 'osfpvg', - 'saf', - 'spf', - 'cmp', - 'zir', - 'zirz', - 'zaz', - '7z', - 'abw', - 'ace', - '*dmg', - 'arj', - 'aab', - 'x32', - 'u32', - 'vox', - 'aam', - 'aas', - 'bcpio', - '*bdoc', - 'torrent', - 'blb', - 'blorb', - 'bz', - 'bz2', - 'boz', - 'cbr', - 'cba', - 'cbt', - 'cbz', - 'cb7', - 'vcd', - 'cfs', - 'chat', - 'pgn', - 'crx', - 'cco', - 'nsc', - 'cpio', - 'csh', - '*deb', - 'udeb', - 'dgc', - 'dir', - 'dcr', - 'dxr', - 'cst', - 'cct', - 'cxt', - 'w3d', - 'fgd', - 'swa', - 'wad', - 'ncx', - 'dtb', - 'res', - 'dvi', - 'evy', - 'eva', - 'bdf', - 'gsf', - 'psf', - 'pcf', - 'snf', - 'pfa', - 'pfb', - 'pfm', - 'afm', - 'arc', - 'spl', - 'gca', - 'ulx', - 'gnumeric', - 'gramps', - 'gtar', - 'hdf', - 'php', - 'install', - '*iso', - '*key', - '*numbers', - '*pages', - 'jardiff', - 'jnlp', - 'kdbx', - 'latex', - 'luac', - 'lzh', - 'lha', - 'run', - 'mie', - 'prc', - 'mobi', - 'application', - 'lnk', - 'wmd', - 'wmz', - 'xbap', - 'mdb', - 'obd', - 'crd', - 'clp', - '*exe', - '*dll', - 'com', - 'bat', - '*msi', - 'mvb', - 'm13', - 'm14', - '*wmf', - '*wmz', - '*emf', - 'emz', - 'mny', - 'pub', - 'scd', - 'trm', - 'wri', - 'nc', - 'cdf', - 'pac', - 'nzb', - 'pl', - 'pm', - '*prc', - '*pdb', - 'p12', - 'pfx', - 'p7b', - 'spc', - 'p7r', - '*rar', - 'rpm', - 'ris', - 'sea', - 'sh', - 'shar', - 'swf', - 'xap', - 'sql', - 'sit', - 'sitx', - 'srt', - 'sv4cpio', - 'sv4crc', - 't3', - 'gam', - 'tar', - 'tcl', - 'tk', - 'tex', - 'tfm', - 'texinfo', - 'texi', - '*obj', - 'ustar', - 'hdd', - 'ova', - 'ovf', - 'vbox', - 'vbox-extpack', - 'vdi', - 'vhd', - 'vmdk', - 'src', - 'webapp', - 'der', - 'crt', - 'pem', - 'fig', - '*xlf', - 'xpi', - 'xz', - 'z1', - 'z2', - 'z3', - 'z4', - 'z5', - 'z6', - 'z7', - 'z8', - 'uva', - 'uvva', - 'eol', - 'dra', - 'dts', - 'dtshd', - 'lvp', - 'pya', - 'ecelp4800', - 'ecelp7470', - 'ecelp9600', - 'rip', - 'aac', - 'aif', - 'aiff', - 'aifc', - 'caf', - 'flac', - '*m4a', - 'mka', - 'm3u', - 'wax', - 'wma', - 'ram', - 'ra', - 'rmp', - '*ra', - 'cdx', - 'cif', - 'cmdf', - 'cml', - 'csml', - 'xyz', - 'btif', - 'pti', - 'psd', - 'azv', - 'uvi', - 'uvvi', - 'uvg', - 'uvvg', - 'djvu', - 'djv', - '*sub', - 'dwg', - 'dxf', - 'fbs', - 'fpx', - 'fst', - 'mmr', - 'rlc', - 'ico', - 'dds', - 'mdi', - 'wdp', - 'npx', - 'b16', - 'tap', - 'vtf', - 'wbmp', - 'xif', - 'pcx', - '3ds', - 'ras', - 'cmx', - 'fh', - 'fhc', - 'fh4', - 'fh5', - 'fh7', - '*ico', - 'jng', - 'sid', - '*bmp', - '*pcx', - 'pic', - 'pct', - 'pnm', - 'pbm', - 'pgm', - 'ppm', - 'rgb', - 'tga', - 'xbm', - 'xpm', - 'xwd', - 'wsc', - 'dae', - 'dwf', - 'gdl', - 'gtw', - 'mts', - 'ogex', - 'x_b', - 'x_t', - 'vds', - 'usdz', - 'bsp', - 'vtu', - 'dsc', - 'curl', - 'dcurl', - 'mcurl', - 'scurl', - 'sub', - 'fly', - 'flx', - 'gv', - '3dml', - 'spot', - 'jad', - 'wml', - 'wmls', - 's', - 'asm', - 'c', - 'cc', - 'cxx', - 'cpp', - 'h', - 'hh', - 'dic', - 'htc', - 'f', - 'for', - 'f77', - 'f90', - 'hbs', - 'java', - 'lua', - 'mkd', - 'nfo', - 'opml', - '*org', - 'p', - 'pas', - 'pde', - 'sass', - 'scss', - 'etx', - 'sfv', - 'ymp', - 'uu', - 'vcs', - 'vcf', - 'uvh', - 'uvvh', - 'uvm', - 'uvvm', - 'uvp', - 'uvvp', - 'uvs', - 'uvvs', - 'uvv', - 'uvvv', - 'dvb', - 'fvt', - 'mxu', - 'm4u', - 'pyv', - 'uvu', - 'uvvu', - 'viv', - 'f4v', - 'fli', - 'flv', - 'm4v', - 'mkv', - 'mk3d', - 'mks', - 'mng', - 'asf', - 'asx', - 'vob', - 'wm', - 'wmv', - 'wmx', - 'wvx', - 'avi', - 'movie', - 'smv', - 'ice', - 'mht', - null, - ], - example: 'pdf', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - example: 'application/pdf', - nullable: true, - }, - }, - }, - ForbiddenResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 403, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Forbidden resource', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - GenderEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'male', - 'female', - 'non_binary', - 'other', - 'not_disclosed', - 'diverse', - 'unmapped_value', - null, - ], - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - GroupTypeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'workspace', - 'team', - 'department', - 'group', - 'organization', - 'unmapped_value', - 'cost_center', - null, - ], - example: 'team', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - HRISBankDetails: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - account_name: { - type: 'string', - description: 'The name of the bank account', - example: 'John Doe Primary Account', - nullable: true, - }, - is_primary: { - description: 'Whether this is the primary bank account', - example: true, - oneOf: [ - { - type: 'boolean', - }, - { - type: 'string', - enum: ['true', 'false'], - }, - ], - nullable: true, - }, - country_code: { - description: 'The country code where the bank is located', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/CountryCodeEnum', - }, - ], - }, - currency_code: { - description: 'The currency code for the account', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/CurrencyCodeEnum', - }, - ], - }, - bank_name: { - type: 'string', - description: 'The name of the bank', - example: 'Chase Bank', - nullable: true, - }, - account_type: { - description: 'The type of bank account', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/BankAccountTypeEnum', - }, - ], - }, - iban: { - type: 'string', - description: 'International Bank Account Number (IBAN)', - example: 'GB82WEST12345698765432', - nullable: true, - }, - local_account_number: { - type: 'string', - description: 'Local account number (used when IBAN is not available)', - example: '1234567890', - nullable: true, - }, - swift_bic: { - type: 'string', - description: 'SWIFT/BIC code for international transfers', - example: 'CHASUS33', - nullable: true, - }, - clearing_codes: { - description: 'Array of clearing codes required by the country', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/ClearingCode', - }, - }, - }, - }, - HrisBatchDocumentUploadRequestDto: { - type: 'object', - properties: { - items: { - description: 'The batch of items to create', - nullable: false, - type: 'array', - items: { - $ref: '#/components/schemas/HrisDocumentsUploadRequestDto', - }, - }, - }, - required: ['items'], - }, - HRISBenefit: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - description: 'The name of the benefit', - example: 'Health Insurance', - nullable: true, - }, - benefit_type: { - description: 'The type of the benefit', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/BenefitsTypeEnum', - }, - ], - }, - provider: { - type: 'string', - description: 'The provider of the benefit', - example: 'Aetna', - nullable: true, - }, - description: { - type: 'string', - description: 'The description of the benefit', - example: 'Health insurance for employees', - nullable: true, - }, - created_at: { - type: 'string', - description: 'The date and time the benefit was created', - example: '2021-01-01T00:00:00Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'The date and time the benefit was last updated', - example: '2021-01-01T00:00:00Z', - format: 'date-time', - nullable: true, - }, - }, - }, - HRISBenefitResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/HRISBenefit', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - HRISBenefitsPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/HRISBenefit', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - HRISCostCenter: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - name: { - type: 'string', - description: 'The name of the group', - example: 'Engineering', - nullable: true, - }, - parent_ids: { - description: 'The list of parent group ids of the given group', - example: ['cxIQNjUyNDM0', 'cxIQNjQzNzI0MQ'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - remote_parent_ids: { - description: "Provider's list of parent group remote ids of the given group", - example: ['652434', '6437241'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - owner_ids: { - description: 'The list of group owner ids of the given group', - example: ['cxIQNjUyEDM0', 'cxIQNjQzNzA0MQ'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - remote_owner_ids: { - description: 'The list of remote group owner ids of the given group', - example: ['475364', '4327652'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - company_id: { - type: 'string', - description: 'The id of the company that the group belongs to', - example: '1234567890', - nullable: true, - }, - remote_company_id: { - type: 'string', - description: "Provider's id of the company that the group belongs to", - example: '1234567890', - nullable: true, - }, - distribution_percentage: { - type: 'number', - example: 85, - description: 'The distribution percentage for cost_center', - nullable: true, - }, - type: { - description: 'The type of the group', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/GroupTypeEnum', - }, - ], - }, - }, - }, - HRISCostCenterPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/HRISCostCenter', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - HRISCostCenterResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/HRISCostCenter', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - HrisCreateEmployeeRequestDto: { - type: 'object', - properties: { - title: { - type: 'string', - description: "The prefix of the employee's name (e.g., Mr, Ms, Dr)", - example: 'Mr', - nullable: true, - }, - first_name: { - type: 'string', - description: 'The employee first name', - example: 'Isaac', - nullable: true, - }, - last_name: { - type: 'string', - description: 'The employee last name', - example: 'Newton', - nullable: true, - }, - name: { - type: 'string', - description: 'The employee name', - example: 'Isaac Newton', - nullable: true, - }, - display_name: { - type: 'string', - description: 'The employee display name', - example: 'Sir Isaac Newton', - nullable: true, - }, - avatar_url: { - type: 'string', - description: 'The employee avatar Url', - example: 'https://example.com/avatar.png', - nullable: true, - }, - personal_email: { - type: 'string', - description: 'The employee personal email', - example: 'isaac.newton@example.com', - nullable: true, - }, - personal_phone_number: { - type: 'string', - description: 'The employee personal phone number', - example: '+1234567890', - nullable: true, - }, - work_email: { - type: 'string', - description: 'The employee work email', - example: 'newton@example.com', - nullable: true, - }, - work_phone_number: { - type: 'string', - description: 'The employee work phone number', - example: '+1234567890', - nullable: true, - }, - job_id: { - type: 'string', - description: 'The employee job id', - example: 'R-6789', - deprecated: true, - nullable: true, - }, - job_title: { - type: 'string', - description: - "If the source of the job_title is the Employee's current Employment, and that Employment pertains exclusively to this Employee, then the active Employment job_title will also be written", - example: 'Physicist', - nullable: true, - }, - department_id: { - type: 'string', - description: 'The employee department id', - example: '3093', - nullable: true, - }, - team_id: { - type: 'string', - description: 'The employee team id', - example: '2913', - nullable: true, - }, - department: { - type: 'string', - description: 'The employee department', - example: 'Physics', - nullable: true, - }, - manager_id: { - type: 'string', - description: 'The employee manager ID', - example: '67890', - nullable: true, - }, - gender: { - description: 'The employee gender', - example: 'male', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/GenderEnum', - }, - ], - }, - preferred_language: { - description: 'The employee preferred language', - example: 'eng', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/PreferredLanguageEnum', - }, - ], - }, - ethnicity: { - description: 'The employee ethnicity', - example: 'white', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/EthnicityEnum', - }, - ], - }, - date_of_birth: { - type: 'string', - description: 'The date when the employee was born', - example: '1990-01-01T00:00:00.000Z', - format: 'date-time', - nullable: true, - }, - birthday: { - type: 'string', - description: 'The next birthday of the employee (upcoming birthday)', - example: '2021-01-01T00:00:00Z', - format: 'date-time', - nullable: true, - }, - marital_status: { - description: 'The employee marital status', - example: 'single', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/MaritalStatusEnum', - }, - ], - }, - avatar: { - description: 'The employee avatar', - example: 'https://example.com/avatar.png', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/Image', - }, - ], - }, - hire_date: { - type: 'string', - description: 'The employee hire date', - example: '2021-01-01T00:00:00.000Z', - format: 'date-time', - nullable: true, - }, - start_date: { - type: 'string', - description: 'The employee start date', - example: '2021-01-01T00:00:00.000Z', - format: 'date-time', - nullable: true, - }, - employment_type: { - description: 'The employee employment type', - example: 'permanent', - deprecated: true, - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/EmploymentTypeEnum', - }, - ], - }, - employment_contract_type: { - description: 'The employment work schedule type (e.g., full-time, part-time)', - example: 'full_time', - deprecated: true, - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/EmploymentScheduleTypeEnum', - }, - ], - }, - employment_status: { - description: 'The employee employment status', - example: 'active', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/EmploymentStatusEnum', - }, - ], - }, - termination_date: { - type: 'string', - description: 'The employee termination date', - example: '2021-01-01T00:00:00Z', - format: 'date-time', - nullable: true, - }, - company_name: { - type: 'string', - description: 'The employee company name', - example: 'Example Corp', - deprecated: true, - nullable: true, - }, - company_id: { - type: 'string', - description: 'The employee company id', - example: '1234567890', - nullable: true, - }, - citizenships: { - description: 'The citizenships of the Employee', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/CountryCodeEnum', - }, - }, - employments: { - description: 'The employee employments', - deprecated: true, - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/CreateEmploymentApiModel', - }, - }, - employment: { - description: 'The employee employment', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/CreateEmployeeEmploymentApiModel', - }, - ], - }, - custom_fields: { - description: 'The employee custom fields', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/CustomFields', - }, - }, - benefits: { - description: 'Current benefits of the employee', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/CreateHRISBenefit', - }, - }, - employee_number: { - type: 'string', - description: 'The assigned employee number', - example: '125', - nullable: true, - }, - national_identity_number: { - description: 'The national identity number', - deprecated: true, - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/NationalIdentityNumberApiModel', - }, - ], - }, - national_identity_numbers: { - description: 'The national identity numbers', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/NationalIdentityNumberApiModel', - }, - }, - home_location: { - description: 'The employee home location', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/CreateEmployeeLocationApiModel', - }, - ], - }, - work_location: { - description: 'The employee work location', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/CreateEmployeeLocationApiModel', - }, - ], - }, - cost_centers: { - description: 'The employee cost centers', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/CreateCostCenterApiModel', - }, - }, - passthrough: { - type: 'object', - description: 'Value to pass through to the provider', - example: { - other_known_names: 'John Doe', - }, - additionalProperties: true, - nullable: true, - }, - }, - }, - HrisCreateEmploymentRequestDto: { - type: 'object', - properties: { - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - job_title: { - type: 'string', - description: 'The job title of the employee', - example: 'Software Engineer', - nullable: true, - }, - pay_rate: { - type: 'string', - description: 'The amount of compensation for the employee', - example: '40.00', - nullable: true, - }, - pay_period: { - description: 'The time period over which the pay rate is calculated', - example: 'monthly', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/PayPeriodEnum', - }, - ], - }, - pay_frequency: { - description: 'How often the employee is paid', - example: 'hourly', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/PayFrequencyEnum', - }, - ], - }, - pay_currency: { - type: 'string', - description: 'The currency used for pay', - example: 'USD', - nullable: true, - }, - effective_date: { - type: 'string', - description: 'The effective date of the employment contract', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - end_date: { - type: 'string', - description: 'The end date of employment', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - grade: { - description: 'Represents the employee’s position within the organizational hierarchy.', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/EmploymentGradeApiModel', - }, - ], - }, - employment_type: { - description: 'The type of employment (e.g., contractor, permanent)', - example: 'permanent', - deprecated: true, - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/EmploymentTypeEnum', - }, - ], - }, - employment_contract_type: { - description: 'The employment work schedule type (e.g., full-time, part-time)', - example: 'full_time', - deprecated: true, - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/EmploymentScheduleTypeEnum', - }, - ], - }, - type: { - description: 'The type of employment', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/TypeApiModel', - }, - ], - }, - contract_type: { - description: 'The employment work schedule type', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/ContractTypeApiModel', - }, - ], - }, - work_time: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/WorkTimeApiModel', - }, - ], - }, - payroll_code: { - type: 'string', - description: 'The payroll code of the employee', - example: 'PC1', - nullable: true, - }, - job_id: { - type: 'string', - description: 'The employee job id', - example: '5290', - nullable: true, - }, - passthrough: { - type: 'object', - description: 'Value to pass through to the provider', - example: { - other_known_names: 'John Doe', - }, - additionalProperties: true, - nullable: true, - }, - }, - }, - HrisCreateTimeOffRequestDto: { - type: 'object', - properties: { - approver_id: { - type: 'string', - description: 'The approver ID', - example: '1687-4', - nullable: true, - }, - status: { - description: 'The status of the time off request', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/TimeOffStatusEnum', - }, - ], - }, - type: { - description: 'The type of the time off request', - deprecated: true, - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/TimeOffTypeEnum', - }, - ], - }, - start_date: { - type: 'string', - description: - 'The start date of the time off request (ISO8601 date-time without timezone)', - example: '2021-01-01T01:01:01.000', - format: 'datetime-local', - nullable: true, - }, - end_date: { - type: 'string', - description: - 'Inclusive end date of the time off request (ISO8601 date-time without timezone). The time off includes this day', - example: '2021-01-01T01:01:01.000', - format: 'datetime-local', - nullable: true, - }, - start_half_day: { - description: - 'True if the start of the time off request begins half way through the day', - example: true, - oneOf: [ - { - type: 'boolean', - }, - { - type: 'string', - enum: ['true', 'false'], - }, - ], - nullable: true, - }, - end_half_day: { - description: 'True if the end of the time off request ends half way through the day', - example: true, - oneOf: [ - { - type: 'boolean', - }, - { - type: 'string', - enum: ['true', 'false'], - }, - ], - nullable: true, - }, - time_off_policy_id: { - type: 'string', - description: 'The time off policy id associated with this time off request', - example: 'cx280928933', - nullable: true, - }, - reason: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/Reason', - }, - ], - }, - comment: { - type: 'string', - description: - 'Allows users to provide additional context or notes for their time off request', - example: 'Taking a day off for personal reasons', - nullable: true, - }, - passthrough: { - type: 'object', - description: 'Value to pass through to the provider', - example: { - other_known_names: 'John Doe', - }, - additionalProperties: true, - nullable: true, - }, - }, - }, - HrisCreateWorkEligibilityRequestDto: { - type: 'object', - properties: { - document: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/File', - }, - ], - }, - issued_by: { - description: 'The country code of the issued by authority', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/CountryCodeEnum', - }, - ], - }, - number: { - type: 'string', - example: '1234567890', - nullable: true, - }, - sub_type: { - type: 'string', - example: 'H1B', - nullable: true, - }, - type: { - example: 'visa', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/WorkEligibilityTypeEnum', - }, - ], - }, - valid_from: { - type: 'string', - example: '2021-01-01T00:00:00.000Z', - format: 'date-time', - nullable: true, - }, - valid_to: { - type: 'string', - example: '2021-01-01T00:00:00.000Z', - format: 'date-time', - nullable: true, - }, - passthrough: { - type: 'object', - description: 'Value to pass through to the provider', - example: { - other_known_names: 'John Doe', - }, - additionalProperties: true, - nullable: true, - }, - }, - }, - HRISDepartment: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - name: { - type: 'string', - description: 'The name of the group', - example: 'Engineering', - nullable: true, - }, - parent_ids: { - description: 'The list of parent group ids of the given group', - example: ['cxIQNjUyNDM0', 'cxIQNjQzNzI0MQ'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - remote_parent_ids: { - description: "Provider's list of parent group remote ids of the given group", - example: ['652434', '6437241'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - owner_ids: { - description: 'The list of group owner ids of the given group', - example: ['cxIQNjUyEDM0', 'cxIQNjQzNzA0MQ'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - remote_owner_ids: { - description: 'The list of remote group owner ids of the given group', - example: ['475364', '4327652'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - company_id: { - type: 'string', - description: 'The id of the company that the group belongs to', - example: '1234567890', - nullable: true, - }, - remote_company_id: { - type: 'string', - description: "Provider's id of the company that the group belongs to", - example: '1234567890', - nullable: true, - }, - type: { - description: 'The type of the department group', - example: 'department', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/DepartmentTypeEnum', - }, - ], - }, - }, - }, - HRISDepartmentsPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/HRISDepartment', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - HRISDepartmentsResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/HRISDepartment', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - HRISDivision: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - name: { - type: 'string', - description: 'The name of the group', - example: 'Engineering', - nullable: true, - }, - parent_ids: { - description: 'The list of parent group ids of the given group', - example: ['cxIQNjUyNDM0', 'cxIQNjQzNzI0MQ'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - remote_parent_ids: { - description: "Provider's list of parent group remote ids of the given group", - example: ['652434', '6437241'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - owner_ids: { - description: 'The list of group owner ids of the given group', - example: ['cxIQNjUyEDM0', 'cxIQNjQzNzA0MQ'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - remote_owner_ids: { - description: 'The list of remote group owner ids of the given group', - example: ['475364', '4327652'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - company_id: { - type: 'string', - description: 'The id of the company that the group belongs to', - example: '1234567890', - nullable: true, - }, - remote_company_id: { - type: 'string', - description: "Provider's id of the company that the group belongs to", - example: '1234567890', - nullable: true, - }, - type: { - description: 'The type of the division group', - example: 'division', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/DivisionTypeEnum', - }, - ], - }, - }, - }, - HRISDivisionsPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/HRISDivision', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - HRISDivisionsResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/HRISDivision', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - HrisDocumentApiModel: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - description: 'The name of the file', - example: 'My Document', - nullable: true, - }, - category: { - description: 'The category of the the document', - example: 'templates, forms, backups, etc.', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/HrisDocumentTypeEnum', - }, - ], - }, - contents: { - description: - 'The content of the file. Deprecated, use `url` and `file_format` one level up instead', - deprecated: true, - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/Content', - }, - }, - category_id: { - type: 'string', - description: 'The categoryId of the documents', - example: '6530', - nullable: true, - }, - created_at: { - type: 'string', - description: 'The creation date of the file', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'The update date of the file', - example: '2021-01-02T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - remote_url: { - type: 'string', - description: 'URL where the file content is located', - example: 'https://example.com/file.pdf', - nullable: true, - }, - file_format: { - description: 'The file format of the file', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/FileFormatEnum', - }, - ], - }, - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - type: { - description: 'The content type of the document', - deprecated: true, - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/HrisDocumentTypeEnum', - }, - ], - }, - }, - }, - HrisDocumentResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/HrisDocumentApiModel', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - HrisDocumentsPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/HrisDocumentApiModel', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - HrisDocumentsUploadCategoryEnumApiModel: { - type: 'object', - properties: { - value: { - type: 'string', - description: 'The category name to associate with the file', - enum: [ - 'application', - 'academic', - 'contract', - 'certificates', - 'visa', - 'passport', - 'driver_license', - 'payslip', - 'payroll', - 'appraisal', - 'resume', - 'policy', - 'cover_letter', - 'offer_letter', - 'policy_agreement', - 'home_address', - 'national_id', - 'confidential', - 'signed', - 'shared', - 'other', - 'benefit', - 'id_verification', - 'background_check', - 'unmapped_value', - null, - ], - example: 'reports', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - type: 'string', - description: - 'The provider specific category for associating uploaded files, if provided, the value will be ignored.', - example: '550e8400-e29b-41d4-a716-446655440000', - nullable: true, - }, - }, - }, - HrisDocumentsUploadRequestDto: { - type: 'object', - properties: { - name: { - type: 'string', - description: 'The filename of the file to upload', - example: 'weather-forecast', - nullable: true, - }, - file_format: { - description: 'The file format of the file', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/FileFormatEnum', - }, - ], - }, - content: { - type: 'string', - description: 'The base64 encoded content of the file to upload', - example: - 'VGhpcyBpc24ndCByZWFsbHkgYSBzYW1wbGUgZmlsZSwgYnV0IG5vIG9uZSB3aWxsIGV2ZXIga25vdyE', - nullable: true, - }, - category_id: { - type: 'string', - description: 'The categoryId of the documents', - example: '6530', - nullable: true, - }, - path: { - type: 'string', - description: 'The path for the file to be uploaded to', - example: '/path/to/file', - nullable: true, - }, - confidential: { - description: 'The confidentiality level of the file to be uploaded', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/ConfidentialEnumApiModel', - }, - ], - }, - category: { - description: - 'The category to be associated with the file to be uploaded. Id will take precedence over name.', - example: { - name: 'reports', - id: '550e8400-e29b-41d4-a716-446655440000', - }, - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/HrisDocumentsUploadCategoryEnumApiModel', - }, - ], - }, - }, - }, - HrisDocumentTypeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - description: 'The category of the file', - nullable: true, - enum: [ - 'application', - 'academic', - 'contract', - 'certificates', - 'visa', - 'passport', - 'driver_license', - 'payslip', - 'payroll', - 'appraisal', - 'resume', - 'policy', - 'cover_letter', - 'offer_letter', - 'policy_agreement', - 'home_address', - 'national_id', - 'confidential', - 'signed', - 'shared', - 'other', - 'benefit', - 'id_verification', - 'background_check', - 'unmapped_value', - null, - ], - 'x-speakeasy-unknown-values': 'allow', - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - HRISGroup: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - name: { - type: 'string', - description: 'The name of the group', - example: 'Engineering', - nullable: true, - }, - parent_ids: { - description: 'The list of parent group ids of the given group', - example: ['cxIQNjUyNDM0', 'cxIQNjQzNzI0MQ'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - remote_parent_ids: { - description: "Provider's list of parent group remote ids of the given group", - example: ['652434', '6437241'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - owner_ids: { - description: 'The list of group owner ids of the given group', - example: ['cxIQNjUyEDM0', 'cxIQNjQzNzA0MQ'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - remote_owner_ids: { - description: 'The list of remote group owner ids of the given group', - example: ['475364', '4327652'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - company_id: { - type: 'string', - description: 'The id of the company that the group belongs to', - example: '1234567890', - nullable: true, - }, - remote_company_id: { - type: 'string', - description: "Provider's id of the company that the group belongs to", - example: '1234567890', - nullable: true, - }, - type: { - description: 'The type of the group', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/GroupTypeEnum', - }, - ], - }, - }, - }, - HRISGroupsPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/HRISGroup', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - HRISGroupsResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/HRISGroup', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - HrisInviteEmployeeRequestDto: { - type: 'object', - properties: { - passthrough: { - type: 'object', - description: 'Value to pass through to the provider', - example: { - other_known_names: 'John Doe', - }, - additionalProperties: true, - nullable: true, - }, - }, - }, - HrisJob: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - code: { - type: 'string', - description: 'Code of the job', - example: '184919', - nullable: true, - }, - title: { - type: 'string', - description: 'Title of the job', - example: 'Software Engineer', - nullable: true, - }, - description: { - type: 'string', - description: 'Description of the job', - example: 'Responsible for identifying business requirements', - nullable: true, - }, - status: { - description: 'Status of the job', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/HrisJobStatusEnum', - }, - ], - }, - created_at: { - type: 'string', - description: 'Date of creation', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'Date of last update', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - }, - }, - HrisJobResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/HrisJob', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - HrisJobsPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/HrisJob', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - HrisJobStatusEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'draft', - 'pending', - 'archived', - 'closed', - 'open', - 'deleted', - 'unmapped_value', - null, - ], - description: 'The status of the job.', - example: 'open', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - description: 'The source value of the job status.', - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - HRISLocation: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - employee_id: { - type: 'string', - description: 'The employee ID', - example: '1687-3', - nullable: true, - }, - remote_employee_id: { - type: 'string', - description: "Provider's unique identifier of the employee", - example: 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - nullable: true, - }, - name: { - type: 'string', - description: 'The name of the location', - example: 'Woolsthorpe Manor', - nullable: true, - }, - phone_number: { - type: 'string', - description: 'The phone number of the location', - example: '+44 1476 860 364', - nullable: true, - }, - street_1: { - type: 'string', - description: 'The first line of the address', - example: 'Water Lane', - nullable: true, - }, - street_2: { - type: 'string', - description: 'The second line of the address', - example: 'Woolsthorpe by Colsterworth', - nullable: true, - }, - city: { - type: 'string', - description: 'The city where the location is situated', - example: 'Grantham', - nullable: true, - }, - state: { - type: 'string', - description: 'The state where the location is situated', - example: 'Lincolnshire', - nullable: true, - }, - zip_code: { - type: 'string', - description: 'The ZIP code/Postal code of the location', - example: 'NG33 5NR', - nullable: true, - }, - country: { - description: 'The country code', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/CountryCodeEnum', - }, - ], - }, - location_type: { - description: 'The location type', - example: 'work', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/LocationTypeEnum', - }, - ], - }, - created_at: { - type: 'string', - description: 'The created_at date', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'The updated_at date', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - }, - }, - HRISLocationResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/HRISLocation', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - HRISLocationsPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/HRISLocation', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - HrisShift: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - employee_id: { - type: 'string', - description: 'The employee ID associated with this shift', - example: 'emp_123456789', - nullable: true, - }, - location_id: { - type: 'string', - description: 'The location ID where this shift takes place', - example: 'loc_123456789', - nullable: true, - }, - company_id: { - type: 'string', - description: 'The company ID associated with this shift', - example: 'comp_123456789', - nullable: true, - }, - start_time: { - type: 'string', - description: 'The start time of the shift (ISO8601 date-time without timezone)', - example: '2024-03-20T09:00:00.000', - format: 'datetime-local', - nullable: true, - }, - end_time: { - type: 'string', - description: 'The end time of the shift (ISO8601 date-time without timezone)', - example: '2024-03-20T17:00:00.000', - format: 'datetime-local', - nullable: true, - }, - break_duration: { - type: 'string', - description: 'The total break duration for this shift in ISO 8601 duration format', - example: 'PT1H30M', - nullable: true, - }, - status: { - description: 'The status of the shift', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/ShiftStatusEnum', - }, - ], - }, - approval_status: { - description: 'The approval status of the shift', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/ShiftApprovalStatusEnum', - }, - ], - }, - breaks: { - description: 'The breaks taken during this shift', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/ShiftBreak', - }, - }, - created_at: { - type: 'string', - description: 'The date and time the shift was created', - example: '2024-03-20T08:00:00Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'The date and time the shift was last updated', - example: '2024-03-20T08:00:00Z', - format: 'date-time', - nullable: true, - }, - }, - }, - HrisShiftResult: { - type: 'object', - properties: { - data: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/HrisShift', - }, - ], - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - }, - HrisShiftsPaginated: { - type: 'object', - properties: { - next: { - type: 'string', - nullable: true, - }, - data: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/HrisShift', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - }, - HRISTeam: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - name: { - type: 'string', - description: 'The name of the group', - example: 'Engineering', - nullable: true, - }, - parent_ids: { - description: 'The list of parent group ids of the given group', - example: ['cxIQNjUyNDM0', 'cxIQNjQzNzI0MQ'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - remote_parent_ids: { - description: "Provider's list of parent group remote ids of the given group", - example: ['652434', '6437241'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - owner_ids: { - description: 'The list of group owner ids of the given group', - example: ['cxIQNjUyEDM0', 'cxIQNjQzNzA0MQ'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - remote_owner_ids: { - description: 'The list of remote group owner ids of the given group', - example: ['475364', '4327652'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - company_id: { - type: 'string', - description: 'The id of the company that the group belongs to', - example: '1234567890', - nullable: true, - }, - remote_company_id: { - type: 'string', - description: "Provider's id of the company that the group belongs to", - example: '1234567890', - nullable: true, - }, - type: { - description: 'The type of the team group', - example: 'team', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/TeamTypeEnum', - }, - ], - }, - }, - }, - HRISTeamsPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/HRISTeam', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - HRISTeamsResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/HRISTeam', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - HrisUpdateEmployeeRequestDto: { - type: 'object', - properties: { - title: { - type: 'string', - description: "The prefix of the employee's name (e.g., Mr, Ms, Dr)", - example: 'Mr', - nullable: true, - }, - first_name: { - type: 'string', - description: 'The employee first name', - example: 'Isaac', - nullable: true, - }, - last_name: { - type: 'string', - description: 'The employee last name', - example: 'Newton', - nullable: true, - }, - name: { - type: 'string', - description: 'The employee name', - example: 'Isaac Newton', - nullable: true, - }, - display_name: { - type: 'string', - description: 'The employee display name', - example: 'Sir Isaac Newton', - nullable: true, - }, - avatar_url: { - type: 'string', - description: 'The employee avatar Url', - example: 'https://example.com/avatar.png', - nullable: true, - }, - personal_email: { - type: 'string', - description: 'The employee personal email', - example: 'isaac.newton@example.com', - nullable: true, - }, - personal_phone_number: { - type: 'string', - description: 'The employee personal phone number', - example: '+1234567890', - nullable: true, - }, - work_email: { - type: 'string', - description: 'The employee work email', - example: 'newton@example.com', - nullable: true, - }, - work_phone_number: { - type: 'string', - description: 'The employee work phone number', - example: '+1234567890', - nullable: true, - }, - job_id: { - type: 'string', - description: 'The employee job id', - example: 'R-6789', - deprecated: true, - nullable: true, - }, - job_title: { - type: 'string', - description: - "If the source of the job_title is the Employee's current Employment, and that Employment pertains exclusively to this Employee, then the active Employment job_title will also be written", - example: 'Physicist', - nullable: true, - }, - department_id: { - type: 'string', - description: 'The employee department id', - example: '3093', - nullable: true, - }, - team_id: { - type: 'string', - description: 'The employee team id', - example: '2913', - nullable: true, - }, - department: { - type: 'string', - description: 'The employee department', - example: 'Physics', - nullable: true, - }, - manager_id: { - type: 'string', - description: 'The employee manager ID', - example: '67890', - nullable: true, - }, - gender: { - description: 'The employee gender', - example: 'male', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/GenderEnum', - }, - ], - }, - preferred_language: { - description: 'The employee preferred language', - example: 'eng', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/PreferredLanguageEnum', - }, - ], - }, - ethnicity: { - description: 'The employee ethnicity', - example: 'white', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/EthnicityEnum', - }, - ], - }, - date_of_birth: { - type: 'string', - description: 'The date when the employee was born', - example: '1990-01-01T00:00:00.000Z', - format: 'date-time', - nullable: true, - }, - birthday: { - type: 'string', - description: 'The next birthday of the employee (upcoming birthday)', - example: '2021-01-01T00:00:00Z', - format: 'date-time', - nullable: true, - }, - marital_status: { - description: 'The employee marital status', - example: 'single', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/MaritalStatusEnum', - }, - ], - }, - avatar: { - description: 'The employee avatar', - example: 'https://example.com/avatar.png', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/Image', - }, - ], - }, - hire_date: { - type: 'string', - description: 'The employee hire date', - example: '2021-01-01T00:00:00.000Z', - format: 'date-time', - nullable: true, - }, - start_date: { - type: 'string', - description: 'The employee start date', - example: '2021-01-01T00:00:00.000Z', - format: 'date-time', - nullable: true, - }, - employment_type: { - description: 'The employee employment type', - example: 'permanent', - deprecated: true, - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/EmploymentTypeEnum', - }, - ], - }, - employment_contract_type: { - description: 'The employment work schedule type (e.g., full-time, part-time)', - example: 'full_time', - deprecated: true, - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/EmploymentScheduleTypeEnum', - }, - ], - }, - employment_status: { - description: 'The employee employment status', - example: 'active', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/EmploymentStatusEnum', - }, - ], - }, - termination_date: { - type: 'string', - description: 'The employee termination date', - example: '2021-01-01T00:00:00Z', - format: 'date-time', - nullable: true, - }, - company_name: { - type: 'string', - description: 'The employee company name', - example: 'Example Corp', - deprecated: true, - nullable: true, - }, - company_id: { - type: 'string', - description: 'The employee company id', - example: '1234567890', - nullable: true, - }, - citizenships: { - description: 'The citizenships of the Employee', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/CountryCodeEnum', - }, - }, - employment: { - description: 'The employee employment', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/CreateEmployeeEmploymentApiModel', - }, - ], - }, - custom_fields: { - description: 'The employee custom fields', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/CustomFields', - }, - }, - benefits: { - description: 'Current benefits of the employee', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/CreateHRISBenefit', - }, - }, - employee_number: { - type: 'string', - description: 'The assigned employee number', - example: '125', - nullable: true, - }, - national_identity_number: { - description: 'The national identity number', - deprecated: true, - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/NationalIdentityNumberApiModel', - }, - ], - }, - national_identity_numbers: { - description: 'The national identity numbers', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/NationalIdentityNumberApiModel', - }, - }, - home_location: { - description: 'The employee home location', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/CreateEmployeeLocationApiModel', - }, - ], - }, - work_location: { - description: 'The employee work location', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/CreateEmployeeLocationApiModel', - }, - ], - }, - passthrough: { - type: 'object', - description: 'Value to pass through to the provider', - example: { - other_known_names: 'John Doe', - }, - additionalProperties: true, - nullable: true, - }, - }, - }, - HrisUpdateEmploymentRequestDto: { - type: 'object', - properties: { - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - job_title: { - type: 'string', - description: 'The job title of the employee', - example: 'Software Engineer', - nullable: true, - }, - pay_rate: { - type: 'string', - description: 'The amount of compensation for the employee', - example: '40.00', - nullable: true, - }, - pay_period: { - description: 'The time period over which the pay rate is calculated', - example: 'monthly', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/PayPeriodEnum', - }, - ], - }, - pay_frequency: { - description: 'How often the employee is paid', - example: 'hourly', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/PayFrequencyEnum', - }, - ], - }, - pay_currency: { - type: 'string', - description: 'The currency used for pay', - example: 'USD', - nullable: true, - }, - effective_date: { - type: 'string', - description: 'The effective date of the employment contract', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - end_date: { - type: 'string', - description: 'The end date of employment', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - grade: { - description: 'Represents the employee’s position within the organizational hierarchy.', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/EmploymentGradeApiModel', - }, - ], - }, - employment_type: { - description: 'The type of employment (e.g., contractor, permanent)', - example: 'permanent', - deprecated: true, - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/EmploymentTypeEnum', - }, - ], - }, - employment_contract_type: { - description: 'The employment work schedule type (e.g., full-time, part-time)', - example: 'full_time', - deprecated: true, - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/EmploymentScheduleTypeEnum', - }, - ], - }, - type: { - description: 'The type of employment', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/TypeApiModel', - }, - ], - }, - contract_type: { - description: 'The employment work schedule type', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/ContractTypeApiModel', - }, - ], - }, - work_time: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/WorkTimeApiModel', - }, - ], - }, - payroll_code: { - type: 'string', - description: 'The payroll code of the employee', - example: 'PC1', - nullable: true, - }, - passthrough: { - type: 'object', - description: 'Value to pass through to the provider', - example: { - other_known_names: 'John Doe', - }, - additionalProperties: true, - nullable: true, - }, - }, - }, - Image: { - type: 'object', - properties: { - url: { - type: 'string', - nullable: true, - }, - base64: { - type: 'string', - nullable: true, - }, - }, - }, - InternalServerErrorResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 500, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Internal server error', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - InviteEmployeeResult: { - type: 'object', - properties: { - statusCode: { - type: 'number', - example: 200, - }, - message: { - type: 'string', - example: 'Record invited successfully', - }, - timestamp: { - type: 'string', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - }, - data: { - $ref: '#/components/schemas/CreateResultDataApiModel', - }, - }, - required: ['statusCode', 'message', 'timestamp', 'data'], - }, - ISO3166_2SubDivisionEnum: { - type: 'object', - properties: { - value: { - type: 'string', - description: 'state (ISO3166-2 Sub Division Code) - value must be a valid enum value', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - JobDescriptionApiModel: { - type: 'object', - properties: { - text: { - type: 'string', - example: 'Testing the laws of motion', - nullable: true, - }, - }, - }, - LaborTypeApiModel: { - type: 'object', - properties: { - code: { - type: 'string', - example: 'ABC123', - nullable: true, - }, - }, - }, - LanguageEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'ar_AR', - 'aa_ER', - 'af_NA', - 'af_ZA', - 'am_ET', - 'ar_AE', - 'ar_BH', - 'ar_DJ', - 'ar_DZ', - 'ar_EG', - 'ar_ER', - 'ar_IQ', - 'ar_JO', - 'ar_KM', - 'ar_KW', - 'ar_LB', - 'ar_LY', - 'ar_MA', - 'ar_MR', - 'ar_OM', - 'ar_PS', - 'ar_QA', - 'ar_SA', - 'ar_SD', - 'ar_SY', - 'ar_TD', - 'ar_TN', - 'ar_YE', - 'ay_BO', - 'ay_PE', - 'az_AZ', - 'az_IR', - 'be_BY', - 'bg_BG', - 'bi_VU', - 'bn_BD', - 'bn_IN', - 'bs_BA', - 'bs-ME', - 'byn_ER', - 'ca_AD', - 'ca_ES', - 'ca_FR', - 'ca_IT', - 'ch_GU', - 'cs_CZ', - 'da_DK', - 'de_AT', - 'de_BE', - 'de_CH', - 'de_DE', - 'de_LI', - 'de_LU', - 'de_VA', - 'de_MV', - 'dv_MV', - 'dz_BT', - 'el_CY', - 'el_GR', - 'en_AG', - 'en_AI', - 'en_AS', - 'en_AU', - 'en_BB', - 'en_BE', - 'en_BM', - 'en_BS', - 'en_BW', - 'en_BZ', - 'en_CA', - 'en_CC', - 'en_CK', - 'en_CM', - 'en_CW', - 'en_CX', - 'en_DG', - 'en_DM', - 'en_ER', - 'en_FJ', - 'en_FK', - 'en_FM', - 'en_GB', - 'en_GD', - 'en_GG', - 'en_GH', - 'en_GI', - 'en_GM', - 'en_GS', - 'en_GU', - 'en_GY', - 'en_HK', - 'en_IE', - 'en_IM', - 'en_IN', - 'en_IO', - 'en_JE', - 'en_JM', - 'en_KE', - 'en_KI', - 'en_KN', - 'en_KY', - 'en_LC', - 'en_LR', - 'en_LS', - 'en_MF', - 'en_MG', - 'en_MH', - 'en_MO', - 'en_MP', - 'en_MS', - 'en_MT', - 'en_MU', - 'en_MW', - 'en_MY', - 'en_NA', - 'en_NF', - 'en_NG', - 'en_NL', - 'en_NR', - 'en_NU', - 'en_NZ', - 'en_PG', - 'en_PH', - 'en_PK', - 'en_PN', - 'en_PR', - 'en_PW', - 'en_RW', - 'en_SB', - 'en_SC', - 'en_SD', - 'en_SG', - 'en_SH', - 'en_SL', - 'en_SS', - 'en_SX', - 'en_SZ', - 'en_TC', - 'en_TK', - 'en_TO', - 'en_TT', - 'en_TV', - 'en_TZ', - 'en_UG', - 'en_UM', - 'en_US', - 'en_VC', - 'en_VG', - 'en_VI', - 'en_VU', - 'en_WS', - 'en_ZA', - 'en_ZM', - 'en_ZW', - 'es_AR', - 'es_BO', - 'es_BZ', - 'es_CL', - 'es_CO', - 'es_CR', - 'es_CU', - 'es_DO', - 'es_EA', - 'es_EC', - 'es_EH', - 'es_ES', - 'es_GQ', - 'es_GT', - 'es_HN', - 'es_IC', - 'es_LA', - 'es_MX', - 'es_NI', - 'es_PA', - 'es_PE', - 'es_PH', - 'es_PR', - 'es_PY', - 'es_SV', - 'es_US', - 'es_UY', - 'es_VE', - 'et_EE', - 'fa_AF', - 'fa_IR', - 'fan_GA', - 'ff_CM', - 'ff_GN', - 'ff_MR', - 'ff_SN', - 'ff_BF', - 'fi_FI', - 'fj_FJ', - 'fo_FO', - 'fr_BE', - 'fr_BF', - 'fr_BI', - 'fr_BJ', - 'fr_BL', - 'fr_CA', - 'fr_CD', - 'fr_CF', - 'fr_CG', - 'fr_CH', - 'fr_CI', - 'fr_CM', - 'fr_DJ', - 'fr_DZ', - 'fr_FR', - 'fr_GA', - 'fr_GF', - 'fr_GG', - 'fr_GN', - 'fr_GP', - 'fr_GQ', - 'fr_HT', - 'fr_KM', - 'fr_JE', - 'fr_LU', - 'fr_LB', - 'fr_MA', - 'fr_MC', - 'fr_MF', - 'fr_MG', - 'fr_ML', - 'fr_MQ', - 'fr_MR', - 'fr_MU', - 'fr_NC', - 'fr_NE', - 'fr_PF', - 'fr_PM', - 'fr_RE', - 'fr_RW', - 'fr_SC', - 'fr_SN', - 'fr_SY', - 'fr_TD', - 'fr_TF', - 'fr_TG', - 'fr_TN', - 'fr_VU', - 'fr_VA', - 'fr_WF', - 'fr_YT', - 'ga_IE', - 'gn_PY', - 'gn_AR', - 'gu_IN', - 'gv_IM', - 'he_IL', - 'hi_IN', - 'hr_BA', - 'hr_HR', - 'hr_ME', - 'ht_HT', - 'hu_HU', - 'hy_AM', - 'hy_CY', - 'id_ID', - 'is_IS', - 'it_CH', - 'it_IT', - 'it_SM', - 'it_VA', - 'ja_JP', - 'ka_GE', - 'kg_CD', - 'kk_KZ', - 'kl_GL', - 'km_KH', - 'ko_KP', - 'ko_KR', - 'ku_IQ', - 'ky_KG', - 'la_VA', - 'lb_LU', - 'ln_AO', - 'ln_CD', - 'ln_CF', - 'ln_CG', - 'lo_LA', - 'lt_LT', - 'lu_CD', - 'lv_LV', - 'mg_MG', - 'mh_MH', - 'mi_NZ', - 'mk_MK', - 'mn_MN', - 'mr_IN', - 'ms_BN', - 'ms_MY', - 'ms_SG', - 'mt_MT', - 'my_MM', - 'nb_NO', - 'nb_BV', - 'nb_ZW', - 'ne_NP', - 'nl_AW', - 'nl_BE', - 'nl_BQ', - 'nl_CW', - 'nl_NL', - 'nl_SR', - 'nl_SX', - 'nl_MF', - 'nn_NO', - 'nn_BV', - 'no_NO', - 'no_BV', - 'no_SJ', - 'nr_ZA', - 'ny_MW', - 'pa_IN', - 'pa_PK', - 'pl_PL', - 'ps_AF', - 'pt_AO', - 'pt_BR', - 'pt_CH', - 'pt_CV', - 'pt_GQ', - 'pt_GW', - 'pt_LU', - 'pt_MO', - 'pt_MZ', - 'pt_PT', - 'pt_ST', - 'pt_TL', - 'qu_BO', - 'qu_EC', - 'qu_PE', - 'rar_CK', - 'rm_CH', - 'rup_MK', - 'ro_MD', - 'ro_RO', - 'ru_BY', - 'ru_KG', - 'ru_KZ', - 'ru_MD', - 'ru_RU', - 'ru_UA', - 'ru_AQ', - 'ru_TJ', - 'ru_TM', - 'ru_UZ', - 'rw_RW', - 'se_SE', - 'sg_CF', - 'si_LK', - 'sk_SK', - 'sl_SI', - 'sm_AS', - 'sm_WS', - 'sn_ZW', - 'so_DJ', - 'so_ET', - 'so_KE', - 'so_SO', - 'sq_AL', - 'sq_ME', - 'sq_XK', - 'sr_BA', - 'sr_ME', - 'sr_RS', - 'sr_XK', - 'ss_SZ', - 'ss_ZA', - 'sv_AX', - 'sv_FI', - 'sv_SE', - 'sw_KE', - 'sw_TZ', - 'sw_UG', - 'sw_CD', - 'ta_IN', - 'ta_MY', - 'ta_SG', - 'ta_LK', - 'te_IN', - 'tg_TJ', - 'th_TH', - 'ti_ER', - 'ti_ET', - 'tig_ER', - 'tk_TM', - 'tk_AF', - 'tn_BW', - 'tn_ZA', - 'to_TO', - 'tr_CY', - 'tr_TR', - 'ts_ZA', - 'uk_UA', - 'ur_IN', - 'ur_PK', - 'uz_AF', - 'uz_UZ', - 've_ZA', - 'vi_VN', - 'xh_ZA', - 'zh_CN', - 'zh_HK', - 'zh_MO', - 'zh_SG', - 'zh_TW', - 'zu_ZA', - 'unmapped_value', - null, - ], - description: 'The Locale Code of the language', - example: 'en_GB', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - LocationTypeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: ['home', 'work', 'unmapped_value', null], - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - ManagerRoleApiModel: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - label: { - type: 'string', - description: 'The label of the role type', - example: 'Admin', - nullable: true, - }, - role_type: { - description: 'The manager role type (e.g., admin, viewer)', - example: 'admin', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/RoleTypeEnum', - }, - ], - }, - }, - }, - MaritalStatusEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'single', - 'married', - 'common_law', - 'divorced', - 'widowed', - 'domestic_partnership', - 'separated', - 'other', - 'not_disclosed', - 'unmapped_value', - null, - ], - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - NationalIdentityNumberApiModel: { - type: 'object', - properties: { - value: { - type: 'string', - example: '123456789', - nullable: true, - }, - type: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/NationalIdentityNumberTypeEnumApiModel', - }, - ], - }, - country: { - description: 'The country code', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/CountryCodeEnum', - }, - ], - }, - }, - }, - NationalIdentityNumberTypeEnumApiModel: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'ssn', - 'nin', - 'sin', - 'nid', - 'pin', - 'pn', - 'umcn', - 'pic', - 'ric', - 'idnum', - 'cid', - 'nidnr', - 'pan', - 'aadhaar', - 'epic', - 'ptn', - 'itin', - 'tin', - 'uprc', - 'pcode', - 'ssi', - 'cedula', - 'passport', - 'voterid', - 'ntin', - 'bn', - 'fnr', - 'mva', - 'civil_id', - 'cnic', - 'nric', - 'fin', - 'uen', - 'registrationnumber', - 'nic', - 'personnummer', - 'ahv', - 'id', - 'eid', - 'va', - 'pid', - 'nrt', - 'nipt', - 'cbu', - 'cuit', - 'dni', - 'businessid', - 'vnr', - 'abn', - 'acn', - 'tfn', - 'jmbg', - 'bis', - 'insz', - 'nn', - 'egn', - 'pnf', - 'vat', - 'cnpj', - 'unp', - 'gst', - 'pst', - 'qst', - 'ni', - 'dic', - 'rc', - 'uid', - 'rut', - 'uscc', - 'cpf', - 'cpj', - 'cr', - 'stnr', - 'svnr', - 'ncf', - 'rnc', - 'nif', - 'ci', - 'ik', - 'kmkr', - 'registrikood', - 'tn', - 'ruc', - 'nit', - 'alv', - 'hetu', - 'ytunnus', - 'vn', - 'utr', - 'nifp', - 'amka', - 'cui', - 'nir', - 'siren', - 'siret', - 'tva', - 'oib', - 'hkid', - 'anum', - 'kennitala', - 'vsk', - 'npwp', - 'pps', - 'gstin', - 'idnr', - 'hr', - 'aic', - 'codicefiscale', - 'iva', - 'peid', - 'asmens', - 'pvm', - 'ctps', - 'vrn', - 'vtk', - 'int', - 'tk', - 'pas', - 'rne', - 'rg', - 'nci', - 'crnm', - 'pis', - 'insee', - 'tax', - 'mpf', - 'epfo', - 'esi', - 'pran', - 'uan', - 'idk', - 'bsn', - 'mid', - 'sss', - 'nie', - 'nss', - 'arc', - 'curp', - 'imss', - 'rfc', - 'ein', - 'other', - 'unknown', - 'unmapped_value', - null, - ], - description: 'The type of the national identity number', - example: 'ssn', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - NotFoundResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 404, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Not Found', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - NotImplementedResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 501, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Not Implemented', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - PayFrequencyEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'hourly', - 'weekly', - 'bi_weekly', - 'four_weekly', - 'semi_monthly', - 'monthly', - 'bi_monthly', - 'quarterly', - 'semi_annually', - 'yearly', - 'thirteen_monthly', - 'pro_rata', - 'unmapped_value', - 'half_yearly', - 'daily', - 'fixed', - null, - ], - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - PayPeriodEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'hour', - 'day', - 'week', - 'every_two_weeks', - 'month', - 'quarter', - 'every_six_months', - 'year', - 'unmapped_value', - null, - ], - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - Position: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - job_id: { - type: 'string', - description: 'Job ID from the HRIS provider', - example: 'JOB-12345', - nullable: true, - }, - title: { - type: 'string', - description: 'Title of the position', - example: 'Senior Software Engineer', - nullable: true, - }, - description: { - type: 'string', - description: 'Description of the position', - example: 'Responsible for developing and maintaining software applications', - nullable: true, - }, - department_id: { - type: 'string', - description: 'Department ID associated with the position', - example: 'dept-123', - nullable: true, - }, - location_id: { - type: 'string', - description: 'Location ID associated with the position', - example: 'loc-456', - nullable: true, - }, - employment_type: { - type: 'string', - description: 'Employment type for the position', - example: 'full-time', - nullable: true, - }, - status: { - description: 'Status of the position', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/PositionStatusEnum', - }, - ], - }, - posted_date: { - type: 'string', - description: 'Date when the position was posted', - example: '2024-01-15T10:00:00.000Z', - format: 'date-time', - nullable: true, - }, - }, - }, - PositionResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/Position', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - PositionsPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/Position', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - PositionStatusEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: ['open', 'draft', 'closed', 'paused', 'unmapped_value', null], - description: 'The status of the position.', - example: 'open', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - description: 'The source value of the position status.', - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - PreconditionFailedResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 412, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Precondition failed', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - PreferredLanguageEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'aar', - 'afr', - 'amh', - 'ara', - 'aym', - 'aze', - 'bel', - 'bul', - 'bis', - 'ben', - 'bos', - 'byn', - 'cat', - 'cha', - 'ces', - 'dan', - 'deu', - 'div', - 'dzo', - 'ell', - 'eng', - 'spa', - 'est', - 'fas', - 'fan', - 'ful', - 'fin', - 'fij', - 'fao', - 'fra', - 'gle', - 'grn', - 'guj', - 'glv', - 'heb', - 'hin', - 'hrv', - 'hat', - 'hun', - 'hye', - 'ind', - 'isl', - 'ita', - 'jpn', - 'kat', - 'kon', - 'kaz', - 'kal', - 'khm', - 'kor', - 'kur', - 'kir', - 'lat', - 'ltz', - 'lin', - 'lao', - 'lit', - 'lub', - 'lav', - 'mlg', - 'mah', - 'mri', - 'mkd', - 'mon', - 'mar', - 'msa', - 'mlt', - 'mya', - 'nob', - 'nep', - 'nld', - 'nno', - 'nor', - 'nbl', - 'nya', - 'pan', - 'pol', - 'pus', - 'por', - 'que', - 'rar', - 'roh', - 'rup', - 'ron', - 'rus', - 'kin', - 'sme', - 'sag', - 'sin', - 'slk', - 'slv', - 'smo', - 'sna', - 'som', - 'sqi', - 'srp', - 'ssw', - 'swe', - 'swa', - 'tam', - 'tel', - 'tgk', - 'tha', - 'tir', - 'tig', - 'tuk', - 'tsn', - 'ton', - 'tur', - 'tso', - 'ukr', - 'urd', - 'uzb', - 'ven', - 'vie', - 'xho', - 'zho', - 'zul', - 'unmapped_value', - null, - ], - description: 'The ISO639-2 Code of the language', - example: 'eng', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - Proficiency: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - description: 'The name associated with this proficiency', - example: 'Expert', - nullable: true, - }, - value: { - type: 'string', - enum: ['1', '2', '3', '4', '5', 'unmapped_value', null], - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - ProviderError: { - type: 'object', - properties: { - status: { - type: 'number', - description: 'HTTP status code of the provider error', - example: 400, - nullable: true, - }, - url: { - type: 'string', - description: 'URL that caused the error', - example: 'https://api.provider.com/v1/resource', - nullable: true, - }, - raw: { - type: 'object', - description: 'Raw error response from the provider', - example: { - message: 'Invalid input parameters', - }, - nullable: true, - }, - headers: { - type: 'object', - description: 'Response headers', - example: { - 'content-type': 'application/json', - 'x-request-id': '5678c28b211dace4e0a0f9171e6b88c5', - }, - nullable: true, - }, - }, - }, - ProviderErrorApiModel: { - type: 'object', - properties: { - status: { - type: 'number', - example: 400, - nullable: true, - }, - url: { - type: 'string', - example: 'https://api.someprovider.com/v1/endpoint', - nullable: true, - }, - raw: { - type: 'object', - nullable: true, - }, - headers: { - type: 'object', - example: { - date: 'Tue, 02 Apr 2024 13:52:01 GMT', - 'content-type': 'application/json; charset=utf-8', - 'transfer-encoding': 'chunked', - connection: 'close', - }, - nullable: true, - }, - }, - }, - RawResponse: { - type: 'object', - properties: { - method: { - type: 'string', - }, - url: { - type: 'string', - }, - body: { - oneOf: [ - { - type: 'string', - }, - { - type: 'object', - }, - { - type: 'array', - items: { - type: 'integer', - format: 'int32', - minimum: 0, - maximum: 255, - }, - }, - ], - additionalProperties: true, - nullable: true, - }, - response: { - oneOf: [ - { - type: 'object', - additionalProperties: true, - }, - { - type: 'array', - items: {}, - }, - { - type: 'string', - }, - ], - nullable: true, - }, - }, - required: ['method', 'url'], - }, - Reason: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - nullable: true, - }, - }, - }, - Reference: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'The reference id', - example: '1687-3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - description: 'The reference name', - example: '1687-4', - nullable: true, - }, - active: { - description: 'The reference status', - example: true, - oneOf: [ - { - type: 'boolean', - }, - { - type: 'string', - enum: ['true', 'false'], - }, - ], - nullable: true, - }, - }, - }, - ReferencePaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/Reference', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - ReferenceResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/Reference', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - RequestTimedOutResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 408, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Request timed out', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - RoleTypeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'admin', - 'viewer', - 'editor', - 'basic', - 'guest', - 'unassigned', - 'restricted', - 'unmapped_value', - null, - ], - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - ShiftApprovalStatusEnum: { - type: 'object', - properties: { - value: { - type: 'string', - description: 'The approval status of the shift', - enum: ['pending', 'approved', 'rejected', 'unmapped_value', null], - example: 'approved', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - example: 'Approved', - nullable: true, - }, - }, - }, - ShiftBreak: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'The unique identifier of the break', - example: 'break_123456789', - nullable: true, - }, - start_time: { - type: 'string', - description: 'The start time of the break', - example: '2024-03-20T12:00:00Z', - format: 'date-time', - nullable: true, - }, - end_time: { - type: 'string', - description: 'The end time of the break', - example: '2024-03-20T13:00:00Z', - format: 'date-time', - nullable: true, - }, - duration: { - type: 'string', - description: 'The duration of the break in ISO 8601 duration format', - example: 'PT1H', - nullable: true, - }, - is_paid: { - description: 'Whether the break is paid', - example: true, - oneOf: [ - { - type: 'boolean', - }, - { - type: 'string', - enum: ['true', 'false'], - }, - ], - nullable: true, - }, - created_at: { - type: 'string', - description: 'The date and time the break was created', - example: '2024-03-20T10:00:00Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'The date and time the break was last updated', - example: '2024-03-20T10:00:00Z', - format: 'date-time', - nullable: true, - }, - }, - }, - ShiftStatusEnum: { - type: 'object', - properties: { - value: { - type: 'string', - description: 'The status of the shift', - enum: ['draft', 'published', 'confirmed', 'cancelled', 'unmapped_value', null], - example: 'confirmed', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - example: 'Confirmed', - nullable: true, - }, - }, - }, - Task: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - employee_id: { - type: 'string', - description: 'The employee ID associated with this task', - example: 'cx280928937', - nullable: true, - }, - name: { - type: 'string', - description: 'The name of the task', - example: 'Complete onboarding documents', - nullable: true, - }, - description: { - type: 'string', - description: 'The description of the task', - example: 'Please complete all required onboarding documents in the employee portal', - nullable: true, - }, - type: { - description: 'The type of the task', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/TaskTypeEnum', - }, - ], - }, - status: { - description: 'The status of the task', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/TaskStatusEnum', - }, - ], - }, - due_date: { - type: 'string', - description: 'The due date of the task', - example: '2024-03-20T23:59:59.000Z', - format: 'date-time', - nullable: true, - }, - completion_date: { - type: 'string', - description: 'The completion date of the task', - example: '2024-03-19T15:30:00.000Z', - format: 'date-time', - nullable: true, - }, - assigned_by_employee_id: { - type: 'string', - description: 'The ID of the employee who assigned this task', - example: 'cx280928938', - nullable: true, - }, - assigned_by_employee_name: { - type: 'string', - description: 'The name of the employee who assigned this task', - example: 'John Smith', - nullable: true, - }, - link_to_task: { - type: 'string', - description: 'Link to the task in the provider system', - example: 'https://provider.com/tasks/123', - nullable: true, - }, - extracted_links: { - description: 'List of extracted links from the task', - example: ['https://provider.com/docs/1', 'https://provider.com/forms/2'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - next_task_id: { - type: 'string', - description: 'ID of the next task in sequence', - example: 'cx280928939', - nullable: true, - }, - parent_process_name: { - type: 'string', - description: 'Name of the parent process of this task', - example: 'Onboarding Tasks', - nullable: true, - }, - comments: { - description: 'The comments associated with this task', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/TaskCommentApiModel', - }, - }, - attachments: { - description: 'The documents attached to this task', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/File', - }, - }, - created_at: { - type: 'string', - description: 'The creation date of this task', - example: '2024-03-15T10:00:00.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'The last updated date of this task', - example: '2024-03-19T15:30:00.000Z', - format: 'date-time', - nullable: true, - }, - }, - }, - TaskCommentApiModel: { - type: 'object', - properties: { - author_employee_id: { - type: 'string', - description: 'The Employee ID of the author of the comment', - nullable: true, - }, - comment: { - type: 'string', - description: 'The text of the comment', - example: 'Approved based on in-person assessment', - nullable: true, - }, - created_at: { - type: 'string', - description: 'The creation date of this comment', - example: '2024-03-15T10:00:00.000Z', - format: 'date-time', - nullable: true, - }, - }, - }, - TaskResult: { - type: 'object', - properties: { - data: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/Task', - }, - ], - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - }, - TasksPaginated: { - type: 'object', - properties: { - next: { - type: 'string', - nullable: true, - }, - data: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/Task', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - }, - TaskStatusEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'open', - 'in_progress', - 'blocked', - 'completed', - 'cancelled', - 'unmapped_value', - null, - ], - description: - 'The unified value for the status of the task. If the provider does not specify this status, the value will be set to UnmappedValue', - example: 'open', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - TaskTypeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: ['action', 'review', 'acknowledgment', 'edit', 'approve', 'unmapped_value', null], - description: - 'The unified value for the type of the task. If the provider does not specify this type, the value will be set to UnmappedValue', - example: 'action', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - TeamTypeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: ['team', 'unmapped_value', null], - example: 'team', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - TimeEntries: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - employee_id: { - type: 'string', - description: 'The employee ID associated with this time entry', - example: '1687-3', - nullable: true, - }, - remote_employee_id: { - type: 'string', - description: - "Provider's unique identifier of the employee associated with this time entry", - example: 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - nullable: true, - }, - start_time: { - type: 'string', - description: 'The start time of the time entry', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - end_time: { - type: 'string', - description: 'The end time of the time entry', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - hours_worked: { - type: 'number', - description: 'The hours worked in the time entry', - example: 8, - nullable: true, - }, - break_duration: { - type: 'number', - description: 'The duration of the break taken during time entry in hours', - example: 0.5, - nullable: true, - }, - status: { - description: 'The status of the time entry', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/TimeEntryStatusEnum', - }, - ], - }, - labor_type: { - description: 'The labor type associated with this time entry', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/LaborTypeApiModel', - }, - ], - }, - location: { - description: 'The location of the time entry', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/Reference', - }, - ], - }, - created_at: { - type: 'string', - description: 'The created_at date', - example: '2023-02-23T00:00:00.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'The updated_at date', - example: '2024-02-23T00:00:00.000Z', - format: 'date-time', - nullable: true, - }, - }, - }, - TimeEntriesPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/TimeEntries', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - TimeEntriesResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/TimeEntries', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - TimeEntryStatusEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: ['approved', 'unmapped_value', null], - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - TimeOff: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - employee_id: { - type: 'string', - description: 'The employee ID', - example: '1687-3', - nullable: true, - }, - remote_employee_id: { - type: 'string', - description: "Provider's unique identifier of the employee", - example: 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - nullable: true, - }, - approver_id: { - type: 'string', - description: 'The approver ID', - example: '1687-4', - nullable: true, - }, - remote_approver_id: { - type: 'string', - description: "Provider's unique identifier of the approver", - example: 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - nullable: true, - }, - status: { - description: 'The status of the time off request', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/TimeOffStatusEnum', - }, - ], - }, - type: { - description: 'The type of the time off request', - deprecated: true, - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/TimeOffTypeEnum', - }, - ], - }, - start_date: { - type: 'string', - description: - 'The start date of the time off request (ISO8601 date-time without timezone)', - example: '2021-01-01T01:01:01.000', - format: 'datetime-local', - nullable: true, - }, - end_date: { - type: 'string', - description: - 'Inclusive end date of the time off request (ISO8601 date-time without timezone). The time off includes this day', - example: '2021-01-01T01:01:01.000', - format: 'datetime-local', - nullable: true, - }, - start_half_day: { - description: - 'True if the start of the time off request begins half way through the day', - example: true, - oneOf: [ - { - type: 'boolean', - }, - { - type: 'string', - enum: ['true', 'false'], - }, - ], - nullable: true, - }, - end_half_day: { - description: 'True if the end of the time off request ends half way through the day', - example: true, - oneOf: [ - { - type: 'boolean', - }, - { - type: 'string', - enum: ['true', 'false'], - }, - ], - nullable: true, - }, - duration: { - type: 'string', - description: 'The duration of the time off request', - example: 'P3Y6M4DT12H30M5S', - format: 'duration', - nullable: true, - }, - time_off_policy_id: { - type: 'string', - description: 'The time off policy id associated with this time off request', - example: 'cx280928933', - nullable: true, - }, - remote_time_off_policy_id: { - type: 'string', - description: - "Provider's unique identifier of the time off policy id associated with this time off request", - example: 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - nullable: true, - }, - reason: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/Reason', - }, - ], - }, - created_at: { - type: 'string', - description: 'Timestamp when the time off request was created', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'Timestamp when the time off request was last updated', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - policy: { - description: 'The time off policy associated with Time Off', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/TimeOffPolicies', - }, - ], - }, - comment: { - type: 'string', - description: - 'Allows users to provide additional context or notes for their time off request', - example: 'Taking a day off for personal reasons', - nullable: true, - }, - }, - }, - TimeOffBalanceResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/TimeOffBalances', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - TimeOffBalances: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - employee_id: { - type: 'string', - description: 'The employee id associated with this balance', - example: 'cx280928937', - nullable: true, - }, - remote_employee_id: { - type: 'string', - description: - "Provider's unique identifier of the employee associated with this balance", - example: 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - nullable: true, - }, - policy_id: { - type: 'string', - description: 'The time off policy id associated with this balance', - example: 'cx280928937', - nullable: true, - }, - remote_policy_id: { - type: 'string', - description: - "Provider's unique identifier of the time off policy id associated with this balance", - example: 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - nullable: true, - }, - policy: { - description: 'The time off policy associated with this balance', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/TimeOffPolicies', - }, - ], - }, - current_balance: { - type: 'number', - description: - 'The current numeric balance for the associated employee and time off policy', - example: 8, - nullable: true, - }, - initial_balance: { - type: 'number', - description: - 'The initial numeric balance for the associated employee and time off policy as of the balance start date', - example: 8, - nullable: true, - }, - balance_unit: { - description: 'The duration unit of the current balance', - example: 'hours', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/TimeOffBalanceUnitEnum', - }, - ], - }, - balance_start_date: { - type: 'string', - description: 'The date of when the initial balance quantity was set', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - balance_expiry_date: { - type: 'string', - description: 'The date of when the current balance expires', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - is_unlimited: { - description: 'Indicates if this time off balance represents unlimited leave', - example: true, - oneOf: [ - { - type: 'boolean', - }, - { - type: 'string', - enum: ['true', 'false'], - }, - ], - nullable: true, - }, - updated_at: { - type: 'string', - description: 'The updated_at date of this time off balance', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - }, - }, - TimeOffBalancesPaginated: { - type: 'object', - properties: { - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/TimeOffBalances', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - TimeOffBalanceUnitEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'minutes', - 'hours', - 'days', - 'weeks', - 'months', - 'years', - 'unknown', - 'unmapped_value', - null, - ], - description: - 'The unified value for the duration unit. If the provider does not specify this unit, the value will be set to unknown', - example: 'hours', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - TimeOffPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/TimeOff', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - TimeOffPolicies: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - description: 'The name of this policy', - example: 'Holidays', - nullable: true, - }, - description: { - type: 'string', - description: 'The description of this policy', - example: 'Usable for regional and national holidays of employees.', - nullable: true, - }, - type: { - description: 'The type of this policy', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/TimeOffPolicyTypeEnum', - }, - ], - }, - duration_unit: { - description: 'The duration unit of the current policy', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/TimeOffBalanceUnitEnum', - }, - ], - }, - reasons: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/Reason', - }, - }, - created_at: { - type: 'string', - description: 'The created_at date of this policy', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'The updated_at date of this policy', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - }, - }, - TimeOffPoliciesPaginated: { - type: 'object', - properties: { - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/TimeOffPolicies', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - TimeOffPolicyResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/TimeOffPolicies', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - TimeOffPolicyTypeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'sick', - 'unmapped_value', - 'vacation', - 'long_term_disability', - 'short_term_disability', - 'absent', - 'comp_time', - 'training', - 'annual_leave', - 'leave_of_absence', - 'break', - 'child_care_leave', - 'maternity_leave', - 'jury_duty', - 'sabbatical', - 'accident', - 'paid', - 'unpaid', - 'holiday', - 'personal', - 'in_lieu', - 'bereavement', - 'other', - null, - ], - description: - 'The unified value for the type of the time off policy. If the provider does not specify this unit, the value will be set to unmapped_value', - example: 'holiday', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - TimeOffResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/TimeOff', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - TimeOffStatusEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'approved', - 'cancelled', - 'rejected', - 'pending', - 'deleted', - 'draft', - 'unmapped_value', - null, - ], - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - TimeOffTypeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'sick', - 'unmapped_value', - 'vacation', - 'long_term_disability', - 'short_term_disability', - 'absent', - 'comp_time', - 'training', - 'annual_leave', - 'leave_of_absence', - 'break', - 'child_care_leave', - 'maternity_leave', - 'jury_duty', - 'sabbatical', - 'accident', - 'paid', - 'unpaid', - 'holiday', - 'personal', - 'in_lieu', - 'bereavement', - 'other', - null, - ], - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - TooManyRequestsResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 429, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Too many requests', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - TypeApiModel: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - label: { - type: 'string', - description: 'The label of the employment type', - example: 'Permanent', - nullable: true, - }, - type: { - description: 'The type of employment (e.g., contractor, permanent)', - example: 'permanent', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/TypeEnum', - }, - ], - }, - }, - }, - TypeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'contractor', - 'intern', - 'permanent', - 'apprentice', - 'freelance', - 'terminated', - 'temporary', - 'seasonal', - 'volunteer', - 'probation', - 'internal', - 'external', - 'expatriate', - 'employer_of_record', - 'casual', - 'Programme', - 'unmapped_value', - null, - ], - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - UnauthorizedResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 401, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Unauthorized', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - UnifiedError: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 400, - nullable: true, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Bad Request', - nullable: true, - }, - headers: { - type: 'object', - description: 'Response headers', - example: { - 'content-type': 'application/json', - 'x-request-id': '5678c28b211dace4e0a0f9171e6b88c5', - }, - nullable: true, - }, - }, - }, - UnifiedWarningApiModel: { - type: 'object', - properties: { - message: { - type: 'string', - example: 'The provided field type is not supported in the current model.', - nullable: true, - }, - }, - }, - UnprocessableEntityResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 422, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Unprocessable Entity', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - UpdateResult: { - type: 'object', - properties: { - statusCode: { - type: 'number', - example: 200, - }, - message: { - type: 'string', - example: 'Record updated successfully.', - }, - timestamp: { - type: 'string', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - UpdateTaskRequestDto: { - type: 'object', - properties: { - comment: { - type: 'string', - description: 'Comment or note about the task update', - example: 'All required documents have been submitted', - nullable: true, - }, - status: { - default: 'completed', - description: 'The status to apply to this Task', - example: 'blocked', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/TaskStatusEnum', - }, - ], - }, - }, - }, - WorkEligibility: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - type: { - example: 'visa', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/WorkEligibilityTypeEnum', - }, - ], - }, - sub_type: { - type: 'string', - example: 'H1B', - nullable: true, - }, - document: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/File', - }, - ], - }, - valid_from: { - type: 'string', - example: '2021-01-01T00:00:00.000Z', - format: 'date-time', - nullable: true, - }, - valid_to: { - type: 'string', - example: '2021-01-01T00:00:00.000Z', - format: 'date-time', - nullable: true, - }, - issued_by: { - description: 'The country code of the issued by authority', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/CountryCodeEnum', - }, - ], - }, - number: { - type: 'string', - example: '1234567890', - nullable: true, - }, - }, - }, - WorkEligibilityPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/WorkEligibility', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - WorkEligibilityResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/WorkEligibility', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - WorkEligibilityTypeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'visa', - 'passport', - 'driver_license', - 'birth_certificate', - 'other', - 'unmapped_value', - null, - ], - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - WorkTimeApiModel: { - type: 'object', - properties: { - duration: { - type: 'string', - description: 'The work time duration in ISO 8601 duration format', - example: 'P0Y0M0DT8H0M0S', - format: 'duration', - nullable: true, - }, - period: { - description: 'The period of the work time', - example: 'month', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/WorkTimeUnitEnum', - }, - ], - }, - }, - }, - WorkTimeUnitEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: ['day', 'week', 'month', 'year', 'unmapped_value', null], - description: 'The unified value for the period.', - example: 'month', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - WriteResultApiModel: { - type: 'object', - properties: { - statusCode: { - type: 'number', - example: 201, - nullable: true, - }, - message: { - type: 'string', - example: 'Employee created successfully', - nullable: true, - }, - timestamp: { - type: 'string', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - provider_errors: { - example: [ - { - status: 400, - url: 'https://api.someprovider.com/v1/endpoint', - raw: { - error: 'Bad Request', - message: 'The supplied data is invalid', - }, - headers: { - date: 'Tue, 02 Apr 2024 13:52:01 GMT', - 'content-type': 'application/json; charset=utf-8', - 'transfer-encoding': 'chunked', - connection: 'close', - }, - }, - ], - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/ProviderErrorApiModel', - }, - }, - unified_warnings: { - example: [ - { - message: 'The provided field type is not supported in the current model.', - }, - ], - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/UnifiedWarningApiModel', - }, - }, - }, - }, - }, - }, -}; diff --git a/src/openapi/generated/iam.ts b/src/openapi/generated/iam.ts deleted file mode 100644 index ef0563e6..00000000 --- a/src/openapi/generated/iam.ts +++ /dev/null @@ -1,5235 +0,0 @@ -// Generated OpenAPI specification for iam -// DO NOT EDIT THIS FILE DIRECTLY -export const iamSpec = { - openapi: '3.1.0', - paths: { - '/unified/iam/users': { - get: { - operationId: 'iam_list_users', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,first_name,last_name,name,primary_email_address,username,roles,groups,status,avatar,is_bot_user,last_active_at,last_login_at,created_at,updated_at,multi_factor_enabled,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - { - name: 'expand', - required: false, - in: 'query', - description: 'The comma separated list of fields that will be expanded in the response', - schema: { - nullable: true, - example: 'roles,groups', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of users was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/IamUsersPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Users', - tags: ['Users'], - 'x-speakeasy-group': 'iam', - 'x-speakeasy-name-override': 'list_users', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/iam/users/{id}': { - get: { - operationId: 'iam_get_user', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,first_name,last_name,name,primary_email_address,username,roles,groups,status,avatar,is_bot_user,last_active_at,last_login_at,created_at,updated_at,multi_factor_enabled,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'expand', - required: false, - in: 'query', - description: 'The comma separated list of fields that will be expanded in the response', - schema: { - nullable: true, - example: 'roles,groups', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The user with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/IamUserResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get User', - tags: ['Users'], - 'x-speakeasy-group': 'iam', - 'x-speakeasy-name-override': 'get_user', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - patch: { - operationId: 'iam_update_user', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/IamUpdateUserRequestDto', - }, - }, - }, - }, - responses: { - '200': { - description: 'Record updated successfully.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UpdateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Update User', - tags: ['Users'], - 'x-speakeasy-group': 'iam', - 'x-speakeasy-name-override': 'update_user', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - delete: { - operationId: 'iam_delete_user', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The user was deleted successfully.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/DeleteResult', - }, - }, - }, - }, - '204': { - description: 'The user was deleted successfully but no content was returned.', - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Delete User', - tags: ['Users'], - 'x-speakeasy-group': 'iam', - 'x-speakeasy-name-override': 'delete_user', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/iam/roles': { - get: { - operationId: 'iam_list_roles', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,type,policies,description,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - { - name: 'expand', - required: false, - in: 'query', - description: 'The comma separated list of fields that will be expanded in the response', - schema: { - nullable: true, - example: 'policies', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of roles was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/IamRolesPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Roles', - tags: ['Roles'], - 'x-speakeasy-group': 'iam', - 'x-speakeasy-name-override': 'list_roles', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/iam/roles/{id}': { - get: { - operationId: 'iam_get_role', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,type,policies,description,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'expand', - required: false, - in: 'query', - description: 'The comma separated list of fields that will be expanded in the response', - schema: { - nullable: true, - example: 'policies', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The role with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/IamRoleResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Role', - tags: ['Roles'], - 'x-speakeasy-group': 'iam', - 'x-speakeasy-name-override': 'get_role', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/iam/groups': { - get: { - operationId: 'iam_list_groups', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,parent_id,remote_parent_id,name,description,roles,type,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - { - name: 'expand', - required: false, - in: 'query', - description: 'The comma separated list of fields that will be expanded in the response', - schema: { - nullable: true, - example: 'roles', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of groups was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/IamGroupsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Groups', - tags: ['Groups'], - 'x-speakeasy-group': 'iam', - 'x-speakeasy-name-override': 'list_groups', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/iam/groups/{id}': { - get: { - operationId: 'iam_get_group', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,parent_id,remote_parent_id,name,description,roles,type,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'expand', - required: false, - in: 'query', - description: 'The comma separated list of fields that will be expanded in the response', - schema: { - nullable: true, - example: 'roles', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The group with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/IamGroupResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Group', - tags: ['Groups'], - 'x-speakeasy-group': 'iam', - 'x-speakeasy-name-override': 'get_group', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/iam/policies': { - get: { - operationId: 'iam_list_policies', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,permissions,description,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - { - name: 'expand', - required: false, - in: 'query', - description: 'The comma separated list of fields that will be expanded in the response', - schema: { - nullable: true, - example: 'permissions', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of policies was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/IamPoliciesPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Policies', - tags: ['Policies'], - 'x-speakeasy-group': 'iam', - 'x-speakeasy-name-override': 'list_policies', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/iam/policies/{id}': { - get: { - operationId: 'iam_get_policy', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,permissions,description,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'expand', - required: false, - in: 'query', - description: 'The comma separated list of fields that will be expanded in the response', - schema: { - nullable: true, - example: 'permissions', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The policy with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/IamPolicyResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Policy', - tags: ['Policies'], - 'x-speakeasy-group': 'iam', - 'x-speakeasy-name-override': 'get_policy', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - }, - info: { - title: 'IAM', - description: 'The documentation for the StackOne Unified API - IAM', - version: '1.0.0', - contact: {}, - }, - tags: [ - { - name: 'Users', - description: 'People or accounts with access to the system.', - }, - { - name: 'Roles', - description: 'Roles assigned to users for access control.', - }, - { - name: 'Groups', - description: 'Groups for organizing users.', - }, - { - name: 'Policies', - description: 'Security and access policies.', - }, - { - name: 'Permissions', - description: 'Specific permissions granted to users or roles.', - }, - { - name: 'Resources', - description: 'Resources that can be accessed or managed.', - }, - ], - servers: [ - { - url: 'https://api.stackone.com', - }, - ], - components: { - securitySchemes: { - basic: { - type: 'http', - scheme: 'basic', - }, - }, - schemas: { - BadGatewayResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 502, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Bad Gateway', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - BadRequestResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 400, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Bad Request', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - data: { - description: 'Error details', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/UnifiedError', - }, - ], - }, - provider_errors: { - description: 'List of provider-specific errors', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/ProviderError', - }, - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - ConflictResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 409, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Conflict', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - Content: { - type: 'object', - properties: { - url: { - type: 'string', - description: 'URL where the file content is located', - example: 'https://example.com/file.pdf', - nullable: true, - }, - unified_url: { - type: 'string', - description: 'Unified download URL for retrieving file content.', - example: - 'https://api.stackone.com/unified/hris/employees/12345/documents/67890/download', - nullable: true, - }, - file_format: { - description: 'The file format of the file', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/FileFormatEnum', - }, - ], - }, - }, - }, - DeleteResult: { - type: 'object', - properties: { - statusCode: { - type: 'number', - example: 204, - }, - message: { - type: 'string', - example: 'Record deleted successfully.', - }, - timestamp: { - type: 'string', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - File: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - description: 'The name of the file', - example: 'My Document', - nullable: true, - }, - category: { - description: 'The category of the file', - example: 'templates, forms, backups, etc.', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/FileCategoryEnumApiModel', - }, - ], - }, - contents: { - description: - 'The content of the file. Deprecated, use `url` and `file_format` one level up instead', - deprecated: true, - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/Content', - }, - }, - category_id: { - type: 'string', - description: 'The categoryId of the documents', - example: '6530', - nullable: true, - }, - created_at: { - type: 'string', - description: 'The creation date of the file', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'The update date of the file', - example: '2021-01-02T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - remote_url: { - type: 'string', - description: 'URL where the file content is located', - example: 'https://example.com/file.pdf', - nullable: true, - }, - file_format: { - description: 'The file format of the file', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/FileFormatEnum', - }, - ], - }, - }, - }, - FileCategoryEnumApiModel: { - type: 'object', - properties: { - value: { - type: 'string', - description: 'The category of the file', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - FileFormatEnum: { - type: 'object', - properties: { - value: { - type: 'string', - description: 'The file format of the file, expressed as a file extension', - enum: [ - 'unmapped_value', - 'ez', - 'aw', - 'atom', - 'atomcat', - 'atomdeleted', - 'atomsvc', - 'dwd', - 'held', - 'rsat', - 'bdoc', - 'xcs', - 'ccxml', - 'cdfx', - 'cdmia', - 'cdmic', - 'cdmid', - 'cdmio', - 'cdmiq', - 'cu', - 'mpd', - 'davmount', - 'dbk', - 'dssc', - 'xdssc', - 'es', - 'ecma', - 'emma', - 'emotionml', - 'epub', - 'exi', - 'exp', - 'fdt', - 'pfr', - 'geojson', - 'gml', - 'gpx', - 'gxf', - 'gz', - 'hjson', - 'stk', - 'ink', - 'inkml', - 'ipfix', - 'its', - 'jar', - 'war', - 'ear', - 'ser', - 'class', - 'js', - 'mjs', - 'json', - 'map', - 'json5', - 'jsonml', - 'jsonld', - 'lgr', - 'lostxml', - 'hqx', - 'cpt', - 'mads', - 'webmanifest', - 'mrc', - 'mrcx', - 'ma', - 'nb', - 'mb', - 'mathml', - 'mbox', - 'mscml', - 'metalink', - 'meta4', - 'mets', - 'maei', - 'musd', - 'mods', - 'm21', - 'mp21', - 'mp4s', - 'm4p', - 'doc', - 'dot', - 'mxf', - 'nq', - 'nt', - 'cjs', - 'bin', - 'dms', - 'lrf', - 'mar', - 'so', - 'dist', - 'distz', - 'pkg', - 'bpk', - 'dump', - 'elc', - 'deploy', - 'exe', - 'dll', - 'deb', - 'dmg', - 'iso', - 'img', - 'msi', - 'msp', - 'msm', - 'buffer', - 'oda', - 'opf', - 'ogx', - 'omdoc', - 'onetoc', - 'onetoc2', - 'onetmp', - 'onepkg', - 'oxps', - 'relo', - 'xer', - 'pdf', - 'pgp', - 'asc', - 'sig', - 'prf', - 'p10', - 'p7m', - 'p7c', - 'p7s', - 'p8', - 'ac', - 'cer', - 'crl', - 'pkipath', - 'pki', - 'pls', - 'ai', - 'eps', - 'ps', - 'provx', - 'pskcxml', - 'raml', - 'rdf', - 'owl', - 'rif', - 'rnc', - 'rl', - 'rld', - 'rs', - 'rapd', - 'sls', - 'rusd', - 'gbr', - 'mft', - 'roa', - 'rsd', - 'rss', - 'rtf', - 'sbml', - 'scq', - 'scs', - 'spq', - 'spp', - 'sdp', - 'senmlx', - 'sensmlx', - 'setpay', - 'setreg', - 'shf', - 'siv', - 'sieve', - 'smi', - 'smil', - 'rq', - 'srx', - 'gram', - 'grxml', - 'sru', - 'ssdl', - 'ssml', - 'swidtag', - 'tei', - 'teicorpus', - 'tfi', - 'tsd', - 'toml', - 'trig', - 'ttml', - 'ubj', - 'rsheet', - 'td', - 'vxml', - 'wasm', - 'wgt', - 'hlp', - 'wsdl', - 'wspolicy', - 'xaml', - 'xav', - 'xca', - 'xdf', - 'xel', - 'xns', - 'xenc', - 'xhtml', - 'xht', - 'xlf', - 'xml', - 'xsl', - 'xsd', - 'rng', - 'dtd', - 'xop', - 'xpl', - '*xsl', - 'xslt', - 'xspf', - 'mxml', - 'xhvml', - 'xvml', - 'xvm', - 'yang', - 'yin', - 'zip', - '*3gpp', - 'adp', - 'amr', - 'au', - 'snd', - 'mid', - 'midi', - 'kar', - 'rmi', - 'mxmf', - '*mp3', - 'm4a', - 'mp4a', - 'mpga', - 'mp2', - 'mp2a', - 'mp3', - 'm2a', - 'm3a', - 'oga', - 'ogg', - 'spx', - 'opus', - 's3m', - 'sil', - 'wav', - '*wav', - 'weba', - 'xm', - 'ttc', - 'otf', - 'ttf', - 'woff', - 'woff2', - 'exr', - 'apng', - 'avif', - 'bmp', - 'cgm', - 'drle', - 'emf', - 'fits', - 'g3', - 'gif', - 'heic', - 'heics', - 'heif', - 'heifs', - 'hej2', - 'hsj2', - 'ief', - 'jls', - 'jp2', - 'jpg2', - 'jpeg', - 'jpg', - 'jpe', - 'jph', - 'jhc', - 'jpm', - 'jpx', - 'jpf', - 'jxr', - 'jxra', - 'jxrs', - 'jxs', - 'jxsc', - 'jxsi', - 'jxss', - 'ktx', - 'ktx2', - 'png', - 'sgi', - 'svg', - 'svgz', - 't38', - 'tif', - 'tiff', - 'tfx', - 'webp', - 'wmf', - 'disposition-notification', - 'u8msg', - 'u8dsn', - 'u8mdn', - 'u8hdr', - 'eml', - 'mime', - '3mf', - 'gltf', - 'glb', - 'igs', - 'iges', - 'msh', - 'mesh', - 'silo', - 'mtl', - 'obj', - 'stpx', - 'stpz', - 'stpxz', - 'stl', - 'wrl', - 'vrml', - '*x3db', - 'x3dbz', - 'x3db', - '*x3dv', - 'x3dvz', - 'x3d', - 'x3dz', - 'x3dv', - 'appcache', - 'manifest', - 'ics', - 'ifb', - 'coffee', - 'litcoffee', - 'css', - 'csv', - 'html', - 'htm', - 'shtml', - 'jade', - 'jsx', - 'less', - 'markdown', - 'md', - 'mml', - 'mdx', - 'n3', - 'txt', - 'text', - 'conf', - 'def', - 'list', - 'log', - 'in', - 'ini', - 'rtx', - '*rtf', - 'sgml', - 'sgm', - 'shex', - 'slim', - 'slm', - 'spdx', - 'stylus', - 'styl', - 'tsv', - 't', - 'tr', - 'roff', - 'man', - 'me', - 'ms', - 'ttl', - 'uri', - 'uris', - 'urls', - 'vcard', - 'vtt', - '*xml', - 'yaml', - 'yml', - '3gp', - '3gpp', - '3g2', - 'h261', - 'h263', - 'h264', - 'm4s', - 'jpgv', - '*jpm', - 'jpgm', - 'mj2', - 'mjp2', - 'ts', - 'mp4', - 'mp4v', - 'mpg4', - 'mpeg', - 'mpg', - 'mpe', - 'm1v', - 'm2v', - 'ogv', - 'qt', - 'mov', - 'webm', - 'cww', - '1km', - 'plb', - 'psb', - 'pvb', - 'tcap', - 'pwn', - 'aso', - 'imp', - 'acu', - 'atc', - 'acutc', - 'air', - 'fcdt', - 'fxp', - 'fxpl', - 'xdp', - 'xfdf', - 'ahead', - 'azf', - 'azs', - 'azw', - 'acc', - 'ami', - 'apk', - 'cii', - 'fti', - 'atx', - 'mpkg', - 'key', - 'm3u8', - 'numbers', - 'pages', - 'pkpass', - 'swi', - 'iota', - 'aep', - 'bmml', - 'mpm', - 'bmi', - 'rep', - 'cdxml', - 'mmd', - 'cdy', - 'csl', - 'cla', - 'rp9', - 'c4g', - 'c4d', - 'c4f', - 'c4p', - 'c4u', - 'c11amc', - 'c11amz', - 'csp', - 'cdbcmsg', - 'cmc', - 'clkx', - 'clkk', - 'clkp', - 'clkt', - 'clkw', - 'wbs', - 'pml', - 'ppd', - 'car', - 'pcurl', - 'dart', - 'rdz', - 'dbf', - 'uvf', - 'uvvf', - 'uvd', - 'uvvd', - 'uvt', - 'uvvt', - 'uvx', - 'uvvx', - 'uvz', - 'uvvz', - 'fe_launch', - 'dna', - 'mlp', - 'mle', - 'dpg', - 'dfac', - 'kpxx', - 'ait', - 'svc', - 'geo', - 'mag', - 'nml', - 'esf', - 'msf', - 'qam', - 'slt', - 'ssf', - 'es3', - 'et3', - 'ez2', - 'ez3', - 'fdf', - 'mseed', - 'seed', - 'dataless', - 'gph', - 'ftc', - 'fm', - 'frame', - 'maker', - 'book', - 'fnc', - 'ltf', - 'fsc', - 'oas', - 'oa2', - 'oa3', - 'fg5', - 'bh2', - 'ddd', - 'xdw', - 'xbd', - 'fzs', - 'txd', - 'ggb', - 'ggt', - 'gex', - 'gre', - 'gxt', - 'g2w', - 'g3w', - 'gmx', - 'gdoc', - 'gslides', - 'gsheet', - 'kml', - 'kmz', - 'gqf', - 'gqs', - 'gac', - 'ghf', - 'gim', - 'grv', - 'gtm', - 'tpl', - 'vcg', - 'hal', - 'zmm', - 'hbci', - 'les', - 'hpgl', - 'hpid', - 'hps', - 'jlt', - 'pcl', - 'pclxl', - 'sfd-hdstx', - 'mpy', - 'afp', - 'listafp', - 'list3820', - 'irm', - 'sc', - 'icc', - 'icm', - 'igl', - 'ivp', - 'ivu', - 'igm', - 'xpw', - 'xpx', - 'i2g', - 'qbo', - 'qfx', - 'rcprofile', - 'irp', - 'xpr', - 'fcs', - 'jam', - 'rms', - 'jisp', - 'joda', - 'ktz', - 'ktr', - 'karbon', - 'chrt', - 'kfo', - 'flw', - 'kon', - 'kpr', - 'kpt', - 'ksp', - 'kwd', - 'kwt', - 'htke', - 'kia', - 'kne', - 'knp', - 'skp', - 'skd', - 'skt', - 'skm', - 'sse', - 'lasxml', - 'lbd', - 'lbe', - 'apr', - 'pre', - 'nsf', - 'org', - 'scm', - 'lwp', - 'portpkg', - 'mvt', - 'mcd', - 'mc1', - 'cdkey', - 'mwf', - 'mfm', - 'flo', - 'igx', - 'mif', - 'daf', - 'dis', - 'mbk', - 'mqy', - 'msl', - 'plc', - 'txf', - 'mpn', - 'mpc', - 'xul', - 'cil', - 'cab', - 'xls', - 'xlm', - 'xla', - 'xlc', - 'xlt', - 'xlw', - 'xlam', - 'xlsb', - 'xlsm', - 'xltm', - 'eot', - 'chm', - 'ims', - 'lrm', - 'thmx', - 'msg', - 'cat', - '*stl', - 'ppt', - 'pps', - 'pot', - 'ppam', - 'pptm', - 'sldm', - 'ppsm', - 'potm', - 'mpp', - 'mpt', - 'docm', - 'dotm', - 'wps', - 'wks', - 'wcm', - 'wdb', - 'wpl', - 'xps', - 'mseq', - 'mus', - 'msty', - 'taglet', - 'nlu', - 'ntf', - 'nitf', - 'nnd', - 'nns', - 'nnw', - '*ac', - 'ngdat', - 'n-gage', - 'rpst', - 'rpss', - 'edm', - 'edx', - 'ext', - 'odc', - 'otc', - 'odb', - 'odf', - 'odft', - 'odg', - 'otg', - 'odi', - 'oti', - 'odp', - 'otp', - 'ods', - 'ots', - 'odt', - 'odm', - 'ott', - 'oth', - 'xo', - 'dd2', - 'obgx', - 'oxt', - 'osm', - 'pptx', - 'sldx', - 'ppsx', - 'potx', - 'xlsx', - 'xltx', - 'docx', - 'dotx', - 'mgp', - 'dp', - 'esa', - 'pdb', - 'pqa', - 'oprc', - 'paw', - 'str', - 'ei6', - 'efif', - 'wg', - 'plf', - 'pbd', - 'box', - 'mgz', - 'qps', - 'ptid', - 'qxd', - 'qxt', - 'qwd', - 'qwt', - 'qxl', - 'qxb', - 'rar', - 'bed', - 'mxl', - 'musicxml', - 'cryptonote', - 'cod', - 'rm', - 'rmvb', - 'link66', - 'st', - 'see', - 'sema', - 'semd', - 'semf', - 'ifm', - 'itp', - 'iif', - 'ipk', - 'twd', - 'twds', - 'mmf', - 'teacher', - 'fo', - 'sdkm', - 'sdkd', - 'dxp', - 'sfs', - 'sdc', - 'sda', - 'sdd', - 'smf', - 'sdw', - 'vor', - 'sgl', - 'smzip', - 'sm', - 'wadl', - 'sxc', - 'stc', - 'sxd', - 'std', - 'sxi', - 'sti', - 'sxm', - 'sxw', - 'sxg', - 'stw', - 'sus', - 'susp', - 'svd', - 'sis', - 'sisx', - 'xsm', - 'bdm', - 'xdm', - 'ddf', - 'tao', - 'pcap', - 'cap', - 'dmp', - 'tmo', - 'tpt', - 'mxs', - 'tra', - 'ufd', - 'ufdl', - 'utz', - 'umj', - 'unityweb', - 'uoml', - 'vcx', - 'vsd', - 'vst', - 'vss', - 'vsw', - 'vis', - 'vsf', - 'wbxml', - 'wmlc', - 'wmlsc', - 'wtb', - 'nbp', - 'wpd', - 'wqd', - 'stf', - 'xar', - 'xfdl', - 'hvd', - 'hvs', - 'hvp', - 'osf', - 'osfpvg', - 'saf', - 'spf', - 'cmp', - 'zir', - 'zirz', - 'zaz', - '7z', - 'abw', - 'ace', - '*dmg', - 'arj', - 'aab', - 'x32', - 'u32', - 'vox', - 'aam', - 'aas', - 'bcpio', - '*bdoc', - 'torrent', - 'blb', - 'blorb', - 'bz', - 'bz2', - 'boz', - 'cbr', - 'cba', - 'cbt', - 'cbz', - 'cb7', - 'vcd', - 'cfs', - 'chat', - 'pgn', - 'crx', - 'cco', - 'nsc', - 'cpio', - 'csh', - '*deb', - 'udeb', - 'dgc', - 'dir', - 'dcr', - 'dxr', - 'cst', - 'cct', - 'cxt', - 'w3d', - 'fgd', - 'swa', - 'wad', - 'ncx', - 'dtb', - 'res', - 'dvi', - 'evy', - 'eva', - 'bdf', - 'gsf', - 'psf', - 'pcf', - 'snf', - 'pfa', - 'pfb', - 'pfm', - 'afm', - 'arc', - 'spl', - 'gca', - 'ulx', - 'gnumeric', - 'gramps', - 'gtar', - 'hdf', - 'php', - 'install', - '*iso', - '*key', - '*numbers', - '*pages', - 'jardiff', - 'jnlp', - 'kdbx', - 'latex', - 'luac', - 'lzh', - 'lha', - 'run', - 'mie', - 'prc', - 'mobi', - 'application', - 'lnk', - 'wmd', - 'wmz', - 'xbap', - 'mdb', - 'obd', - 'crd', - 'clp', - '*exe', - '*dll', - 'com', - 'bat', - '*msi', - 'mvb', - 'm13', - 'm14', - '*wmf', - '*wmz', - '*emf', - 'emz', - 'mny', - 'pub', - 'scd', - 'trm', - 'wri', - 'nc', - 'cdf', - 'pac', - 'nzb', - 'pl', - 'pm', - '*prc', - '*pdb', - 'p12', - 'pfx', - 'p7b', - 'spc', - 'p7r', - '*rar', - 'rpm', - 'ris', - 'sea', - 'sh', - 'shar', - 'swf', - 'xap', - 'sql', - 'sit', - 'sitx', - 'srt', - 'sv4cpio', - 'sv4crc', - 't3', - 'gam', - 'tar', - 'tcl', - 'tk', - 'tex', - 'tfm', - 'texinfo', - 'texi', - '*obj', - 'ustar', - 'hdd', - 'ova', - 'ovf', - 'vbox', - 'vbox-extpack', - 'vdi', - 'vhd', - 'vmdk', - 'src', - 'webapp', - 'der', - 'crt', - 'pem', - 'fig', - '*xlf', - 'xpi', - 'xz', - 'z1', - 'z2', - 'z3', - 'z4', - 'z5', - 'z6', - 'z7', - 'z8', - 'uva', - 'uvva', - 'eol', - 'dra', - 'dts', - 'dtshd', - 'lvp', - 'pya', - 'ecelp4800', - 'ecelp7470', - 'ecelp9600', - 'rip', - 'aac', - 'aif', - 'aiff', - 'aifc', - 'caf', - 'flac', - '*m4a', - 'mka', - 'm3u', - 'wax', - 'wma', - 'ram', - 'ra', - 'rmp', - '*ra', - 'cdx', - 'cif', - 'cmdf', - 'cml', - 'csml', - 'xyz', - 'btif', - 'pti', - 'psd', - 'azv', - 'uvi', - 'uvvi', - 'uvg', - 'uvvg', - 'djvu', - 'djv', - '*sub', - 'dwg', - 'dxf', - 'fbs', - 'fpx', - 'fst', - 'mmr', - 'rlc', - 'ico', - 'dds', - 'mdi', - 'wdp', - 'npx', - 'b16', - 'tap', - 'vtf', - 'wbmp', - 'xif', - 'pcx', - '3ds', - 'ras', - 'cmx', - 'fh', - 'fhc', - 'fh4', - 'fh5', - 'fh7', - '*ico', - 'jng', - 'sid', - '*bmp', - '*pcx', - 'pic', - 'pct', - 'pnm', - 'pbm', - 'pgm', - 'ppm', - 'rgb', - 'tga', - 'xbm', - 'xpm', - 'xwd', - 'wsc', - 'dae', - 'dwf', - 'gdl', - 'gtw', - 'mts', - 'ogex', - 'x_b', - 'x_t', - 'vds', - 'usdz', - 'bsp', - 'vtu', - 'dsc', - 'curl', - 'dcurl', - 'mcurl', - 'scurl', - 'sub', - 'fly', - 'flx', - 'gv', - '3dml', - 'spot', - 'jad', - 'wml', - 'wmls', - 's', - 'asm', - 'c', - 'cc', - 'cxx', - 'cpp', - 'h', - 'hh', - 'dic', - 'htc', - 'f', - 'for', - 'f77', - 'f90', - 'hbs', - 'java', - 'lua', - 'mkd', - 'nfo', - 'opml', - '*org', - 'p', - 'pas', - 'pde', - 'sass', - 'scss', - 'etx', - 'sfv', - 'ymp', - 'uu', - 'vcs', - 'vcf', - 'uvh', - 'uvvh', - 'uvm', - 'uvvm', - 'uvp', - 'uvvp', - 'uvs', - 'uvvs', - 'uvv', - 'uvvv', - 'dvb', - 'fvt', - 'mxu', - 'm4u', - 'pyv', - 'uvu', - 'uvvu', - 'viv', - 'f4v', - 'fli', - 'flv', - 'm4v', - 'mkv', - 'mk3d', - 'mks', - 'mng', - 'asf', - 'asx', - 'vob', - 'wm', - 'wmv', - 'wmx', - 'wvx', - 'avi', - 'movie', - 'smv', - 'ice', - 'mht', - null, - ], - example: 'pdf', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - example: 'application/pdf', - nullable: true, - }, - }, - }, - ForbiddenResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 403, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Forbidden resource', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - GroupTypeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'workspace', - 'team', - 'department', - 'group', - 'organization', - 'unmapped_value', - 'cost_center', - null, - ], - example: 'team', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - IamGroup: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - nullable: true, - }, - description: { - type: 'string', - nullable: true, - }, - type: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/GroupTypeEnum', - }, - ], - }, - roles: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/IamRole', - }, - }, - parent_id: { - type: 'string', - description: 'The parent group id for when a group belongs to another group.', - nullable: true, - }, - remote_parent_id: { - type: 'string', - description: - "Provider's unique identifier of the parent group id for when a group belongs to another group.", - example: 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - nullable: true, - }, - created_at: { - type: 'string', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - }, - }, - IamGroupResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/IamGroup', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - IamGroupsPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/IamGroup', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - IamMfaTypeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'sms', - 'email', - 'push', - 'totp', - 'phone_call', - 'question', - 'software_token', - 'hardware_token', - 'web', - 'unknown', - 'unmapped_value', - null, - ], - description: - "The unified value for the type of multi-factor authentication. If the provider does not send back a type but does specify that MFA is set-up for this user, the value will be set to 'unknown'.'", - example: 'totp', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - IamPermission: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - description: 'The name of the permission.', - example: 'read:users', - nullable: true, - }, - type: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/IamPermissionTypeEnum', - }, - ], - }, - resources: { - description: 'The resources that the permission applies to.', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/IamResource', - }, - }, - description: { - type: 'string', - nullable: true, - }, - created_at: { - type: 'string', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - }, - }, - IamPermissionTypeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'read', - 'read_write', - 'approve', - 'delete', - 'use', - 'export', - 'unmapped_value', - null, - ], - description: 'The type of the permission, e.g. read, read_write, delete, etc.', - example: 'read_write', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - IamPoliciesPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/IamPolicy', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - IamPolicy: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - description: 'The name of the policy.', - example: 'Remote Contractor Policy', - nullable: true, - }, - permissions: { - description: 'The set of permissions associated with the policy.', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/IamPermission', - }, - }, - description: { - type: 'string', - nullable: true, - }, - created_at: { - type: 'string', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - }, - }, - IamPolicyResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/IamPolicy', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - IamResource: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - description: 'The name of the resource.', - example: 'Company History Records', - nullable: true, - }, - location: { - type: 'string', - description: 'The location of the resource.', - example: 's3://bucket-name/folder-name', - nullable: true, - }, - type: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/IamResourceTypeEnum', - }, - ], - }, - description: { - type: 'string', - nullable: true, - }, - created_at: { - type: 'string', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - }, - }, - IamResourceTypeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'project', - 'file', - 'folder', - 'product', - 'property', - 'user', - 'unmapped_value', - null, - ], - description: 'The type of the resource, e.g. user, group, permission, etc.', - example: 'file', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - IamRole: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - nullable: true, - }, - description: { - type: 'string', - nullable: true, - }, - type: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/RoleTypeEnum', - }, - ], - }, - policies: { - description: 'The set of policies associated with the role.', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/IamPolicy', - }, - }, - created_at: { - type: 'string', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - }, - }, - IamRoleResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/IamRole', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - IamRolesPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/IamRole', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - IamUpdateUserRequestDto: { - type: 'object', - properties: { - primary_email_address: { - type: 'string', - description: - 'Primary email address of the user. This is generally a work email address.', - example: 'han@stackone.com', - nullable: true, - }, - first_name: { - type: 'string', - example: 'Han', - nullable: true, - }, - last_name: { - type: 'string', - example: 'Solo', - nullable: true, - }, - name: { - type: 'string', - description: "User's name which (can be a full name or display name)", - example: 'Han Solo', - nullable: true, - }, - username: { - type: 'string', - example: 'hansolo1977', - nullable: true, - }, - is_bot_user: { - description: 'Indicates if the user is a bot or service user', - example: true, - oneOf: [ - { - type: 'boolean', - }, - { - type: 'string', - enum: ['true', 'false'], - }, - ], - nullable: true, - }, - status: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/UserStatusEnum', - }, - ], - }, - passthrough: { - type: 'object', - description: 'Value to pass through to the provider', - example: { - other_known_names: 'John Doe', - }, - additionalProperties: true, - nullable: true, - }, - }, - }, - IamUser: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - primary_email_address: { - type: 'string', - description: - 'Primary email address of the user. This is generally a work email address.', - example: 'han@stackone.com', - nullable: true, - }, - first_name: { - type: 'string', - example: 'Han', - nullable: true, - }, - last_name: { - type: 'string', - example: 'Solo', - nullable: true, - }, - name: { - type: 'string', - description: "User's name which (can be a full name or display name)", - example: 'Han Solo', - nullable: true, - }, - username: { - type: 'string', - example: 'hansolo1977', - nullable: true, - }, - is_bot_user: { - description: 'Indicates if the user is a bot or service user', - example: true, - oneOf: [ - { - type: 'boolean', - }, - { - type: 'string', - enum: ['true', 'false'], - }, - ], - nullable: true, - }, - roles: { - description: 'List of roles the user is assigned to', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/IamRole', - }, - }, - groups: { - description: 'List of groups the user is assigned to', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/IamGroup', - }, - }, - status: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/UserStatusEnum', - }, - ], - }, - last_active_at: { - type: 'string', - description: 'The date this user was last active', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - last_login_at: { - type: 'string', - description: 'The date this user last logged in', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - created_at: { - type: 'string', - description: 'The date the user was created', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'The date the user was created', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - multi_factor_enabled: { - description: - 'The list of Multi-Factor Authentication (MFA) types enabled for the user.', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/IamMfaTypeEnum', - }, - }, - avatar: { - description: - "The user's avatar data. This generally contains a URL within this property's 'contents' array.", - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/File', - }, - ], - }, - }, - }, - IamUserResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/IamUser', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - IamUsersPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/IamUser', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - InternalServerErrorResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 500, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Internal server error', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - NotFoundResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 404, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Not Found', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - NotImplementedResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 501, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Not Implemented', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - PreconditionFailedResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 412, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Precondition failed', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - ProviderError: { - type: 'object', - properties: { - status: { - type: 'number', - description: 'HTTP status code of the provider error', - example: 400, - nullable: true, - }, - url: { - type: 'string', - description: 'URL that caused the error', - example: 'https://api.provider.com/v1/resource', - nullable: true, - }, - raw: { - type: 'object', - description: 'Raw error response from the provider', - example: { - message: 'Invalid input parameters', - }, - nullable: true, - }, - headers: { - type: 'object', - description: 'Response headers', - example: { - 'content-type': 'application/json', - 'x-request-id': '5678c28b211dace4e0a0f9171e6b88c5', - }, - nullable: true, - }, - }, - }, - RawResponse: { - type: 'object', - properties: { - method: { - type: 'string', - }, - url: { - type: 'string', - }, - body: { - oneOf: [ - { - type: 'string', - }, - { - type: 'object', - }, - { - type: 'array', - items: { - type: 'integer', - format: 'int32', - minimum: 0, - maximum: 255, - }, - }, - ], - additionalProperties: true, - nullable: true, - }, - response: { - oneOf: [ - { - type: 'object', - additionalProperties: true, - }, - { - type: 'array', - items: {}, - }, - { - type: 'string', - }, - ], - nullable: true, - }, - }, - required: ['method', 'url'], - }, - RequestTimedOutResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 408, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Request timed out', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - RoleTypeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'admin', - 'viewer', - 'editor', - 'basic', - 'guest', - 'unassigned', - 'restricted', - 'unmapped_value', - null, - ], - example: 'admin', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - TooManyRequestsResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 429, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Too many requests', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - UnauthorizedResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 401, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Unauthorized', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - UnifiedError: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 400, - nullable: true, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Bad Request', - nullable: true, - }, - headers: { - type: 'object', - description: 'Response headers', - example: { - 'content-type': 'application/json', - 'x-request-id': '5678c28b211dace4e0a0f9171e6b88c5', - }, - nullable: true, - }, - }, - }, - UnprocessableEntityResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 422, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Unprocessable Entity', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - UpdateResult: { - type: 'object', - properties: { - statusCode: { - type: 'number', - example: 200, - }, - message: { - type: 'string', - example: 'Record updated successfully.', - }, - timestamp: { - type: 'string', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - UserStatusEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: ['enabled', 'disabled', 'pending', 'unmapped_value', null], - description: - 'The status of the user, e.g. whether the user is enabled, has been disabled (eg. by an admin), or is pending (ie: awaiting approval by the user or an admin).', - example: 'enabled', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - }, - }, -}; diff --git a/src/openapi/generated/index.ts b/src/openapi/generated/index.ts deleted file mode 100644 index 936e2829..00000000 --- a/src/openapi/generated/index.ts +++ /dev/null @@ -1,11 +0,0 @@ -export { stackoneSpec } from './stackone'; -export { crmSpec } from './crm'; -export { atsSpec } from './ats'; -export { hrisSpec } from './hris'; -export { documentsSpec } from './documents'; -export { marketingSpec } from './marketing'; -export { ticketingSpec } from './ticketing'; -export { screeningSpec } from './screening'; -export { messagingSpec } from './messaging'; -export { iamSpec } from './iam'; -export { lmsSpec } from './lms'; diff --git a/src/openapi/generated/lms.ts b/src/openapi/generated/lms.ts deleted file mode 100644 index a7c985e8..00000000 --- a/src/openapi/generated/lms.ts +++ /dev/null @@ -1,8673 +0,0 @@ -// Generated OpenAPI specification for lms -// DO NOT EDIT THIS FILE DIRECTLY -export const lmsSpec = { - openapi: '3.1.0', - paths: { - '/unified/lms/courses': { - get: { - description: - 'Retrieve a list of course type learning objects. \n\nThese are collections of content type learning objects that are grouped together for a specific learning purpose.', - operationId: 'lms_list_courses', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,external_reference,content_ids,remote_content_ids,title,description,languages,cover_url,url,active,duration,categories,skills,updated_at,created_at,content,provider,localizations,authors,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'LMS Courses Filter', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - external_reference: { - description: 'Filter to select courses by external_reference', - type: 'string', - nullable: true, - }, - active: { - description: 'Filter to allow filtering of only active courses', - oneOf: [ - { - type: 'boolean', - const: true, - }, - { - type: 'string', - const: 'true', - }, - ], - nullable: true, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of courses was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CoursePaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Courses', - tags: ['Courses'], - 'x-speakeasy-group': 'lms', - 'x-speakeasy-name-override': 'list_courses', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/lms/courses/{id}': { - get: { - description: - 'Retrieve a course type learning object by its identifier. \n\nThese are collections of content type learning objects that are grouped together for a specific learning purpose.', - operationId: 'lms_get_course', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,external_reference,content_ids,remote_content_ids,title,description,languages,cover_url,url,active,duration,categories,skills,updated_at,created_at,content,provider,localizations,authors,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The course with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CourseResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Course', - tags: ['Courses'], - 'x-speakeasy-group': 'lms', - 'x-speakeasy-name-override': 'get_course', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/lms/users/{id}/assignments': { - get: { - description: - 'Retrieve a list of assignment type learning records for a user. \n\nThese are the records linking a user to learning objects. \n\nThey can be pending, in progress, or completed.', - operationId: 'lms_list_user_assignments', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,external_reference,user_id,remote_user_id,course_id,remote_course_id,updated_at,created_at,assigned_at,due_date,status,progress,learning_object_type,learning_object_id,remote_learning_object_id,learning_object_external_reference,certificate_url,result,completed_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'LMS Assignment Filter', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - status: { - description: 'Filter to select assignment by status', - type: 'string', - enum: ['pending', 'in_progress', 'completed', 'unmapped_value', null], - nullable: true, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - { - name: 'user_id', - required: false, - in: 'query', - description: 'The user ID associated with this assignment', - schema: { - nullable: true, - example: 'c28xyrc55866bvuv', - type: 'string', - }, - }, - { - name: 'remote_user_id', - required: false, - in: 'query', - description: "Provider's unique identifier of the user related to the assignment", - schema: { - nullable: true, - example: 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: - 'The assignments related to the employee with the given identifier were retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/AssignmentsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List User Assignments', - tags: ['Users', 'Assignments'], - 'x-speakeasy-group': 'lms', - 'x-speakeasy-name-override': 'list_user_assignments', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - post: { - description: - 'Create an assignment type learning record for a user. \n\nThis is the record linking a user to a learning object. \n\nIt can be pending or in progress.', - operationId: 'lms_create_user_assignment', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/LmsCreateAssignmentRequestDto', - }, - }, - }, - }, - responses: { - '201': { - description: 'The assignment was created successfully.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CreateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Create User Assignment', - tags: ['Users', 'Assignments'], - 'x-speakeasy-group': 'lms', - 'x-speakeasy-name-override': 'create_user_assignment', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/lms/users/{id}/assignments/{subResourceId}': { - get: { - description: - 'Retrieve an assignment type learning record for a user by its identifier. \n\nThis is the record linking a user to a learning object. \n\nIt can be pending, in progress, or completed.', - operationId: 'lms_get_user_assignment', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'subResourceId', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields to return in the response (if empty, all fields are returned)', - schema: { - nullable: true, - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The assignment with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/AssignmentResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get User Assignment', - tags: ['Users', 'Assignments'], - 'x-speakeasy-group': 'lms', - 'x-speakeasy-name-override': 'get_user_assignment', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/lms/content/batch': { - post: { - description: - 'Batch upsert multiple external linking learning objects that redirect users to a provider platform for consumption and progress tracking. \n\n**Note:** Partial updates are not supported. When updating content, you must provide all the same fields that are required when creating content. \n\nSee [here](https://docs.stackone.com/integration-guides/lms/external-content-providers/introduction) for more information about external linking learning objects.', - operationId: 'lms_batch_upsert_content', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/LmsBatchUpsertContentRequestDto', - }, - }, - }, - }, - responses: { - '202': { - description: 'Batch operation accepted', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BatchResultApiModel', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Batch Upsert External Linking Learning Objects', - tags: ['External Linking Learning Objects'], - 'x-speakeasy-group': 'lms', - 'x-speakeasy-name-override': 'batch_upsert_content', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/lms/content': { - put: { - description: - 'Create or update an external linking learning object that redirects users to a provider platform for consumption and progress tracking. \n\n**Note:** Partial updates are not supported. When updating content, you must provide all the same fields that are required when creating content. \n\nSee [here](https://docs.stackone.com/integration-guides/lms/external-content-providers/introduction) for more information about external linking learning objects.', - operationId: 'lms_upsert_content', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/LmsUpsertContentRequestDto', - }, - }, - }, - }, - responses: { - '201': { - description: 'The content was upserted successfully.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UpsertResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Upsert External Linking Learning Objects', - tags: ['External Linking Learning Objects'], - 'x-speakeasy-group': 'lms', - 'x-speakeasy-name-override': 'upsert_content', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - get: { - description: - 'Retrieve a list of content type learning objects. \n\nThese are the most granular learning objects (e.g. video, document, podcast) on a platform. \n\nOnly content objects for which the platform supports progress and completion tracking are returned.', - operationId: 'lms_list_content', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,external_reference,course_ids,remote_course_ids,title,description,additional_data,languages,content_url,mobile_launch_content_url,content_type,cover_url,active,duration,order,categories,skills,updated_at,created_at,provider,localizations,tags,authors,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'LMS Courses Filter', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - active: { - description: 'Filter to allow filtering of only active content', - oneOf: [ - { - type: 'boolean', - const: true, - }, - { - type: 'string', - const: 'true', - }, - ], - nullable: true, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of content was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ContentPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Content', - tags: ['Content'], - 'x-speakeasy-group': 'lms', - 'x-speakeasy-name-override': 'list_content', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/lms/content/{id}': { - get: { - description: - 'Retrieve a content type learning object by its identifier. \n\nThese are the most granular learning objects (e.g. video, document, podcast) on a platform. \n\nOnly content objects for which the platform supports progress and completion tracking are returned.', - operationId: 'lms_get_content', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,external_reference,course_ids,remote_course_ids,title,description,additional_data,languages,content_url,mobile_launch_content_url,content_type,cover_url,active,duration,order,categories,skills,updated_at,created_at,provider,localizations,tags,authors,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The content with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ContentResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Content', - tags: ['Content'], - 'x-speakeasy-group': 'lms', - 'x-speakeasy-name-override': 'get_content', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/lms/users/{id}/completions': { - get: { - description: - 'Retrieve a list of completed learning records for a user. \n\nThese are the records of a user completing learning objects.', - operationId: 'lms_list_user_completions', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,external_id,remote_external_id,external_reference,content_id,remote_content_id,course_id,remote_course_id,user_id,remote_user_id,completed_at,updated_at,created_at,result,content_external_reference,learning_object_type,learning_object_id,remote_learning_object_id,learning_object_external_reference,time_spent,certificate_url,score,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'LMS Completions Filter', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: - 'The completions with for the users with the given identifier were retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CompletionsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List User Completions', - tags: ['Users', 'Completions'], - 'x-speakeasy-group': 'lms', - 'x-speakeasy-name-override': 'list_user_completions', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - post: { - description: - 'Create a completed learning record for a user. \n\nThis is the record of a user completing a learning object.', - operationId: 'lms_create_user_completion', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/LmsCreateCompletionRequestDto', - }, - }, - }, - }, - responses: { - '201': { - description: 'The completion was created successfully.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CreateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Create User Completion', - tags: ['Users', 'Completions'], - 'x-speakeasy-group': 'lms', - 'x-speakeasy-name-override': 'create_user_completion', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/lms/users/{id}/completions/{subResourceId}': { - get: { - description: - 'Retrieve a completed learning record for a user by its identifier. \n\nThis is the record of a user completing a learning object.', - operationId: 'lms_get_user_completion', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'subResourceId', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields to return in the response (if empty, all fields are returned)', - schema: { - nullable: true, - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The completion with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CompletionResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get User Completion', - tags: ['Users', 'Completions'], - 'x-speakeasy-group': 'lms', - 'x-speakeasy-name-override': 'get_user_completion', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - delete: { - description: - 'Delete a completion type learning record for a user. \n\nThis is a record of a user completing a learning object.', - operationId: 'lms_delete_user_completion', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'subResourceId', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The completion was deleted successfully.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/DeleteResult', - }, - }, - }, - }, - '204': { - description: 'The completion was deleted successfully but no content was returned.', - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Delete User Completion', - tags: ['Users', 'Completions'], - 'x-speakeasy-group': 'lms', - 'x-speakeasy-name-override': 'delete_user_completion', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/lms/completions': { - get: { - description: - 'Retrieve a list of completed learning records. These are the records of a user completing learning objects.', - operationId: 'lms_list_completions', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,external_id,remote_external_id,external_reference,content_id,remote_content_id,course_id,remote_course_id,user_id,remote_user_id,completed_at,updated_at,created_at,result,content_external_reference,learning_object_type,learning_object_id,remote_learning_object_id,learning_object_external_reference,time_spent,certificate_url,score,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'LMS Completions Filter', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of completions was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CompletionsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Completions', - tags: ['Completions'], - 'x-speakeasy-group': 'lms', - 'x-speakeasy-name-override': 'list_completions', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/lms/completions/{id}': { - get: { - description: - 'Retrieve a completed learning record by its identifier. This is the record of a user completing a learning object.', - operationId: 'lms_get_completion', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields to return in the response (if empty, all fields are returned)', - schema: { - nullable: true, - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The completion with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CompletionResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Completion', - tags: ['Completions'], - 'x-speakeasy-group': 'lms', - 'x-speakeasy-name-override': 'get_completion', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/lms/categories/{id}': { - get: { - operationId: 'lms_get_category', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,name,active,hierarchy,level,language,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The category with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CategoryResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Category', - tags: ['Categories'], - 'x-speakeasy-group': 'lms', - 'x-speakeasy-name-override': 'get_category', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/lms/categories': { - get: { - operationId: 'lms_list_categories', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,name,active,hierarchy,level,language,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of categories was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CategoriesPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Categories', - tags: ['Categories'], - 'x-speakeasy-group': 'lms', - 'x-speakeasy-name-override': 'list_categories', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/lms/users': { - get: { - operationId: 'lms_list_users', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,external_reference,active,email,phone_number,created_at,updated_at,name,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'LMS Users Filter', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - email: { - description: 'Filter to select users by email', - type: 'string', - nullable: true, - }, - external_reference: { - description: 'Filter to select users by external_reference', - type: 'string', - nullable: true, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of users was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UsersPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Users', - tags: ['Users'], - 'x-speakeasy-group': 'lms', - 'x-speakeasy-name-override': 'list_users', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/lms/users/{id}': { - get: { - operationId: 'lms_get_user', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,external_reference,active,email,phone_number,created_at,updated_at,name,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The user with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UserResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get User', - tags: ['Users'], - 'x-speakeasy-group': 'lms', - 'x-speakeasy-name-override': 'get_user', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/lms/skills/{id}': { - get: { - operationId: 'lms_get_skill', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,name,active,hierarchy,language,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The skill with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/SkillResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Skill', - tags: ['Skills'], - 'x-speakeasy-group': 'lms', - 'x-speakeasy-name-override': 'get_skill', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/lms/skills': { - get: { - operationId: 'lms_list_skills', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,name,active,hierarchy,language,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of skills was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/SkillsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Skills', - tags: ['Skills'], - 'x-speakeasy-group': 'lms', - 'x-speakeasy-name-override': 'list_skills', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/lms/assignments': { - get: { - description: - 'Retrieve a list of assignment type learning records. \n\nThese are the records linking a user to a learning object. \n\nThey can be pending, in progress, or completed.', - operationId: 'lms_list_assignments', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,external_reference,user_id,remote_user_id,course_id,remote_course_id,updated_at,created_at,assigned_at,due_date,status,progress,learning_object_type,learning_object_id,remote_learning_object_id,learning_object_external_reference,certificate_url,result,completed_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'LMS Assignment Filter', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - status: { - description: 'Filter to select assignment by status', - type: 'string', - enum: ['pending', 'in_progress', 'completed', 'unmapped_value', null], - nullable: true, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - { - name: 'user_id', - required: false, - in: 'query', - description: 'The user ID associated with this assignment', - schema: { - nullable: true, - example: 'c28xyrc55866bvuv', - type: 'string', - }, - }, - { - name: 'remote_user_id', - required: false, - in: 'query', - description: "Provider's unique identifier of the user related to the assignment", - schema: { - nullable: true, - example: 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of assignments was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/AssignmentsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Assignments', - tags: ['Assignments'], - 'x-speakeasy-group': 'lms', - 'x-speakeasy-name-override': 'list_assignments', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/lms/assignments/{id}': { - get: { - description: - 'Retrieve an assignment type learning record by its identifier. \n\nThis is the record linking a user to a learning object. \n\nIt can be pending, in progress, or completed.', - operationId: 'lms_get_assignment', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields to return in the response (if empty, all fields are returned)', - schema: { - nullable: true, - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The assignment with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/AssignmentResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Assignment', - tags: ['Assignments'], - 'x-speakeasy-group': 'lms', - 'x-speakeasy-name-override': 'get_assignment', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - }, - info: { - title: 'LMS', - description: 'The documentation for the StackOne Unified API - LMS', - version: '1.0.0', - contact: {}, - }, - tags: [ - { - name: 'Courses', - description: 'Collections of learning content.', - }, - { - name: 'Content', - description: 'Granular learning content items.', - }, - { - name: 'External Linking Learning Objects', - description: 'External linking learning objects.', - }, - { - name: 'Categories', - description: 'Categories for organizing learning content.', - }, - { - name: 'Users', - description: 'People enrolled in or using the LMS.', - }, - { - name: 'Skills', - description: 'Skills or competencies taught or tracked.', - }, - { - name: 'Assignments', - description: 'Tasks or assignments for learners.', - }, - { - name: 'Completions', - description: 'Records of completed assignments or courses.', - }, - { - name: 'Collections', - description: 'Groups of courses or learning resources.', - }, - ], - servers: [ - { - url: 'https://api.stackone.com', - }, - ], - components: { - securitySchemes: { - basic: { - type: 'http', - scheme: 'basic', - }, - }, - schemas: { - AdditionalData: { - type: 'object', - properties: { - id: { - type: 'string', - description: - 'The name of the additional data field. Speak to your Solutions Engineer to understand the id for the specific use case', - example: 'learning_outcomes', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'array', - items: { - type: 'string', - }, - }, - ], - nullable: true, - description: 'The value of the additional data', - example: 'This is additional data', - }, - }, - }, - Assignment: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'The ID associated with this assignment', - example: '123456', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - external_reference: { - type: 'string', - description: 'The external reference associated with this assignment', - example: 'e3gd34-23tr21-er234-345er56', - deprecated: true, - nullable: true, - }, - learning_object_id: { - type: 'string', - description: - 'The learning_object_id associated with this assignment. This is not required unless specified in an integration.', - example: 'e3gd34-23tr21-er234-345er56', - nullable: true, - }, - remote_learning_object_id: { - type: 'string', - description: - "Provider's unique identifier of the learning object related to the assignment", - example: 'e3cb55bf-aa84-466e-a6c1-b8302b257a49', - nullable: true, - }, - learning_object_external_reference: { - type: 'string', - description: - 'The external reference of the learning object associated with this assignment, this is the main identifier for creating assignments.', - example: 'learning-content-123', - nullable: true, - }, - progress: { - type: 'number', - description: 'The progress associated with this assigment', - example: '40', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'The date the assignment was last updated', - example: '2021-07-21T14:00:00.000Z', - format: 'date-time', - nullable: true, - }, - created_at: { - type: 'string', - description: 'The date the assignment was created', - example: '2021-07-21T14:00:00.000Z', - format: 'date-time', - nullable: true, - }, - assigned_at: { - type: 'string', - description: 'The date the assignment was assigned', - example: '2021-07-21T14:00:00.000Z', - format: 'date-time', - nullable: true, - }, - due_date: { - type: 'string', - description: 'The date the assignment is due to be completed', - example: '2021-07-21T14:00:00.000Z', - format: 'date-time', - nullable: true, - }, - status: { - description: 'The status of the assignment', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/AssignmentStatusEnum', - }, - ], - }, - learning_object_type: { - description: 'The learning object type of the assignment', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/LearningObjectTypeEnum', - }, - ], - }, - user_id: { - type: 'string', - description: 'The user ID associated with this assignment', - example: 'c28xyrc55866bvuv', - nullable: true, - }, - remote_user_id: { - type: 'string', - description: "Provider's unique identifier of the user related to the assignment", - example: 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - nullable: true, - }, - certificate_url: { - type: 'string', - description: 'The certification URL associated with this assignment', - example: 'https://example.com/certificate/12345', - nullable: true, - }, - result: { - description: 'The result of the assignment', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/ResultStatusEnum', - }, - ], - }, - completed_at: { - type: 'string', - description: 'The date the content was completed', - example: '2021-07-21T14:00:00.000Z', - format: 'date-time', - nullable: true, - }, - course_id: { - type: 'string', - description: 'The course ID associated with this assignment', - example: '16873-ENG-1', - deprecated: true, - nullable: true, - }, - remote_course_id: { - type: 'string', - description: "Provider's unique identifier of the course related to the assignment", - example: 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - deprecated: true, - nullable: true, - }, - }, - }, - AssignmentResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/Assignment', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - AssignmentsPaginated: { - type: 'object', - properties: { - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/Assignment', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - AssignmentStatusEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: ['pending', 'in_progress', 'completed', 'unmapped_value', null], - example: 'in_progress', - description: 'The StackOne unified assignment status.', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - description: 'The original status value from the provider before normalization.', - nullable: true, - }, - }, - }, - AuthorModel: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'The ID of the author', - example: '123', - nullable: true, - }, - name: { - type: 'string', - description: 'The name of the author', - example: 'John Doe', - nullable: true, - }, - }, - }, - BadGatewayResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 502, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Bad Gateway', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - BadRequestResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 400, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Bad Request', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - data: { - description: 'Error details', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/UnifiedError', - }, - ], - }, - provider_errors: { - description: 'List of provider-specific errors', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/ProviderError', - }, - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - BatchResultApiModel: { - type: 'object', - properties: { - statusCode: { - type: 'number', - example: 202, - nullable: true, - }, - message: { - type: 'string', - example: 'Batch operation accepted', - nullable: true, - }, - timestamp: { - type: 'string', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - errors: { - type: 'array', - example: [['Missing field: name'], [], []], - items: { - type: 'array', - items: { - type: 'string', - }, - }, - nullable: true, - }, - }, - }, - CategoriesPaginated: { - type: 'object', - properties: { - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/Category', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - Category: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'The ID associated with this category', - example: '16873-IT345', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - name: { - type: 'string', - description: 'The name associated with this category', - example: 'Information-Technology', - nullable: true, - }, - active: { - description: 'Whether the category is active and therefore available for use', - example: true, - oneOf: [ - { - type: 'boolean', - }, - { - type: 'string', - enum: ['true', 'false'], - }, - ], - nullable: true, - }, - hierarchy: { - description: 'The hierarchal level of the category', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/CategoryLevelEnumModel', - }, - ], - }, - level: { - description: 'The hierarchal level of the category', - deprecated: true, - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/CategoryLevelEnumModel', - }, - ], - }, - language: { - description: 'The language associated with this category', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/LanguageEnum', - }, - ], - }, - }, - }, - CategoryLevelEnumModel: { - type: 'object', - properties: { - value: { - type: 'string', - enum: ['primary', 'secondary', 'tertiary', 'unmapped_value', null], - description: - 'The unified category level. For write operations: provide one of the listed enum values, or omit/set to "unmapped_value" to use source_value instead.', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - description: - 'For read operations: the original category level from the provider. For write operations: fallback value used when value is omitted or "unmapped_value". You must ensure this matches the provider\'s format.', - nullable: true, - }, - }, - }, - CategoryResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/Category', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - Completion: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'The ID associated with this completion', - example: '123456', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - learning_object_external_reference: { - type: 'string', - description: - 'The external reference of the learning object associated with this completion, this is the main identifier for creating completions.', - example: 'learning-content-123', - nullable: true, - }, - external_reference: { - type: 'string', - description: 'The external reference associated with this completion', - example: 'e3gd34-23tr21-er234-345er56', - deprecated: true, - nullable: true, - }, - result: { - description: 'The result of the completion', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/ResultStatusEnum', - }, - ], - }, - completed_at: { - type: 'string', - description: 'The date the content was completed', - example: '2021-07-21T14:00:00.000Z', - format: 'date-time', - nullable: true, - }, - created_at: { - type: 'string', - description: 'The created date of the completion', - example: '2021-07-21T14:00:00.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'The updated date of the completion', - example: '2021-07-21T14:00:00.000Z', - format: 'date-time', - nullable: true, - }, - learning_object_type: { - description: 'The learning object type of the completion', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/LearningObjectTypeEnum', - }, - ], - }, - learning_object_id: { - type: 'string', - description: - 'The id of the learning object associated with this completion. This is not required unless specified in an integration.', - example: 'e3gd34-23tr21-er234-345er56', - nullable: true, - }, - remote_learning_object_id: { - type: 'string', - description: - "Provider's unique identifier of the learning object related to the completion", - example: 'e3cb55bf-aa84-466e-a6c1-b8302b257a49', - nullable: true, - }, - user_id: { - type: 'string', - description: 'The user ID associated with this completion', - example: 'c28xyrc55866bvuv', - nullable: true, - }, - remote_user_id: { - type: 'string', - description: "Provider's unique identifier of the user related to the completion", - example: 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - nullable: true, - }, - time_spent: { - type: 'string', - description: - 'ISO 8601 duration format representing the time spent on completing the learning object', - example: 'PT1H30M45S', - format: 'string', - nullable: true, - }, - certificate_url: { - type: 'string', - description: 'The certification URL associated with this completion', - example: 'https://example.com/certificate/12345', - nullable: true, - }, - external_id: { - type: 'string', - description: 'The external ID associated with this completion', - example: 'SOFTWARE-ENG-LV1-TRAINING-VIDEO-1-COMPLETION', - deprecated: true, - nullable: true, - }, - content_external_reference: { - type: 'string', - description: 'The external reference associated with this content', - example: 'SOFTWARE-ENG-LV1-TRAINING-VIDEO-1-CONTENT', - deprecated: true, - nullable: true, - }, - remote_external_id: { - type: 'string', - description: "Provider's unique identifier of the content external reference", - example: 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - deprecated: true, - nullable: true, - }, - content_id: { - type: 'string', - description: 'The content ID associated with this completion', - example: '16873-ENG-VIDEO-1', - deprecated: true, - nullable: true, - }, - remote_content_id: { - type: 'string', - description: - "Provider's unique identifier of the content associated with the completion", - example: 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - deprecated: true, - nullable: true, - }, - course_id: { - type: 'string', - description: 'The course ID associated with this completion', - example: '16873-ENG-COURSE-1', - deprecated: true, - nullable: true, - }, - remote_course_id: { - type: 'string', - description: - "Provider's unique identifier of the course associated with the completion", - example: 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - deprecated: true, - nullable: true, - }, - score: { - description: 'The score associated with this completion', - example: { - percentage: 87, - raw_value: '87 / 100', - }, - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/ScoreModel', - }, - ], - }, - }, - }, - CompletionResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/Completion', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - CompletionsPaginated: { - type: 'object', - properties: { - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/Completion', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - ConflictResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 409, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Conflict', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - Content: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - external_reference: { - type: 'string', - description: 'The external ID associated with this content', - example: 'SOFTWARE-ENG-LV1-TRAINING-VIDEO-1', - nullable: true, - }, - course_ids: { - description: 'The parent ID/IDs associated with this content', - example: ['16873-SOFTWARE-ENG-COURSE', '16874-SOFTWARE-ENG-COURSE'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - remote_course_ids: { - description: - "Provider's unique identifier of the parent course ID associated with this content", - example: [ - 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - 'e3cb75bf-aa84-466e-a6c1-b8322b257a49', - ], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - title: { - type: 'string', - description: 'The title of the content', - example: 'Software Engineer Lv 1', - nullable: true, - }, - description: { - type: 'string', - description: 'The description of the content', - example: 'This video acts as learning content for software engineers.', - nullable: true, - }, - languages: { - description: 'The languages associated with this content', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/LanguageEnum', - }, - }, - content_url: { - type: 'string', - description: 'The external URL of the content', - example: 'https://www.youtube.com/watch?v=16873', - nullable: true, - }, - mobile_launch_content_url: { - type: 'string', - description: 'The mobile friendly URL of the content', - example: 'https://www.mobile.youtube.com/watch?v=16873', - nullable: true, - }, - content_type: { - description: 'The type of content', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/ContentTypeEnum', - }, - ], - }, - cover_url: { - type: 'string', - description: 'The URL of the thumbnail image associated with the content.', - example: 'https://www.googledrive.com/?v=16873', - nullable: true, - }, - active: { - description: 'Whether the content is active and available for users.', - example: true, - oneOf: [ - { - type: 'boolean', - }, - { - type: 'string', - enum: ['true', 'false'], - }, - ], - nullable: true, - }, - duration: { - type: 'string', - description: - 'The duration of the content following the ISO8601 standard. If duration_unit is applicable we will derive this from the smallest unit given in the duration string or the minimum unit accepted by the provider.', - example: 'P3Y6M4DT12H30M5S', - format: 'string', - nullable: true, - }, - categories: { - description: 'The categories associated with this content', - example: [ - { - id: '12345', - name: 'Technology', - }, - ], - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/Category', - }, - }, - skills: { - description: 'The skills associated with this course', - example: [ - { - id: '12345', - name: 'Sales Techniques', - }, - ], - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/Skills', - }, - }, - order: { - type: 'number', - description: - 'The order of the individual content within a content grouping. This is not applicable for pushing individual content.', - example: 1, - format: 'number', - nullable: true, - }, - provider: { - type: 'string', - description: 'The name of the content provider', - example: 'Content Provider', - nullable: true, - }, - short_description: { - type: 'string', - description: 'A short description or summary for the content', - example: 'This course is a valuable resource and acts as learning content for...', - deprecated: true, - nullable: true, - }, - localizations: { - description: 'Localised content information', - example: [ - { - title: 'Software Engineer Lv 1', - description: 'This video acts as learning content for software engineers.', - languages: { - value: 'en-US', - source_value: 'string', - }, - }, - ], - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/LocalizationModel', - }, - }, - tags: { - description: 'A list of tags associated with the content', - example: ['Sales Techniques', 'Customer Service'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - authors: { - description: 'The authors of the content', - example: [ - { - id: '123', - name: 'John Doe', - }, - ], - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/AuthorModel', - }, - }, - updated_at: { - type: 'string', - description: 'The date on which the content was last updated.', - example: '2021-07-21T14:00:00.000Z', - format: 'date-time', - nullable: true, - }, - created_at: { - type: 'string', - description: 'The date on which the content was created.', - example: '2021-07-21T14:00:00.000Z', - format: 'date-time', - nullable: true, - }, - }, - }, - ContentPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - total: { - type: 'number', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/Content', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - ContentResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/Content', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - ContentTypeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: ['video', 'quiz', 'document', 'audio', 'article', 'unmapped_value', null], - description: 'The StackOne unified content type.', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - description: 'The original value from the provider before normalization.', - nullable: true, - }, - }, - }, - Course: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - external_reference: { - type: 'string', - description: 'The external ID associated with this course', - example: 'SOFTWARE-ENG-LV1-TRAINING-VIDEO-1', - nullable: true, - }, - content_ids: { - description: 'The child ID/IDs associated with this course', - example: ['16873-SOFTWARE-ENG-COURSE', '16874-SOFTWARE-ENG-COURSE'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - remote_content_ids: { - description: - "Provider's unique identifier of the child content IDs associated with this course", - example: [ - 'e3cb75bf-aa84-466e-a6c1-b8322b257a48', - 'e3cb75bf-aa84-466e-a6c1-b8322b257a49', - ], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - title: { - type: 'string', - description: 'The title of the course', - example: 'Software Engineer Lv 1', - nullable: true, - }, - description: { - type: 'string', - description: 'The description of the course', - example: 'This course acts as learning content for software engineers.', - nullable: true, - }, - languages: { - description: 'The languages associated with this course', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/LanguageEnum', - }, - }, - cover_url: { - type: 'string', - description: 'The URL of the thumbnail image associated with the course.', - example: 'https://www.googledrive.com/?v=16873', - nullable: true, - }, - url: { - type: 'string', - description: 'The redirect URL of the course.', - example: 'https://www.linkedinlearning.com/?v=16873', - nullable: true, - }, - active: { - description: 'Whether the course is active and available for users.', - example: true, - oneOf: [ - { - type: 'boolean', - }, - { - type: 'string', - enum: ['true', 'false'], - }, - ], - nullable: true, - }, - duration: { - type: 'string', - description: - 'The duration of the course following the ISO8601 standard. If duration_unit is applicable we will derive this from the smallest unit given in the duration string', - example: 'P3Y6M4DT12H30M5S', - format: 'string', - nullable: true, - }, - categories: { - description: 'The categories associated with this course', - example: [ - { - id: '12345', - name: 'Technology', - }, - ], - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/Category', - }, - }, - skills: { - description: 'The skills associated with this course', - example: [ - { - id: '12345', - name: 'Sales Techniques', - }, - ], - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/Skills', - }, - }, - provider: { - type: 'string', - description: 'The name of the course provider', - example: 'Course Provider', - format: 'string', - nullable: true, - }, - authors: { - description: 'The authors of the course', - example: [ - { - id: '123', - name: 'John Doe', - }, - ], - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/AuthorModel', - }, - }, - updated_at: { - type: 'string', - description: 'The date on which the course was last updated.', - example: '2021-07-21T14:00:00.000Z', - format: 'date-time', - nullable: true, - }, - created_at: { - type: 'string', - description: 'The date on which the course was created.', - example: '2021-07-21T14:00:00.000Z', - format: 'date-time', - nullable: true, - }, - }, - }, - CoursePaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - total: { - type: 'number', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/Course', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - CourseResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/Course', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - CreateCategoriesApiModel: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'The ID associated with this category', - example: '16873-IT345', - nullable: true, - }, - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - name: { - type: 'string', - description: 'The name associated with this category', - example: 'Information-Technology', - nullable: true, - }, - hierarchy: { - description: 'The hierarchal level of the category', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/CategoryLevelEnumModel', - }, - ], - }, - level: { - description: 'The hierarchal level of the category', - deprecated: true, - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/CategoryLevelEnumModel', - }, - ], - }, - language: { - description: 'The language associated with this category', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/LanguageEnum', - }, - ], - }, - }, - }, - CreateResult: { - type: 'object', - properties: { - statusCode: { - type: 'number', - example: 201, - }, - message: { - type: 'string', - example: 'Record created successfully.', - }, - timestamp: { - type: 'string', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - }, - data: { - $ref: '#/components/schemas/CreateResultDataApiModel', - }, - }, - required: ['statusCode', 'message', 'timestamp', 'data'], - }, - CreateResultDataApiModel: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - }, - }, - CreateSkillsApiModel: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'The ID associated with this skill', - example: '16873-IT345', - nullable: true, - }, - name: { - type: 'string', - description: 'The name associated with this skill', - example: 'Information-Technology', - nullable: true, - }, - hierarchy: { - description: 'The hierarchal level of the skill', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/SkillLevelEnum', - }, - ], - }, - language: { - description: 'The language associated with this skill', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/LanguageEnum', - }, - ], - }, - level: { - description: 'The hierarchal level of the skill', - deprecated: true, - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/SkillLevelEnum', - }, - ], - }, - }, - }, - DeleteResult: { - type: 'object', - properties: { - statusCode: { - type: 'number', - example: 204, - }, - message: { - type: 'string', - example: 'Record deleted successfully.', - }, - timestamp: { - type: 'string', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - ForbiddenResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 403, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Forbidden resource', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - InternalServerErrorResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 500, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Internal server error', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - LanguageEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'ar_AR', - 'aa_ER', - 'af_NA', - 'af_ZA', - 'am_ET', - 'ar_AE', - 'ar_BH', - 'ar_DJ', - 'ar_DZ', - 'ar_EG', - 'ar_ER', - 'ar_IQ', - 'ar_JO', - 'ar_KM', - 'ar_KW', - 'ar_LB', - 'ar_LY', - 'ar_MA', - 'ar_MR', - 'ar_OM', - 'ar_PS', - 'ar_QA', - 'ar_SA', - 'ar_SD', - 'ar_SY', - 'ar_TD', - 'ar_TN', - 'ar_YE', - 'ay_BO', - 'ay_PE', - 'az_AZ', - 'az_IR', - 'be_BY', - 'bg_BG', - 'bi_VU', - 'bn_BD', - 'bn_IN', - 'bs_BA', - 'bs-ME', - 'byn_ER', - 'ca_AD', - 'ca_ES', - 'ca_FR', - 'ca_IT', - 'ch_GU', - 'cs_CZ', - 'da_DK', - 'de_AT', - 'de_BE', - 'de_CH', - 'de_DE', - 'de_LI', - 'de_LU', - 'de_VA', - 'de_MV', - 'dv_MV', - 'dz_BT', - 'el_CY', - 'el_GR', - 'en_AG', - 'en_AI', - 'en_AS', - 'en_AU', - 'en_BB', - 'en_BE', - 'en_BM', - 'en_BS', - 'en_BW', - 'en_BZ', - 'en_CA', - 'en_CC', - 'en_CK', - 'en_CM', - 'en_CW', - 'en_CX', - 'en_DG', - 'en_DM', - 'en_ER', - 'en_FJ', - 'en_FK', - 'en_FM', - 'en_GB', - 'en_GD', - 'en_GG', - 'en_GH', - 'en_GI', - 'en_GM', - 'en_GS', - 'en_GU', - 'en_GY', - 'en_HK', - 'en_IE', - 'en_IM', - 'en_IN', - 'en_IO', - 'en_JE', - 'en_JM', - 'en_KE', - 'en_KI', - 'en_KN', - 'en_KY', - 'en_LC', - 'en_LR', - 'en_LS', - 'en_MF', - 'en_MG', - 'en_MH', - 'en_MO', - 'en_MP', - 'en_MS', - 'en_MT', - 'en_MU', - 'en_MW', - 'en_MY', - 'en_NA', - 'en_NF', - 'en_NG', - 'en_NL', - 'en_NR', - 'en_NU', - 'en_NZ', - 'en_PG', - 'en_PH', - 'en_PK', - 'en_PN', - 'en_PR', - 'en_PW', - 'en_RW', - 'en_SB', - 'en_SC', - 'en_SD', - 'en_SG', - 'en_SH', - 'en_SL', - 'en_SS', - 'en_SX', - 'en_SZ', - 'en_TC', - 'en_TK', - 'en_TO', - 'en_TT', - 'en_TV', - 'en_TZ', - 'en_UG', - 'en_UM', - 'en_US', - 'en_VC', - 'en_VG', - 'en_VI', - 'en_VU', - 'en_WS', - 'en_ZA', - 'en_ZM', - 'en_ZW', - 'es_AR', - 'es_BO', - 'es_BZ', - 'es_CL', - 'es_CO', - 'es_CR', - 'es_CU', - 'es_DO', - 'es_EA', - 'es_EC', - 'es_EH', - 'es_ES', - 'es_GQ', - 'es_GT', - 'es_HN', - 'es_IC', - 'es_LA', - 'es_MX', - 'es_NI', - 'es_PA', - 'es_PE', - 'es_PH', - 'es_PR', - 'es_PY', - 'es_SV', - 'es_US', - 'es_UY', - 'es_VE', - 'et_EE', - 'fa_AF', - 'fa_IR', - 'fan_GA', - 'ff_CM', - 'ff_GN', - 'ff_MR', - 'ff_SN', - 'ff_BF', - 'fi_FI', - 'fj_FJ', - 'fo_FO', - 'fr_BE', - 'fr_BF', - 'fr_BI', - 'fr_BJ', - 'fr_BL', - 'fr_CA', - 'fr_CD', - 'fr_CF', - 'fr_CG', - 'fr_CH', - 'fr_CI', - 'fr_CM', - 'fr_DJ', - 'fr_DZ', - 'fr_FR', - 'fr_GA', - 'fr_GF', - 'fr_GG', - 'fr_GN', - 'fr_GP', - 'fr_GQ', - 'fr_HT', - 'fr_KM', - 'fr_JE', - 'fr_LU', - 'fr_LB', - 'fr_MA', - 'fr_MC', - 'fr_MF', - 'fr_MG', - 'fr_ML', - 'fr_MQ', - 'fr_MR', - 'fr_MU', - 'fr_NC', - 'fr_NE', - 'fr_PF', - 'fr_PM', - 'fr_RE', - 'fr_RW', - 'fr_SC', - 'fr_SN', - 'fr_SY', - 'fr_TD', - 'fr_TF', - 'fr_TG', - 'fr_TN', - 'fr_VU', - 'fr_VA', - 'fr_WF', - 'fr_YT', - 'ga_IE', - 'gn_PY', - 'gn_AR', - 'gu_IN', - 'gv_IM', - 'he_IL', - 'hi_IN', - 'hr_BA', - 'hr_HR', - 'hr_ME', - 'ht_HT', - 'hu_HU', - 'hy_AM', - 'hy_CY', - 'id_ID', - 'is_IS', - 'it_CH', - 'it_IT', - 'it_SM', - 'it_VA', - 'ja_JP', - 'ka_GE', - 'kg_CD', - 'kk_KZ', - 'kl_GL', - 'km_KH', - 'ko_KP', - 'ko_KR', - 'ku_IQ', - 'ky_KG', - 'la_VA', - 'lb_LU', - 'ln_AO', - 'ln_CD', - 'ln_CF', - 'ln_CG', - 'lo_LA', - 'lt_LT', - 'lu_CD', - 'lv_LV', - 'mg_MG', - 'mh_MH', - 'mi_NZ', - 'mk_MK', - 'mn_MN', - 'mr_IN', - 'ms_BN', - 'ms_MY', - 'ms_SG', - 'mt_MT', - 'my_MM', - 'nb_NO', - 'nb_BV', - 'nb_ZW', - 'ne_NP', - 'nl_AW', - 'nl_BE', - 'nl_BQ', - 'nl_CW', - 'nl_NL', - 'nl_SR', - 'nl_SX', - 'nl_MF', - 'nn_NO', - 'nn_BV', - 'no_NO', - 'no_BV', - 'no_SJ', - 'nr_ZA', - 'ny_MW', - 'pa_IN', - 'pa_PK', - 'pl_PL', - 'ps_AF', - 'pt_AO', - 'pt_BR', - 'pt_CH', - 'pt_CV', - 'pt_GQ', - 'pt_GW', - 'pt_LU', - 'pt_MO', - 'pt_MZ', - 'pt_PT', - 'pt_ST', - 'pt_TL', - 'qu_BO', - 'qu_EC', - 'qu_PE', - 'rar_CK', - 'rm_CH', - 'rup_MK', - 'ro_MD', - 'ro_RO', - 'ru_BY', - 'ru_KG', - 'ru_KZ', - 'ru_MD', - 'ru_RU', - 'ru_UA', - 'ru_AQ', - 'ru_TJ', - 'ru_TM', - 'ru_UZ', - 'rw_RW', - 'se_SE', - 'sg_CF', - 'si_LK', - 'sk_SK', - 'sl_SI', - 'sm_AS', - 'sm_WS', - 'sn_ZW', - 'so_DJ', - 'so_ET', - 'so_KE', - 'so_SO', - 'sq_AL', - 'sq_ME', - 'sq_XK', - 'sr_BA', - 'sr_ME', - 'sr_RS', - 'sr_XK', - 'ss_SZ', - 'ss_ZA', - 'sv_AX', - 'sv_FI', - 'sv_SE', - 'sw_KE', - 'sw_TZ', - 'sw_UG', - 'sw_CD', - 'ta_IN', - 'ta_MY', - 'ta_SG', - 'ta_LK', - 'te_IN', - 'tg_TJ', - 'th_TH', - 'ti_ER', - 'ti_ET', - 'tig_ER', - 'tk_TM', - 'tk_AF', - 'tn_BW', - 'tn_ZA', - 'to_TO', - 'tr_CY', - 'tr_TR', - 'ts_ZA', - 'uk_UA', - 'ur_IN', - 'ur_PK', - 'uz_AF', - 'uz_UZ', - 've_ZA', - 'vi_VN', - 'xh_ZA', - 'zh_CN', - 'zh_HK', - 'zh_MO', - 'zh_SG', - 'zh_TW', - 'zu_ZA', - 'unmapped_value', - null, - ], - description: - 'The unified locale code. For write operations: provide one of the listed enum values, or omit/set to "unmapped_value" to use source_value instead.', - example: 'en_GB', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - description: - 'For read operations: the original language code from the provider. For write operations: fallback value used when value is omitted or "unmapped_value". You must ensure this matches the provider\'s format.', - nullable: true, - }, - }, - }, - LearningObjectTypeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: ['content', 'course', 'collection', 'unmapped_value', null], - description: 'The StackOne unified learning object type.', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - description: - 'The original learning object type from the provider before normalization.', - nullable: true, - }, - }, - }, - LmsBatchUpsertContentRequestDto: { - type: 'object', - properties: { - items: { - description: 'The batch of items to upsert', - nullable: false, - type: 'array', - items: { - $ref: '#/components/schemas/LmsUpsertContentRequestDto', - }, - }, - }, - required: ['items'], - }, - LmsCreateAssignmentRequestDto: { - type: 'object', - properties: { - passthrough: { - type: 'object', - description: 'Value to pass through to the provider', - example: { - other_known_names: 'John Doe', - }, - additionalProperties: true, - nullable: true, - }, - external_reference: { - type: 'string', - description: 'The external reference associated with this assignment', - example: 'e3gd34-23tr21-er234-345er56', - deprecated: true, - nullable: true, - }, - learning_object_id: { - type: 'string', - description: - 'The learning_object_id associated with this assignment. This is not required unless specified in an integration.', - example: 'e3gd34-23tr21-er234-345er56', - nullable: true, - }, - progress: { - type: 'number', - description: 'The progress associated with this assigment', - example: '40', - nullable: true, - }, - assigned_at: { - type: 'string', - description: 'The date the assignment was assigned', - example: '2021-07-21T14:00:00.000Z', - format: 'date-time', - nullable: true, - }, - due_date: { - type: 'string', - description: 'The date the assignment is due to be completed', - example: '2021-07-21T14:00:00.000Z', - format: 'date-time', - nullable: true, - }, - status: { - description: 'The status of the assignment', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/AssignmentStatusEnum', - }, - ], - }, - learning_object_external_reference: { - type: 'string', - description: - 'The external reference of the learning object associated with this assignment, this is the main identifier for creating assignments.', - example: 'learning-content-123', - }, - }, - required: ['learning_object_external_reference'], - }, - LmsCreateCompletionRequestDto: { - type: 'object', - properties: { - passthrough: { - type: 'object', - description: 'Value to pass through to the provider', - example: { - other_known_names: 'John Doe', - }, - additionalProperties: true, - nullable: true, - }, - result: { - description: 'The result of the completion', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/ResultStatusEnum', - }, - ], - }, - completed_at: { - type: 'string', - description: 'The date the content was completed', - example: '2021-07-21T14:00:00.000Z', - format: 'date-time', - nullable: true, - }, - learning_object_id: { - type: 'string', - description: - 'The id of the learning object associated with this completion. This is not required unless specified in an integration.', - example: 'e3gd34-23tr21-er234-345er56', - nullable: true, - }, - time_spent: { - type: 'string', - description: - 'ISO 8601 duration format representing the time spent on completing the learning object', - example: 'PT1H30M45S', - format: 'string', - nullable: true, - }, - content_external_reference: { - type: 'string', - description: 'The external reference associated with this content', - example: 'SOFTWARE-ENG-LV1-TRAINING-VIDEO-1-CONTENT', - deprecated: true, - nullable: true, - }, - content_id: { - type: 'string', - description: 'The content ID associated with this completion', - example: '16873-ENG-VIDEO-1', - deprecated: true, - nullable: true, - }, - score: { - description: 'The score associated with this completion', - example: { - percentage: 87, - raw_value: '87 / 100', - }, - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/ScoreModel', - }, - ], - }, - learning_object_external_reference: { - type: 'string', - description: - 'The external reference of the learning object associated with this completion, this is the main identifier for creating completions.', - example: 'learning-content-123', - }, - }, - required: ['learning_object_external_reference'], - }, - LmsUpsertContentRequestDto: { - type: 'object', - properties: { - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - title: { - type: 'string', - description: 'The title of the content', - example: 'Software Engineer Lv 1', - nullable: true, - }, - description: { - type: 'string', - description: 'The description of the content', - example: 'This video acts as learning content for software engineers.', - nullable: true, - }, - languages: { - description: 'The languages associated with this content', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/LanguageEnum', - }, - }, - content_url: { - type: 'string', - description: 'The external URL of the content', - example: 'https://www.youtube.com/watch?v=16873', - nullable: true, - }, - mobile_launch_content_url: { - type: 'string', - description: 'The mobile friendly URL of the content', - example: 'https://www.mobile.youtube.com/watch?v=16873', - nullable: true, - }, - cover_url: { - type: 'string', - description: 'The URL of the thumbnail image associated with the content.', - example: 'https://www.googledrive.com/?v=16873', - nullable: true, - }, - active: { - description: 'Whether the content is active and available for users.', - example: true, - oneOf: [ - { - type: 'boolean', - }, - { - type: 'string', - enum: ['true', 'false'], - }, - ], - nullable: true, - }, - duration: { - type: 'string', - description: - 'The duration of the content following the ISO8601 standard. If duration_unit is applicable we will derive this from the smallest unit given in the duration string or the minimum unit accepted by the provider.', - example: 'P3Y6M4DT12H30M5S', - format: 'string', - nullable: true, - }, - skills: { - description: 'The skills associated with this content', - example: [ - { - id: '12345', - name: 'Sales Techniques', - }, - ], - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/CreateSkillsApiModel', - }, - }, - order: { - type: 'number', - description: - 'The order of the individual content within a content grouping. This is not applicable for pushing individual content.', - example: 1, - format: 'number', - nullable: true, - }, - short_description: { - type: 'string', - description: 'A short description or summary for the content', - example: 'This course is a valuable resource and acts as learning content for...', - deprecated: true, - nullable: true, - }, - localizations: { - description: 'The localization data for this course', - example: [ - { - title: 'Software Engineer Lv 1', - description: 'This course acts as learning resource for software engineers.', - languages: { - value: 'en-GB', - source_value: 'string', - }, - }, - { - title: 'Software Engineer: A comprehensive guide', - description: 'This course acts as learning resource for software engineers.', - languages: { - value: 'en-US', - source_value: 'string', - }, - }, - ], - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/LocalizationModel', - }, - }, - tags: { - description: 'A list of tags associated with the content', - example: ['Sales Techniques', 'Customer Service'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - authors: { - description: 'The authors of the content', - example: [ - { - id: '123', - name: 'John Doe', - }, - ], - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/AuthorModel', - }, - }, - updated_at: { - type: 'string', - description: 'The date on which the content was last updated.', - example: '2021-07-21T14:00:00.000Z', - format: 'date-time', - nullable: true, - }, - created_at: { - type: 'string', - description: 'The date on which the content was created.', - example: '2021-07-21T14:00:00.000Z', - format: 'date-time', - nullable: true, - }, - external_reference: { - type: 'string', - description: 'The external ID associated with this content', - example: 'SOFTWARE-ENG-LV1-TRAINING-VIDEO-1', - }, - categories: { - description: 'The categories associated with this content', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/CreateCategoriesApiModel', - }, - }, - additional_data: { - description: 'The additional_data associated with this content', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/AdditionalData', - }, - }, - content_type: { - description: 'The type of content', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/WriteContentTypeEnum', - }, - ], - }, - }, - required: ['external_reference'], - }, - LmsUser: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - external_reference: { - type: 'string', - description: 'The external ID associated with this user', - example: 'al60043', - nullable: true, - }, - name: { - type: 'string', - description: 'The user name', - example: 'John Dew', - nullable: true, - }, - email: { - type: 'string', - description: 'The user email', - example: 'john@dew.com', - nullable: true, - }, - phone_number: { - type: 'string', - description: 'The user phone number', - example: '+1234567890', - nullable: true, - }, - active: { - description: 'The user active status', - example: true, - oneOf: [ - { - type: 'boolean', - }, - { - type: 'string', - enum: ['true', 'false'], - }, - ], - nullable: true, - }, - created_at: { - type: 'string', - description: 'The created_at date', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'The updated_at date', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - }, - }, - LocalizationModel: { - type: 'object', - properties: { - title: { - type: 'string', - description: 'The title of the content', - example: 'Software Engineer Lv 1', - nullable: true, - }, - description: { - type: 'string', - description: 'The description of the content', - example: 'This video acts as learning content for software engineers.', - nullable: true, - }, - language: { - description: 'The language associated with the localization details', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/LanguageEnum', - }, - ], - }, - tags: { - description: 'The tags associated with the localization details', - example: ['Sales Techniques', 'Customer Service'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - }, - }, - NotFoundResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 404, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Not Found', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - NotImplementedResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 501, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Not Implemented', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - PreconditionFailedResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 412, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Precondition failed', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - ProviderError: { - type: 'object', - properties: { - status: { - type: 'number', - description: 'HTTP status code of the provider error', - example: 400, - nullable: true, - }, - url: { - type: 'string', - description: 'URL that caused the error', - example: 'https://api.provider.com/v1/resource', - nullable: true, - }, - raw: { - type: 'object', - description: 'Raw error response from the provider', - example: { - message: 'Invalid input parameters', - }, - nullable: true, - }, - headers: { - type: 'object', - description: 'Response headers', - example: { - 'content-type': 'application/json', - 'x-request-id': '5678c28b211dace4e0a0f9171e6b88c5', - }, - nullable: true, - }, - }, - }, - RawResponse: { - type: 'object', - properties: { - method: { - type: 'string', - }, - url: { - type: 'string', - }, - body: { - oneOf: [ - { - type: 'string', - }, - { - type: 'object', - }, - { - type: 'array', - items: { - type: 'integer', - format: 'int32', - minimum: 0, - maximum: 255, - }, - }, - ], - additionalProperties: true, - nullable: true, - }, - response: { - oneOf: [ - { - type: 'object', - additionalProperties: true, - }, - { - type: 'array', - items: {}, - }, - { - type: 'string', - }, - ], - nullable: true, - }, - }, - required: ['method', 'url'], - }, - RequestTimedOutResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 408, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Request timed out', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - ResultStatusEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: ['Pass', 'Fail', 'unmapped_value', null], - description: 'The StackOne unified result status.', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - description: 'The original result status from the provider before normalization.', - nullable: true, - }, - }, - }, - ScoreModel: { - type: 'object', - properties: { - percentage: { - type: 'number', - description: 'The score percentage', - example: 87.5, - nullable: true, - }, - raw_value: { - type: 'string', - description: 'The raw string score value', - example: 87, - nullable: true, - }, - }, - }, - SkillLevelEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: ['primary', 'secondary', 'tertiary', 'unmapped_value', null], - description: - 'The unified skill level. For write operations: provide one of the listed enum values, or omit/set to "unmapped_value" to use source_value instead.', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - description: - 'For read operations: the original skill level from the provider. For write operations: fallback value used when value is omitted or "unmapped_value". You must ensure this matches the provider\'s format.', - nullable: true, - }, - }, - }, - SkillResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/Skills', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - Skills: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'The ID associated with this skill', - example: '16873-IT345', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - description: 'The name associated with this skill', - example: 'Information-Technology', - nullable: true, - }, - active: { - description: 'Whether the skill is active and therefore available for use', - example: true, - oneOf: [ - { - type: 'boolean', - }, - { - type: 'string', - enum: ['true', 'false'], - }, - ], - nullable: true, - }, - hierarchy: { - description: 'The hierarchal level of the skill', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/SkillLevelEnum', - }, - ], - }, - language: { - description: 'The language associated with this skill', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/LanguageEnum', - }, - ], - }, - level: { - description: 'The hierarchal level of the skill', - deprecated: true, - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/SkillLevelEnum', - }, - ], - }, - }, - }, - SkillsPaginated: { - type: 'object', - properties: { - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/Skills', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - TooManyRequestsResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 429, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Too many requests', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - UnauthorizedResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 401, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Unauthorized', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - UnifiedError: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 400, - nullable: true, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Bad Request', - nullable: true, - }, - headers: { - type: 'object', - description: 'Response headers', - example: { - 'content-type': 'application/json', - 'x-request-id': '5678c28b211dace4e0a0f9171e6b88c5', - }, - nullable: true, - }, - }, - }, - UnprocessableEntityResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 422, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Unprocessable Entity', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - UpsertResult: { - type: 'object', - properties: { - statusCode: { - type: 'number', - example: 201, - }, - message: { - type: 'string', - example: 'Record created successfully.', - }, - timestamp: { - type: 'string', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - }, - data: { - $ref: '#/components/schemas/UpsertResultDataExternalReferenceModel', - }, - }, - required: ['statusCode', 'message', 'timestamp', 'data'], - }, - UpsertResultDataExternalReferenceModel: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - external_reference: { - type: 'string', - description: 'The external identifier', - example: 'SOFTWARE-ENG-LV1-TRAINING-VIDEO-1', - nullable: true, - }, - }, - }, - UserResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/LmsUser', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - UsersPaginated: { - type: 'object', - properties: { - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/LmsUser', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - WriteContentTypeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'video', - 'quiz', - 'document', - 'audio', - 'article', - 'book', - 'event', - 'course', - 'collection', - 'interactive', - 'unmapped_value', - null, - ], - description: - 'The content type for write operations. Provide one of the listed enum values. If omitted or set to "unmapped_value", the source_value will be sent to the provider instead.', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - description: - 'The provider-specific value to use when value is omitted or set to "unmapped_value". You are responsible for ensuring this matches the provider\'s expected format.', - nullable: true, - }, - }, - }, - }, - }, -}; diff --git a/src/openapi/generated/marketing.ts b/src/openapi/generated/marketing.ts deleted file mode 100644 index 883bd52c..00000000 --- a/src/openapi/generated/marketing.ts +++ /dev/null @@ -1,7697 +0,0 @@ -// Generated OpenAPI specification for marketing -// DO NOT EDIT THIS FILE DIRECTLY -export const marketingSpec = { - openapi: '3.1.0', - paths: { - '/unified/marketing/templates/email': { - get: { - operationId: 'marketing_list_email_templates', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,messages,created_at,updated_at,tags,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of email templates was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/EmailTemplatesPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Email Templates', - tags: ['Templates', 'Email'], - 'x-speakeasy-group': 'marketing', - 'x-speakeasy-name-override': 'list_email_templates', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - post: { - operationId: 'marketing_create_email_template', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/MarketingCreateEmailTemplateRequestDto', - }, - }, - }, - }, - responses: { - '201': { - description: 'Record created successfully.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CreateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Create Email Templates', - tags: ['Templates', 'Email'], - 'x-speakeasy-group': 'marketing', - 'x-speakeasy-name-override': 'create_email_template', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/marketing/templates/email/{id}': { - get: { - operationId: 'marketing_get_email_template', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,messages,created_at,updated_at,tags,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The email template with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/EmailTemplateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Email Templates', - tags: ['Templates', 'Email'], - 'x-speakeasy-group': 'marketing', - 'x-speakeasy-name-override': 'get_email_template', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - patch: { - operationId: 'marketing_update_email_template', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/MarketingCreateEmailTemplateRequestDto', - }, - }, - }, - }, - responses: { - '200': { - description: 'Record updated successfully', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CreateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Update Email Templates', - tags: ['Templates', 'Email'], - 'x-speakeasy-group': 'marketing', - 'x-speakeasy-name-override': 'update_email_template', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/marketing/templates/in_app': { - get: { - operationId: 'marketing_list_in_app_templates', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,messages,created_at,updated_at,tags,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of in-app templates was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InAppTemplatesPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List In-App Templates', - tags: ['Templates', 'In App'], - 'x-speakeasy-group': 'marketing', - 'x-speakeasy-name-override': 'list_in_app_templates', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - post: { - operationId: 'marketing_create_in_app_template', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/MarketingCreateInAppTemplateRequestDto', - }, - }, - }, - }, - responses: { - '201': { - description: 'Record created successfully.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CreateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Create In-App Template', - tags: ['Templates', 'In App'], - 'x-speakeasy-group': 'marketing', - 'x-speakeasy-name-override': 'create_in_app_template', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/marketing/templates/in_app/{id}': { - get: { - operationId: 'marketing_get_in_app_template', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,messages,created_at,updated_at,tags,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The in-app template with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InAppTemplateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get In-App Template', - tags: ['Templates', 'In App'], - 'x-speakeasy-group': 'marketing', - 'x-speakeasy-name-override': 'get_in_app_template', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - patch: { - operationId: 'marketing_update_in_app_template', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/MarketingCreateInAppTemplateRequestDto', - }, - }, - }, - }, - responses: { - '200': { - description: 'Record updated successfully', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CreateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Update In-App Template', - tags: ['Templates', 'In App'], - 'x-speakeasy-group': 'marketing', - 'x-speakeasy-name-override': 'update_in_app_template', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/marketing/templates/sms': { - get: { - operationId: 'marketing_list_sms_templates', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,messages,created_at,updated_at,tags,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of SMS templates was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/SmsTemplatesPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List SMS Templates', - tags: ['Templates', 'SMS'], - 'x-speakeasy-group': 'marketing', - 'x-speakeasy-name-override': 'list_sms_templates', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - post: { - operationId: 'marketing_create_sms_template', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/MarketingCreateSmsTemplateRequestDto', - }, - }, - }, - }, - responses: { - '201': { - description: 'Record created successfully.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CreateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Create SMS Template', - tags: ['Templates', 'SMS'], - 'x-speakeasy-group': 'marketing', - 'x-speakeasy-name-override': 'create_sms_template', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/marketing/templates/sms/{id}': { - get: { - operationId: 'marketing_get_sms_template', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,messages,created_at,updated_at,tags,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The SMS template with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/SmsTemplateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get SMS Template', - tags: ['Templates', 'SMS'], - 'x-speakeasy-group': 'marketing', - 'x-speakeasy-name-override': 'get_sms_template', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - patch: { - operationId: 'marketing_update_sms_template', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/MarketingCreateSmsTemplateRequestDto', - }, - }, - }, - }, - responses: { - '200': { - description: 'Record updated successfully', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CreateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Update SMS Template', - tags: ['Templates', 'SMS'], - 'x-speakeasy-group': 'marketing', - 'x-speakeasy-name-override': 'update_sms_template', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/marketing/templates/omni_channel': { - get: { - deprecated: true, - operationId: 'marketing_list_omni_channel_templates', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,messages,created_at,updated_at,tags,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of omni-channel templates was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TemplatesPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Omni-Channel Templates', - tags: ['Templates', 'Omni-Channel'], - 'x-speakeasy-group': 'marketing', - 'x-speakeasy-name-override': 'list_omni_channel_templates', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - post: { - deprecated: true, - operationId: 'marketing_create_omni_channel_template', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/MarketingCreateTemplateRequestDto', - }, - }, - }, - }, - responses: { - '201': { - description: 'Record created successfully.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CreateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Create Omni-Channel Template', - tags: ['Templates', 'Omni-Channel'], - 'x-speakeasy-group': 'marketing', - 'x-speakeasy-name-override': 'create_omni_channel_template', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/marketing/templates/omni_channel/{id}': { - get: { - deprecated: true, - operationId: 'marketing_get_omni_channel_template', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,messages,created_at,updated_at,tags,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The omni-channel template with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TemplateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Omni-Channel Template', - tags: ['Templates', 'Omni-Channel'], - 'x-speakeasy-group': 'marketing', - 'x-speakeasy-name-override': 'get_omni_channel_template', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - patch: { - deprecated: true, - operationId: 'marketing_update_omni_channel_template', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/MarketingCreateTemplateRequestDto', - }, - }, - }, - }, - responses: { - '200': { - description: 'Record updated successfully', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CreateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Update Omni-Channel Template', - tags: ['Templates', 'Omni-Channel'], - 'x-speakeasy-group': 'marketing', - 'x-speakeasy-name-override': 'update_omni_channel_template', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/marketing/templates/push': { - get: { - operationId: 'marketing_list_push_templates', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,messages,created_at,updated_at,tags,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of push templates was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PushTemplatesPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Push Templates', - tags: ['Templates', 'Push'], - 'x-speakeasy-group': 'marketing', - 'x-speakeasy-name-override': 'list_push_templates', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - post: { - operationId: 'marketing_create_push_template', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/MarketingCreatePushTemplateRequestDto', - }, - }, - }, - }, - responses: { - '201': { - description: 'Record created successfully.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CreateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Create Push Template', - tags: ['Templates', 'Push'], - 'x-speakeasy-group': 'marketing', - 'x-speakeasy-name-override': 'create_push_template', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/marketing/templates/push/{id}': { - get: { - operationId: 'marketing_get_push_template', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,messages,created_at,updated_at,tags,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The push template with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PushTemplateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Push Template', - tags: ['Templates', 'Push'], - 'x-speakeasy-group': 'marketing', - 'x-speakeasy-name-override': 'get_push_template', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - patch: { - operationId: 'marketing_update_push_template', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/MarketingCreatePushTemplateRequestDto', - }, - }, - }, - }, - responses: { - '200': { - description: 'Record updated successfully', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CreateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Update Push Template', - tags: ['Templates', 'Push'], - 'x-speakeasy-group': 'marketing', - 'x-speakeasy-name-override': 'update_push_template', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/marketing/campaigns': { - get: { - operationId: 'marketing_list_campaigns', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,created_at,updated_at,description,schedule_type,status,channels,first_sent_at,last_sent_at,tags,messages,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of campaigns was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CampaignsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List campaigns', - tags: ['Campaigns'], - 'x-speakeasy-group': 'marketing', - 'x-speakeasy-name-override': 'list_campaigns', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/marketing/campaigns/{id}': { - get: { - operationId: 'marketing_get_campaign', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,created_at,updated_at,description,schedule_type,status,channels,first_sent_at,last_sent_at,tags,messages,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The campaign with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CampaignResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get campaign', - tags: ['Campaigns'], - 'x-speakeasy-group': 'marketing', - 'x-speakeasy-name-override': 'get_campaign', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/marketing/content_blocks': { - get: { - operationId: 'marketing_list_content_blocks', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,type,content,status,tags,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of Content Blocks was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ContentBlocksPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Content Blocks', - tags: ['Content Blocks'], - 'x-speakeasy-group': 'marketing', - 'x-speakeasy-name-override': 'list_content_blocks', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - post: { - operationId: 'marketing_create_content_block', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/MarketingCreateContentBlocksRequestDto', - }, - }, - }, - }, - responses: { - '201': { - description: 'Record created successfully.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CreateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Create Content Block', - tags: ['Content Blocks'], - 'x-speakeasy-group': 'marketing', - 'x-speakeasy-name-override': 'create_content_block', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/marketing/content_blocks/{id}': { - get: { - operationId: 'marketing_get_content_block', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,name,type,content,status,tags,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The Content Block with the given identifier was retrieved', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ContentBlockResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Content Blocks', - tags: ['Content Blocks'], - 'x-speakeasy-group': 'marketing', - 'x-speakeasy-name-override': 'get_content_block', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - patch: { - operationId: 'marketing_update_content_block', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/MarketingCreateContentBlocksRequestDto', - }, - }, - }, - }, - responses: { - '200': { - description: 'Record updated successfully', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CreateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Update Content Block', - tags: ['Content Blocks'], - 'x-speakeasy-group': 'marketing', - 'x-speakeasy-name-override': 'update_content_block', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - }, - info: { - title: 'Marketing', - description: 'The documentation for the StackOne Unified API - MARKETING', - version: '1.0.0', - contact: {}, - }, - tags: [ - { - name: 'Campaigns', - description: 'Marketing campaigns and initiatives.', - }, - { - name: 'Content Blocks', - description: 'Reusable content blocks for marketing.', - }, - { - name: 'Email', - description: 'Email marketing messages.', - }, - { - name: 'In App', - description: 'In-app marketing messages.', - }, - { - name: 'Omni-Channel', - description: 'Omni-channel marketing communications.', - }, - { - name: 'Push', - description: 'Push notifications for marketing.', - }, - { - name: 'SMS', - description: 'SMS marketing messages.', - }, - { - name: 'Templates', - description: 'Templates for marketing content or campaigns.', - }, - ], - servers: [ - { - url: 'https://api.stackone.com', - }, - ], - components: { - securitySchemes: { - basic: { - type: 'http', - scheme: 'basic', - }, - }, - schemas: { - BadGatewayResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 502, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Bad Gateway', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - BadRequestResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 400, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Bad Request', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - data: { - description: 'Error details', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/UnifiedError', - }, - ], - }, - provider_errors: { - description: 'List of provider-specific errors', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/ProviderError', - }, - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - Campaign: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - nullable: true, - }, - created_at: { - type: 'string', - description: 'The created_at date', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'The updated_at date', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - description: { - type: 'string', - nullable: true, - }, - schedule_type: { - description: 'The schedule type', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/ScheduleTypeEnum', - }, - ], - }, - status: { - description: 'Status of the Campaign', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/StatusEnum', - }, - ], - }, - archived: { - oneOf: [ - { - type: 'boolean', - }, - { - type: 'string', - enum: ['true', 'false'], - }, - ], - nullable: true, - }, - draft: { - oneOf: [ - { - type: 'boolean', - }, - { - type: 'string', - enum: ['true', 'false'], - }, - ], - nullable: true, - }, - channels: { - description: 'channels of the Campaign', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/ChannelsEnum', - }, - }, - first_sent_at: { - type: 'string', - description: 'The first_sent_at date', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - last_sent_at: { - type: 'string', - description: 'The last_sent_at date', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - tags: { - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - messages: { - example: [ - { - id: 'message-id-1', - name: 'SMS Message', - message_type: { - value: 'sms', - sourceValue: 'sms-message', - }, - message_content: { - body: 'This is an example SMS body.', - from: '1-555-123-4567', - }, - }, - { - id: 'message-id-2', - name: 'Email Message', - message_type: { - value: 'email', - sourceValue: 'email-message', - }, - message_content: { - subject: 'Example Email Subject', - body: 'email body
', - from: 'Jane Smith', - 'reply-to': 'reply@example.com', - preheader: 'This is the preheader of the email.', - }, - }, - { - id: 'message-id-3', - name: 'iOS Push Message', - message_type: { - value: 'ios_push', - sourceValue: 'ios-push', - }, - message_content: { - body: 'This is an example push notification body.', - }, - }, - ], - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/Message', - }, - }, - }, - }, - CampaignResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/Campaign', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - CampaignsPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/Campaign', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - ChannelsEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'email', - 'sms', - 'web_push', - 'ios_push', - 'android_push', - 'unknown', - 'unmapped_value', - null, - ], - description: 'The Channels of the campaign.', - example: 'sms', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - description: 'The source value of the Channels.', - example: 'SMS', - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - ConflictResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 409, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Conflict', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - ContentBlock: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - nullable: true, - }, - tags: { - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - content: { - type: 'string', - nullable: true, - }, - type: { - description: 'Stackone enum identifying the type of content block.', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/ContentBlockTypeEnumApiModel', - }, - ], - }, - status: { - description: 'Stackone enum identifying the status of content block.', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/ContentBlockStatusEnumApiModel', - }, - ], - }, - created_at: { - type: 'string', - description: 'Date of creation', - example: '2021-01-01T00:00:00.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'Date of last update', - example: '2021-01-01T00:00:00.000Z', - format: 'date-time', - nullable: true, - }, - }, - }, - ContentBlockResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/ContentBlock', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - ContentBlocksPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/ContentBlock', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - ContentBlockStatusEnumApiModel: { - type: 'object', - properties: { - value: { - type: 'string', - enum: ['draft', 'live', 'archived', 'unmapped_value', null], - description: 'The Status of the content blocks.', - example: 'live', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - description: 'The source value of the status.', - example: 'active', - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - ContentBlockTypeEnumApiModel: { - type: 'object', - properties: { - value: { - type: 'string', - enum: ['text', 'html', 'image', 'code-snippet', 'unmapped_value', null], - description: 'The type of the content blocks.', - example: 'html', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - description: 'The source value of the type.', - example: 'text', - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - CreateMessage: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - nullable: true, - }, - message_type: { - description: - 'Stackone enum identifying the type of message associated with the content.', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/MessageTypeEnum', - }, - ], - }, - message_content: { - oneOf: [ - { - $ref: '#/components/schemas/SmsMessageContents', - }, - { - $ref: '#/components/schemas/EmailMessageContents', - }, - { - $ref: '#/components/schemas/PushMessageContents', - }, - ], - nullable: true, - }, - }, - }, - CreateResult: { - type: 'object', - properties: { - statusCode: { - type: 'number', - example: 201, - }, - message: { - type: 'string', - example: 'Record created successfully.', - }, - timestamp: { - type: 'string', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - }, - data: { - $ref: '#/components/schemas/CreateResultDataApiModel', - }, - }, - required: ['statusCode', 'message', 'timestamp', 'data'], - }, - CreateResultDataApiModel: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - }, - }, - EmailMessageContents: { - type: 'object', - properties: { - subject: { - type: 'string', - nullable: true, - }, - body: { - type: 'string', - nullable: true, - }, - from: { - type: 'string', - nullable: true, - }, - 'reply-to': { - type: 'string', - nullable: true, - }, - preheader: { - type: 'string', - nullable: true, - }, - }, - }, - EmailMessages: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - nullable: true, - }, - message_type: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/MessageTypeEnum', - }, - ], - }, - message_content: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/EmailMessageContents', - }, - ], - }, - }, - }, - EmailTemplate: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - nullable: true, - }, - tags: { - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - created_at: { - type: 'string', - description: 'Date of creation', - example: '2021-01-01T00:00:00.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'Date of last update', - example: '2021-01-01T00:00:00.000Z', - format: 'date-time', - nullable: true, - }, - messages: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/EmailMessages', - }, - }, - }, - }, - EmailTemplateResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/EmailTemplate', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - EmailTemplatesPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/EmailTemplate', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - ForbiddenResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 403, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Forbidden resource', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - InAppMessageContents: { - type: 'object', - properties: { - body: { - type: 'string', - nullable: true, - }, - }, - }, - InAppMessages: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - nullable: true, - }, - message_type: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/MessageTypeEnum', - }, - ], - }, - message_content: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/InAppMessageContents', - }, - ], - }, - }, - }, - InAppTemplate: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - nullable: true, - }, - tags: { - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - created_at: { - type: 'string', - description: 'Date of creation', - example: '2021-01-01T00:00:00.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'Date of last update', - example: '2021-01-01T00:00:00.000Z', - format: 'date-time', - nullable: true, - }, - messages: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/InAppMessages', - }, - }, - }, - }, - InAppTemplateResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/InAppTemplate', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - InAppTemplatesPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/InAppTemplate', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - InternalServerErrorResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 500, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Internal server error', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - MarketingCreateContentBlocksRequestDto: { - type: 'object', - properties: { - name: { - type: 'string', - nullable: true, - }, - tags: { - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - content: { - type: 'string', - nullable: true, - }, - type: { - description: 'Stackone enum identifying the type of content block.', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/ContentBlockTypeEnumApiModel', - }, - ], - }, - passthrough: { - type: 'object', - description: 'Value to pass through to the provider', - example: { - other_known_names: 'John Doe', - }, - additionalProperties: true, - nullable: true, - }, - }, - }, - MarketingCreateEmailTemplateRequestDto: { - type: 'object', - properties: { - name: { - type: 'string', - nullable: true, - }, - tags: { - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - messages: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/EmailMessages', - }, - }, - passthrough: { - type: 'object', - description: 'Value to pass through to the provider', - example: { - other_known_names: 'John Doe', - }, - additionalProperties: true, - nullable: true, - }, - }, - }, - MarketingCreateInAppTemplateRequestDto: { - type: 'object', - properties: { - name: { - type: 'string', - nullable: true, - }, - tags: { - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - messages: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/InAppMessages', - }, - }, - passthrough: { - type: 'object', - description: 'Value to pass through to the provider', - example: { - other_known_names: 'John Doe', - }, - additionalProperties: true, - nullable: true, - }, - }, - }, - MarketingCreatePushTemplateRequestDto: { - type: 'object', - properties: { - name: { - type: 'string', - nullable: true, - }, - tags: { - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - messages: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/PushMessages', - }, - }, - passthrough: { - type: 'object', - description: 'Value to pass through to the provider', - example: { - other_known_names: 'John Doe', - }, - additionalProperties: true, - nullable: true, - }, - }, - }, - MarketingCreateSmsTemplateRequestDto: { - type: 'object', - properties: { - name: { - type: 'string', - nullable: true, - }, - tags: { - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - messages: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/SmsMessages', - }, - }, - passthrough: { - type: 'object', - description: 'Value to pass through to the provider', - example: { - other_known_names: 'John Doe', - }, - additionalProperties: true, - nullable: true, - }, - }, - }, - MarketingCreateTemplateRequestDto: { - type: 'object', - properties: { - messages: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/CreateMessage', - }, - }, - name: { - type: 'string', - nullable: true, - }, - tags: { - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - passthrough: { - type: 'object', - description: 'Value to pass through to the provider', - example: { - other_known_names: 'John Doe', - }, - additionalProperties: true, - nullable: true, - }, - }, - }, - Message: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - nullable: true, - }, - message_type: { - description: - 'Stackone enum identifying the type of message associated with the content.', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/MessageTypeEnum', - }, - ], - }, - message_content: { - oneOf: [ - { - $ref: '#/components/schemas/SmsMessageContents', - }, - { - $ref: '#/components/schemas/EmailMessageContents', - }, - { - $ref: '#/components/schemas/PushMessageContents', - }, - ], - nullable: true, - }, - }, - }, - MessageTypeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'email', - 'sms', - 'push', - 'web_push', - 'ios_push', - 'android_push', - 'app_push', - 'omni_channel', - 'content_block', - 'in_app', - 'unknown', - 'unmapped_value', - null, - ], - description: 'The unified message type.', - example: 'email', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - description: - 'The original value from the provider used to derive the unified message type.', - example: 'Email', - nullable: true, - }, - }, - }, - NotFoundResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 404, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Not Found', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - NotImplementedResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 501, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Not Implemented', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - PreconditionFailedResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 412, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Precondition failed', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - ProviderError: { - type: 'object', - properties: { - status: { - type: 'number', - description: 'HTTP status code of the provider error', - example: 400, - nullable: true, - }, - url: { - type: 'string', - description: 'URL that caused the error', - example: 'https://api.provider.com/v1/resource', - nullable: true, - }, - raw: { - type: 'object', - description: 'Raw error response from the provider', - example: { - message: 'Invalid input parameters', - }, - nullable: true, - }, - headers: { - type: 'object', - description: 'Response headers', - example: { - 'content-type': 'application/json', - 'x-request-id': '5678c28b211dace4e0a0f9171e6b88c5', - }, - nullable: true, - }, - }, - }, - PushMessageContents: { - type: 'object', - properties: { - title: { - type: 'string', - nullable: true, - }, - subtitle: { - type: 'string', - nullable: true, - }, - body: { - type: 'string', - nullable: true, - }, - }, - }, - PushMessages: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - nullable: true, - }, - message_type: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/MessageTypeEnum', - }, - ], - }, - message_content: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/PushMessageContents', - }, - ], - }, - }, - }, - PushTemplate: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - nullable: true, - }, - tags: { - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - created_at: { - type: 'string', - description: 'Date of creation', - example: '2021-01-01T00:00:00.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'Date of last update', - example: '2021-01-01T00:00:00.000Z', - format: 'date-time', - nullable: true, - }, - messages: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/PushMessages', - }, - }, - }, - }, - PushTemplateResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/PushTemplate', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - PushTemplatesPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/PushTemplate', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - RawResponse: { - type: 'object', - properties: { - method: { - type: 'string', - }, - url: { - type: 'string', - }, - body: { - oneOf: [ - { - type: 'string', - }, - { - type: 'object', - }, - { - type: 'array', - items: { - type: 'integer', - format: 'int32', - minimum: 0, - maximum: 255, - }, - }, - ], - additionalProperties: true, - nullable: true, - }, - response: { - oneOf: [ - { - type: 'object', - additionalProperties: true, - }, - { - type: 'array', - items: {}, - }, - { - type: 'string', - }, - ], - nullable: true, - }, - }, - required: ['method', 'url'], - }, - RequestTimedOutResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 408, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Request timed out', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - ScheduleTypeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: [ - 'immediate', - 'scheduled', - 'recurring', - 'custom', - 'triggered', - 'unmapped_value', - null, - ], - description: 'The schedule type of the campaign.', - example: 'immediate', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - description: 'The source value of the schedule type.', - example: 'Immediate', - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - SmsMessageContents: { - type: 'object', - properties: { - body: { - type: 'string', - nullable: true, - }, - from: { - type: 'string', - nullable: true, - }, - }, - }, - SmsMessages: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - nullable: true, - }, - message_type: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/MessageTypeEnum', - }, - ], - }, - message_content: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/SmsMessageContents', - }, - ], - }, - }, - }, - SmsTemplate: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - nullable: true, - }, - tags: { - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - created_at: { - type: 'string', - description: 'Date of creation', - example: '2021-01-01T00:00:00.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'Date of last update', - example: '2021-01-01T00:00:00.000Z', - format: 'date-time', - nullable: true, - }, - messages: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/SmsMessages', - }, - }, - }, - }, - SmsTemplateResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/SmsTemplate', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - SmsTemplatesPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/SmsTemplate', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - StatusEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: ['draft', 'archived', 'live', 'unmapped_value', null], - description: 'The Status of the campaign.', - example: 'email', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - description: 'The source value of the Status.', - example: 'Email', - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - Template: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - nullable: true, - }, - tags: { - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - created_at: { - type: 'string', - description: 'Date of creation', - example: '2021-01-01T00:00:00.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'Date of last update', - example: '2021-01-01T00:00:00.000Z', - format: 'date-time', - nullable: true, - }, - }, - }, - TemplateResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/Template', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - TemplatesPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/Template', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - TooManyRequestsResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 429, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Too many requests', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - UnauthorizedResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 401, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Unauthorized', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - UnifiedError: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 400, - nullable: true, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Bad Request', - nullable: true, - }, - headers: { - type: 'object', - description: 'Response headers', - example: { - 'content-type': 'application/json', - 'x-request-id': '5678c28b211dace4e0a0f9171e6b88c5', - }, - nullable: true, - }, - }, - }, - UnprocessableEntityResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 422, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Unprocessable Entity', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - }, - }, -}; diff --git a/src/openapi/generated/messaging.ts b/src/openapi/generated/messaging.ts deleted file mode 100644 index e57f1cbb..00000000 --- a/src/openapi/generated/messaging.ts +++ /dev/null @@ -1,3704 +0,0 @@ -// Generated OpenAPI specification for messaging -// DO NOT EDIT THIS FILE DIRECTLY -export const messagingSpec = { - openapi: '3.1.0', - paths: { - '/unified/messaging/conversations': { - get: { - operationId: 'messaging_list_conversations', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,participants,name,private,created_at,last_message_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of conversations was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/MessagingConversationsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Conversations', - tags: ['Conversations'], - 'x-speakeasy-group': 'messaging', - 'x-speakeasy-name-override': 'list_conversations', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - post: { - operationId: 'messaging_create_conversation', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/MessagingCreateConversationRequestDto', - }, - }, - }, - }, - responses: { - '201': { - description: 'The conversation was created successfully.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CreateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Create Conversation', - tags: ['Conversations'], - 'x-speakeasy-group': 'messaging', - 'x-speakeasy-name-override': 'create_conversation', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/messaging/conversations/{id}': { - get: { - operationId: 'messaging_get_conversation', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,participants,name,private,created_at,last_message_at,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The conversation with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/MessagingConversationResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Conversation', - tags: ['Conversations'], - 'x-speakeasy-group': 'messaging', - 'x-speakeasy-name-override': 'get_conversation', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/messaging/messages/{id}/attachments/{subResourceId}/download': { - get: { - operationId: 'messaging_download_messaging_attachment', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'subResourceId', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'format', - required: false, - in: 'query', - description: 'The format to download the file in', - schema: { - nullable: true, - example: 'base64', - type: 'string', - }, - }, - { - name: 'export_format', - required: false, - in: 'query', - description: 'The export format of the file', - schema: { - nullable: true, - example: 'text/plain', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The attachment file was downloaded successfully.', - content: { - '*/*': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Download Attachment', - tags: ['Messages', 'Attachments'], - 'x-speakeasy-group': 'messaging', - 'x-speakeasy-name-override': 'download_messaging_attachment', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/messaging/messages/{id}/attachments': { - get: { - operationId: 'messaging_list_attachments', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,file_name,file_size,file_type,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of attachments was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/MessagingAttachmentsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Attachments', - tags: ['Messages', 'Attachments'], - 'x-speakeasy-group': 'messaging', - 'x-speakeasy-name-override': 'list_attachments', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/messaging/messages/{id}/attachments/{subResourceId}': { - get: { - operationId: 'messaging_get_attachment', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'subResourceId', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,file_name,file_size,file_type,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The attachment with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/MessagingAttachmentResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Attachment', - tags: ['Messages', 'Attachments'], - 'x-speakeasy-group': 'messaging', - 'x-speakeasy-name-override': 'get_attachment', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/messaging/users': { - get: { - operationId: 'messaging_list_users', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,email,username,name,first_name,last_name,bot,active,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of users was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/MessagingUsersPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Users', - tags: ['Users'], - 'x-speakeasy-group': 'messaging', - 'x-speakeasy-name-override': 'list_users', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/messaging/users/{id}': { - get: { - operationId: 'messaging_get_user', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,email,username,name,first_name,last_name,bot,active,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The user with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/MessagingUserResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get User', - tags: ['Users'], - 'x-speakeasy-group': 'messaging', - 'x-speakeasy-name-override': 'get_user', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/messaging/conversations/{id}/messages': { - get: { - operationId: 'messaging_list_conversation_messages', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,content,parent_message_id,remote_parent_message_id,attachments,author,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of messages in the conversation was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/MessagingMessagesPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Conversation Messages', - tags: ['Conversations', 'Messages'], - 'x-speakeasy-group': 'messaging', - 'x-speakeasy-name-override': 'list_conversation_messages', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/messaging/messages/{id}': { - get: { - operationId: 'messaging_get_message', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,content,parent_message_id,remote_parent_message_id,attachments,author,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - explode: true, - style: 'deepObject', - schema: { - type: 'object', - }, - }, - ], - responses: { - '200': { - description: 'The message was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/MessagingMessageResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Message', - tags: ['Messages'], - 'x-speakeasy-group': 'messaging', - 'x-speakeasy-name-override': 'get_message', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/messaging/messages': { - post: { - operationId: 'messaging_send_message', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/MessagingMessageSendRequestDto', - }, - }, - }, - }, - responses: { - '201': { - description: 'The message was sent successfully.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CreateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Send Message', - tags: ['Messages'], - 'x-speakeasy-group': 'messaging', - 'x-speakeasy-name-override': 'send_message', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - }, - info: { - title: 'Messaging', - description: 'The documentation for the StackOne Unified API - MESSAGING', - version: '1.0.0', - contact: {}, - }, - tags: [ - { - name: 'Conversations', - description: 'Spaces for exchanging messages between users.', - }, - { - name: 'Messages', - description: 'Messages exchanged in conversations.', - }, - { - name: 'Attachments', - description: 'Files attached to messages.', - }, - { - name: 'Users', - description: 'Accounts that can participate in conversations.', - }, - ], - servers: [ - { - url: 'https://api.stackone.com', - }, - ], - components: { - securitySchemes: { - basic: { - type: 'http', - scheme: 'basic', - }, - }, - schemas: { - BadGatewayResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 502, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Bad Gateway', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - BadRequestResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 400, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Bad Request', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - data: { - description: 'Error details', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/UnifiedError', - }, - ], - }, - provider_errors: { - description: 'List of provider-specific errors', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/ProviderError', - }, - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - ConflictResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 409, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Conflict', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - CreateResult: { - type: 'object', - properties: { - statusCode: { - type: 'number', - example: 201, - }, - message: { - type: 'string', - example: 'Record created successfully.', - }, - timestamp: { - type: 'string', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - }, - data: { - $ref: '#/components/schemas/CreateResultDataApiModel', - }, - }, - required: ['statusCode', 'message', 'timestamp', 'data'], - }, - CreateResultDataApiModel: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - }, - }, - DownloadApiModel: { - type: 'object', - properties: { - headers: { - description: 'Headers related to the download', - allOf: [ - { - $ref: '#/components/schemas/DownloadHeadersApiModel', - }, - ], - }, - data: { - type: 'string', - description: 'The file data in binary format', - format: 'binary', - }, - }, - required: ['headers', 'data'], - }, - DownloadHeadersApiModel: { - type: 'object', - properties: { - 'content-disposition': { - type: 'string', - description: 'Value of the Content-Disposition header', - example: 'attachment; filename="example.pdf"', - nullable: true, - }, - 'content-type': { - type: 'string', - description: 'MIME type of the file', - example: 'application/pdf', - nullable: true, - }, - 'content-length': { - type: 'number', - description: 'Size of the content in bytes', - example: 1024, - nullable: true, - }, - 'content-range': { - type: 'string', - description: 'Range of the content being sent', - example: 'bytes 0-1023/2048', - nullable: true, - }, - 'content-encoding': { - type: 'string', - description: 'Encoding of the content', - example: 'gzip', - nullable: true, - }, - 'transfer-encoding': { - type: 'string', - description: 'Transfer encoding type', - example: 'chunked', - nullable: true, - }, - }, - }, - ForbiddenResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 403, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Forbidden resource', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - InternalServerErrorResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 500, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Internal server error', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - LmsUser: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - external_reference: { - type: 'string', - description: 'The external ID associated with this user', - example: 'al60043', - nullable: true, - }, - name: { - type: 'string', - description: 'The user name', - example: 'John Dew', - nullable: true, - }, - email: { - type: 'string', - description: 'The user email', - example: 'john@dew.com', - nullable: true, - }, - phone_number: { - type: 'string', - description: 'The user phone number', - example: '+1234567890', - nullable: true, - }, - active: { - description: 'The user active status', - example: true, - oneOf: [ - { - type: 'boolean', - }, - { - type: 'string', - enum: ['true', 'false'], - }, - ], - nullable: true, - }, - created_at: { - type: 'string', - description: 'The created_at date', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'The updated_at date', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - }, - }, - MessagingAttachment: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - file_name: { - type: 'string', - description: 'Name of the attached file', - example: 'document.pdf', - nullable: true, - }, - file_size: { - type: 'number', - description: 'Size of the attached file', - example: 1024, - nullable: true, - }, - file_type: { - type: 'string', - description: 'MIME type of the attached file', - example: 'application/pdf', - nullable: true, - }, - }, - }, - MessagingAttachmentResult: { - type: 'object', - properties: { - data: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/MessagingAttachment', - }, - ], - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - }, - MessagingAttachmentsPaginated: { - type: 'object', - properties: { - next: { - type: 'string', - nullable: true, - }, - data: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/MessagingAttachment', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - }, - MessagingConversation: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - participants: { - description: 'List of participant user IDs in the conversation', - example: ['c28xIQ1', 'c28xIQ2'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - name: { - type: 'string', - description: 'Name or title of the conversation', - example: 'Project Discussion', - nullable: true, - }, - private: { - description: 'Whether the conversation is private', - example: true, - oneOf: [ - { - type: 'boolean', - }, - { - type: 'string', - enum: ['true', 'false'], - }, - ], - nullable: true, - }, - created_at: { - type: 'string', - description: 'Timestamp when the conversation was created', - example: '2024-03-20T10:00:00Z', - format: 'date-time', - nullable: true, - }, - last_message_at: { - type: 'string', - description: 'Timestamp of the last message in the conversation', - example: '2024-03-20T11:30:00Z', - format: 'date-time', - nullable: true, - }, - }, - }, - MessagingConversationResult: { - type: 'object', - properties: { - data: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/MessagingConversation', - }, - ], - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - }, - MessagingConversationsPaginated: { - type: 'object', - properties: { - next: { - type: 'string', - nullable: true, - }, - data: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/MessagingConversation', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - }, - MessagingCreateConversationRequestDto: { - type: 'object', - properties: { - participants: { - description: 'List of participant user IDs in the conversation', - example: ['c28xIQ1', 'c28xIQ2'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - name: { - type: 'string', - description: 'Name or title of the conversation', - example: 'Project Discussion', - nullable: true, - }, - private: { - description: 'Whether the conversation is private', - example: true, - oneOf: [ - { - type: 'boolean', - }, - { - type: 'string', - enum: ['true', 'false'], - }, - ], - nullable: true, - }, - }, - }, - MessagingMessage: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - content: { - description: 'Content of the message', - example: { - html: 'Hello world
', - plain: 'Hello world', - }, - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/MessagingMessageContent', - }, - ], - }, - parent_message_id: { - type: 'string', - description: 'ID of the parent message if this is a reply', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - attachments: { - description: 'List of attachments in the message', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/MessagingAttachment', - }, - }, - author: { - description: 'Author of the message', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/LmsUser', - }, - ], - }, - created_at: { - type: 'string', - description: 'Timestamp when the message was created', - example: '2024-03-20T10:00:00Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'Timestamp when the message was last updated', - example: '2024-03-20T10:00:00Z', - format: 'date-time', - nullable: true, - }, - }, - }, - MessagingMessageContent: { - type: 'object', - properties: { - html: { - type: 'string', - description: 'HTML content of the message', - example: 'Hello world
', - nullable: true, - }, - plain: { - type: 'string', - description: 'Plain text content of the message', - example: 'Hello world', - nullable: true, - }, - }, - }, - MessagingMessageResult: { - type: 'object', - properties: { - data: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/MessagingMessage', - }, - ], - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - }, - MessagingMessageSendRequestDto: { - type: 'object', - properties: { - content: { - type: 'string', - description: 'Content body of the message', - example: 'Hello, world!', - nullable: true, - }, - recipient: { - type: 'string', - description: 'Can be a conversation ID, user ID, email or phone number.', - example: 'c28xyrc55866bvuv', - nullable: true, - }, - sender: { - type: 'string', - description: 'The account_id or phone number of the message sender', - example: '+34820398402', - nullable: true, - }, - }, - }, - MessagingMessagesPaginated: { - type: 'object', - properties: { - next: { - type: 'string', - nullable: true, - }, - data: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/MessagingMessage', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - }, - MessagingUser: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - email: { - type: 'string', - description: 'Email address of the user', - example: 'john.doe@example.com', - nullable: true, - }, - username: { - type: 'string', - description: 'Username of the user', - example: 'johndoe', - nullable: true, - }, - name: { - type: 'string', - description: 'Full name of the user', - example: 'John Doe', - nullable: true, - }, - first_name: { - type: 'string', - description: 'First name of the user', - example: 'John', - nullable: true, - }, - last_name: { - type: 'string', - description: 'Last name of the user', - example: 'Doe', - nullable: true, - }, - bot: { - description: 'Whether the user is a bot', - example: false, - oneOf: [ - { - type: 'boolean', - }, - { - type: 'string', - enum: ['true', 'false'], - }, - ], - nullable: true, - }, - active: { - description: 'Whether the user is active', - example: true, - oneOf: [ - { - type: 'boolean', - }, - { - type: 'string', - enum: ['true', 'false'], - }, - ], - nullable: true, - }, - }, - }, - MessagingUserResult: { - type: 'object', - properties: { - data: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/MessagingUser', - }, - ], - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - }, - MessagingUsersPaginated: { - type: 'object', - properties: { - next: { - type: 'string', - nullable: true, - }, - data: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/MessagingUser', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - }, - NotFoundResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 404, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Not Found', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - NotImplementedResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 501, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Not Implemented', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - PreconditionFailedResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 412, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Precondition failed', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - ProviderError: { - type: 'object', - properties: { - status: { - type: 'number', - description: 'HTTP status code of the provider error', - example: 400, - nullable: true, - }, - url: { - type: 'string', - description: 'URL that caused the error', - example: 'https://api.provider.com/v1/resource', - nullable: true, - }, - raw: { - type: 'object', - description: 'Raw error response from the provider', - example: { - message: 'Invalid input parameters', - }, - nullable: true, - }, - headers: { - type: 'object', - description: 'Response headers', - example: { - 'content-type': 'application/json', - 'x-request-id': '5678c28b211dace4e0a0f9171e6b88c5', - }, - nullable: true, - }, - }, - }, - RawResponse: { - type: 'object', - properties: { - method: { - type: 'string', - }, - url: { - type: 'string', - }, - body: { - oneOf: [ - { - type: 'string', - }, - { - type: 'object', - }, - { - type: 'array', - items: { - type: 'integer', - format: 'int32', - minimum: 0, - maximum: 255, - }, - }, - ], - additionalProperties: true, - nullable: true, - }, - response: { - oneOf: [ - { - type: 'object', - additionalProperties: true, - }, - { - type: 'array', - items: {}, - }, - { - type: 'string', - }, - ], - nullable: true, - }, - }, - required: ['method', 'url'], - }, - RequestTimedOutResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 408, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Request timed out', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - TooManyRequestsResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 429, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Too many requests', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - UnauthorizedResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 401, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Unauthorized', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - UnifiedError: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 400, - nullable: true, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Bad Request', - nullable: true, - }, - headers: { - type: 'object', - description: 'Response headers', - example: { - 'content-type': 'application/json', - 'x-request-id': '5678c28b211dace4e0a0f9171e6b88c5', - }, - nullable: true, - }, - }, - }, - UnprocessableEntityResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 422, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Unprocessable Entity', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - }, - }, -}; diff --git a/src/openapi/generated/screening.ts b/src/openapi/generated/screening.ts deleted file mode 100644 index 77f1f0b7..00000000 --- a/src/openapi/generated/screening.ts +++ /dev/null @@ -1,1615 +0,0 @@ -// Generated OpenAPI specification for screening -// DO NOT EDIT THIS FILE DIRECTLY -export const screeningSpec = { - openapi: '3.1.0', - paths: { - '/unified/screening/packages': { - get: { - operationId: 'screening_list_screening_packages', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,name,description,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of screening packages was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ScreeningPackagesPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Screening Packages', - tags: ['Packages'], - 'x-speakeasy-group': 'screening', - 'x-speakeasy-name-override': 'list_screening_packages', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/screening/packages/{id}': { - get: { - operationId: 'screening_get_screening_package', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,name,description,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The screening package with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ScreeningPackageResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Screening Package', - tags: ['Packages'], - 'x-speakeasy-group': 'screening', - 'x-speakeasy-name-override': 'get_screening_package', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/screening/results/webhook': { - post: { - operationId: 'screening_webhook_screening_result', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ScreeningResultWebhook', - }, - }, - }, - }, - responses: { - '200': { - description: 'The screening result webhook was processed.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ScreeningResultWebhook', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Webhook Screening Result', - tags: ['Results'], - 'x-speakeasy-group': 'screening', - 'x-speakeasy-name-override': 'webhook_screening_result', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/screening/orders': { - post: { - operationId: 'screening_create_screening_order', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ScreeningCreateOrderRequestDto', - }, - }, - }, - }, - responses: { - '201': { - description: 'The screening order was created.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CreateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Create Screening Order', - tags: ['Orders'], - 'x-speakeasy-group': 'screening', - 'x-speakeasy-name-override': 'create_screening_order', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - }, - info: { - title: 'Screening', - description: 'The documentation for the StackOne Unified API - SCREENING', - version: '1.0.0', - contact: {}, - }, - tags: [ - { - name: 'Orders', - description: 'Requests for screening services.', - }, - { - name: 'Results', - description: 'Outcomes of screening services.', - }, - { - name: 'Packages', - description: 'Collections of screening services.', - }, - ], - servers: [ - { - url: 'https://api.stackone.com', - }, - ], - components: { - securitySchemes: { - basic: { - type: 'http', - scheme: 'basic', - }, - }, - schemas: { - BadGatewayResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 502, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Bad Gateway', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - BadRequestResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 400, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Bad Request', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - data: { - description: 'Error details', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/UnifiedError', - }, - ], - }, - provider_errors: { - description: 'List of provider-specific errors', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/ProviderError', - }, - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - ConflictResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 409, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Conflict', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - CreateResult: { - type: 'object', - properties: { - statusCode: { - type: 'number', - example: 201, - }, - message: { - type: 'string', - example: 'Record created successfully.', - }, - timestamp: { - type: 'string', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - }, - data: { - $ref: '#/components/schemas/CreateResultDataApiModel', - }, - }, - required: ['statusCode', 'message', 'timestamp', 'data'], - }, - CreateResultDataApiModel: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - }, - }, - ForbiddenResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 403, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Forbidden resource', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - InternalServerErrorResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 500, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Internal server error', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - NotFoundResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 404, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Not Found', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - NotImplementedResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 501, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Not Implemented', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - PreconditionFailedResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 412, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Precondition failed', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - ProviderError: { - type: 'object', - properties: { - status: { - type: 'number', - description: 'HTTP status code of the provider error', - example: 400, - nullable: true, - }, - url: { - type: 'string', - description: 'URL that caused the error', - example: 'https://api.provider.com/v1/resource', - nullable: true, - }, - raw: { - type: 'object', - description: 'Raw error response from the provider', - example: { - message: 'Invalid input parameters', - }, - nullable: true, - }, - headers: { - type: 'object', - description: 'Response headers', - example: { - 'content-type': 'application/json', - 'x-request-id': '5678c28b211dace4e0a0f9171e6b88c5', - }, - nullable: true, - }, - }, - }, - RawResponse: { - type: 'object', - properties: { - method: { - type: 'string', - }, - url: { - type: 'string', - }, - body: { - oneOf: [ - { - type: 'string', - }, - { - type: 'object', - }, - { - type: 'array', - items: { - type: 'integer', - format: 'int32', - minimum: 0, - maximum: 255, - }, - }, - ], - additionalProperties: true, - nullable: true, - }, - response: { - oneOf: [ - { - type: 'object', - additionalProperties: true, - }, - { - type: 'array', - items: {}, - }, - { - type: 'string', - }, - ], - nullable: true, - }, - }, - required: ['method', 'url'], - }, - RequestTimedOutResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 408, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Request timed out', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - ScreeningCreateOrderRequestDto: { - type: 'object', - properties: { - passthrough: { - type: 'object', - description: 'Value to pass through to the provider', - example: { - other_known_names: 'John Doe', - }, - additionalProperties: true, - nullable: true, - }, - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - package_id: { - type: 'string', - description: 'Package ID', - example: '54321', - }, - candidate: { - description: 'Candidate information', - allOf: [ - { - $ref: '#/components/schemas/ScreeningOrderCandidate', - }, - ], - }, - }, - required: ['package_id', 'candidate'], - }, - ScreeningOrderCandidate: { - type: 'object', - properties: { - first_name: { - type: 'string', - description: 'Candidate first name', - example: 'John', - nullable: true, - }, - last_name: { - type: 'string', - description: 'Candidate last name', - example: 'Doe', - nullable: true, - }, - email: { - type: 'string', - description: 'Candidate email', - example: 'john.doe@example.com', - nullable: true, - }, - }, - }, - ScreeningPackage: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - name: { - type: 'string', - description: 'The name of the screening package', - example: 'Basic Background Check', - }, - description: { - type: 'string', - description: 'The description of the screening package', - example: 'Basic background check including identity verification and criminal records', - nullable: true, - }, - }, - required: ['name'], - }, - ScreeningPackageResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/ScreeningPackage', - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - ScreeningPackagesPaginated: { - type: 'object', - properties: { - next_page: { - type: 'string', - deprecated: true, - nullable: true, - }, - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/ScreeningPackage', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['data'], - }, - ScreeningResult: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - order_id: { - type: 'string', - description: 'Order ID associated with this result', - example: '12345', - nullable: true, - }, - score: { - description: 'Score information', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/ScreeningResultScore', - }, - ], - }, - start_date: { - type: 'string', - description: 'Start date of the screening', - example: '2023-01-01T00:00:00Z', - format: 'date-time', - nullable: true, - }, - submission_date: { - type: 'string', - description: 'Submission date of the screening', - example: '2023-01-02T00:00:00Z', - format: 'date-time', - nullable: true, - }, - summary: { - type: 'string', - description: 'Summary of the screening result', - example: 'Background check completed successfully', - nullable: true, - }, - status: { - type: 'string', - description: 'Result status', - example: 'completed', - enum: [ - 'pending', - 'in_progress', - 'completed', - 'failed', - 'cancelled', - 'unmapped_value', - null, - ], - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - result_url: { - type: 'string', - description: 'URL to view the detailed result', - example: 'https://example.com/results/12345', - nullable: true, - }, - }, - }, - ScreeningResultScore: { - type: 'object', - properties: { - label: { - type: 'string', - description: 'Score label', - example: 'Overall Risk', - nullable: true, - }, - value: { - type: 'string', - description: 'Score value', - example: '75', - nullable: true, - }, - min: { - type: 'string', - description: 'Minimum score value', - example: '0', - nullable: true, - }, - max: { - type: 'string', - description: 'Maximum score value', - example: '100', - nullable: true, - }, - }, - }, - ScreeningResultWebhook: { - type: 'object', - properties: { - event: { - type: 'string', - description: 'The event type', - example: 'screening.result.completed', - enum: [ - 'screening.results.created', - 'screening.results.updated', - 'screening.results.completed', - 'screening.results.failed', - 'screening.results.cancelled', - ], - 'x-speakeasy-unknown-values': 'allow', - }, - data: { - description: 'The result data', - allOf: [ - { - $ref: '#/components/schemas/ScreeningResult', - }, - ], - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - required: ['event', 'data'], - }, - TooManyRequestsResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 429, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Too many requests', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - UnauthorizedResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 401, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Unauthorized', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - UnifiedError: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 400, - nullable: true, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Bad Request', - nullable: true, - }, - headers: { - type: 'object', - description: 'Response headers', - example: { - 'content-type': 'application/json', - 'x-request-id': '5678c28b211dace4e0a0f9171e6b88c5', - }, - nullable: true, - }, - }, - }, - UnprocessableEntityResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 422, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Unprocessable Entity', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - }, - }, -}; diff --git a/src/openapi/generated/stackone.ts b/src/openapi/generated/stackone.ts deleted file mode 100644 index de30ebc7..00000000 --- a/src/openapi/generated/stackone.ts +++ /dev/null @@ -1,6308 +0,0 @@ -// Generated OpenAPI specification for stackone -// DO NOT EDIT THIS FILE DIRECTLY -export const stackoneSpec = { - openapi: '3.1.0', - paths: { - '/connect_sessions': { - post: { - operationId: 'stackone_create_connect_session', - parameters: [], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConnectSessionCreate', - }, - }, - }, - }, - responses: { - '201': { - description: 'The details of the connect session created with token and auth link', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConnectSessionTokenAuthLink', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Create Connect Session', - tags: ['Connect Sessions'], - 'x-speakeasy-name-override': 'create_connect_session', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/connect_sessions/authenticate': { - post: { - operationId: 'stackone_authenticate_connect_session', - parameters: [], - requestBody: { - required: true, - description: 'The parameters to authenticate', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConnectSessionAuthenticate', - }, - }, - }, - }, - responses: { - '201': { - description: 'The details of the authenticated connect session.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConnectSession', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Authenticate Connect Session', - tags: ['Connect Sessions'], - 'x-speakeasy-name-override': 'authenticate_connect_session', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/accounts': { - get: { - operationId: 'stackone_list_linked_accounts', - parameters: [ - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - schema: { - nullable: true, - type: 'number', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page', - schema: { - nullable: true, - default: 25, - type: 'number', - }, - }, - { - name: 'provider', - required: false, - in: 'query', - description: 'The provider of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'origin_owner_id', - required: false, - in: 'query', - description: 'The origin owner identifier of the results to fetch', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'origin_owner_ids', - required: false, - in: 'query', - description: - 'The origin owner identifiers of the results to fetch (supports multiple IDs)', - schema: { - type: 'array', - items: { - type: 'string', - }, - }, - }, - { - name: 'providers', - required: false, - in: 'query', - description: 'The providers list of the results to fetch', - schema: { - type: 'array', - items: { - type: 'string', - }, - }, - }, - { - name: 'account_ids', - required: false, - in: 'query', - description: 'The providers list of the results to fetch', - schema: { - type: 'array', - items: { - type: 'string', - }, - }, - }, - { - name: 'status', - required: false, - in: 'query', - description: 'The status of the results to fetch', - schema: { - type: 'array', - items: { - type: 'string', - }, - }, - }, - ], - responses: { - '200': { - description: 'The list of accounts was retrieved.', - content: { - 'application/json': { - schema: { - type: 'array', - items: { - $ref: '#/components/schemas/LinkedAccount', - }, - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Accounts', - tags: ['Accounts'], - 'x-speakeasy-name-override': 'list_linked_accounts', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/accounts/{id}': { - get: { - operationId: 'stackone_get_account', - parameters: [ - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The account with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/LinkedAccount', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Account', - tags: ['Accounts'], - 'x-speakeasy-name-override': 'get_account', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - patch: { - operationId: 'stackone_update_account', - parameters: [ - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PatchAccountExternalDto', - }, - }, - }, - }, - responses: { - '200': { - description: 'The account with the given identifier was updated.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/LinkedAccount', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Update Account', - tags: ['Accounts'], - 'x-speakeasy-name-override': 'update_account', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - delete: { - operationId: 'stackone_delete_account', - parameters: [ - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The account with the given identifier was deleted.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/LinkedAccount', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Delete Account', - tags: ['Accounts'], - 'x-speakeasy-name-override': 'delete_account', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/accounts/{id}/meta': { - get: { - operationId: 'stackone_get_account_meta_info', - parameters: [ - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The meta information of the account was retrieved', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/LinkedAccountMeta', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Account Meta Information', - tags: ['Accounts'], - 'x-speakeasy-name-override': 'get_account_meta_info', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/requests/logs/steps': { - get: { - operationId: 'stackone_list_step_logs', - parameters: [ - { - name: 'order_by', - required: false, - in: 'query', - description: 'The field to order the results by.', - 'x-speakeasy-unknown-values': 'allow', - schema: { - additionalProperties: false, - nullable: true, - example: 'created_at', - type: 'string', - enum: ['provider', 'service', 'status', 'eventDatetime', 'duration', null], - }, - }, - { - name: 'order_direction', - required: false, - in: 'query', - description: 'The direction to order the results by.', - 'x-speakeasy-unknown-values': 'allow', - schema: { - additionalProperties: false, - nullable: true, - example: 'asc', - type: 'string', - enum: ['asc', 'desc', null], - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - maximum: 100, - nullable: true, - type: 'number', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - schema: { - properties: { - account_ids: { - description: 'A comma-separated list of account IDs to filter the results by.', - example: '45355976281015164504,45355976281015164505', - type: 'string', - nullable: true, - additionalProperties: false, - }, - start_date: { - description: 'A ISO8601 date string to filter the results by start_date.', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - end_date: { - description: 'A ISO8601 date string to filter the results by end_date.', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - request_ids: { - description: 'A comma-separated list of request IDs to filter the results by.', - example: - 'adbf752f-6457-4ddd-89b3-98ae2252b83b,adbf752f-6457-4ddd-89b3-98ae2252b83c', - type: 'string', - nullable: true, - additionalProperties: false, - }, - http_methods: { - description: 'A comma-separated list of HTTP methods to filter the results by.', - example: 'GET,POST', - type: 'string', - nullable: true, - additionalProperties: false, - }, - providers: { - description: 'A comma-separated list of provider keys to filter the results by.', - example: 'ashby,greenhouse', - type: 'string', - nullable: true, - additionalProperties: false, - }, - services: { - description: 'A comma-separated list of services to filter the results by.', - example: 'hris,ats', - type: 'string', - nullable: true, - additionalProperties: false, - }, - resources: { - description: 'A comma-separated list of resources to filter the results by.', - example: 'employees,users', - type: 'string', - nullable: true, - additionalProperties: false, - }, - child_resources: { - description: - 'A comma-separated list of child resources to filter the results by.', - example: 'documents,time-off', - type: 'string', - nullable: true, - additionalProperties: false, - }, - sub_resources: { - description: 'A comma-separated list of sub resources to filter the results by.', - example: 'documents,employees', - type: 'string', - nullable: true, - additionalProperties: false, - }, - actions: { - description: 'A comma-separated list of actions to filter the results by.', - example: 'download,upload', - type: 'string', - nullable: true, - additionalProperties: false, - }, - status_codes: { - description: 'A comma-separated list of status codes to filter the results by.', - example: '200,400', - type: 'string', - nullable: true, - additionalProperties: false, - }, - success: { - description: 'A boolean value to filter the results by success or failure.', - example: true, - type: 'boolean', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - ], - responses: { - '200': { - description: 'The list of step logs was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/StepLogsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Step Logs', - tags: ['Request Logs'], - 'x-speakeasy-name-override': 'list_step_logs', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/requests/logs/{id}': { - get: { - operationId: 'stackone_get_log', - parameters: [ - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'include', - required: false, - in: 'query', - description: - 'The include parameter allows you to include additional data in the response.', - 'x-speakeasy-unknown-values': 'allow', - schema: { - nullable: true, - example: 'step_logs', - type: 'string', - enum: ['step_logs', 'advanced_logs', null], - }, - }, - ], - responses: { - '200': { - description: 'The log was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnifiedLogResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Log', - tags: ['Request Logs'], - 'x-speakeasy-name-override': 'get_log', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/requests/logs': { - get: { - operationId: 'stackone_list_logs', - parameters: [ - { - name: 'order_by', - required: false, - in: 'query', - description: 'The field to order the results by.', - 'x-speakeasy-unknown-values': 'allow', - schema: { - additionalProperties: false, - nullable: true, - example: 'created_at', - type: 'string', - enum: ['provider', 'service', 'status', 'eventDatetime', 'duration', null], - }, - }, - { - name: 'order_direction', - required: false, - in: 'query', - description: 'The direction to order the results by.', - 'x-speakeasy-unknown-values': 'allow', - schema: { - additionalProperties: false, - nullable: true, - example: 'asc', - type: 'string', - enum: ['asc', 'desc', null], - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - maximum: 100, - nullable: true, - type: 'number', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'include', - required: false, - in: 'query', - description: - 'The include parameter allows you to include additional data in the response.', - 'x-speakeasy-unknown-values': 'allow', - schema: { - nullable: true, - example: 'step_logs', - type: 'string', - enum: ['step_logs', null], - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - schema: { - properties: { - account_ids: { - description: 'A comma-separated list of account IDs to filter the results by.', - example: '45355976281015164504,45355976281015164505', - type: 'string', - nullable: true, - additionalProperties: false, - }, - start_date: { - description: 'A ISO8601 date string to filter the results by start_date.', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - end_date: { - description: 'A ISO8601 date string to filter the results by end_date.', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - request_ids: { - description: 'A comma-separated list of request IDs to filter the results by.', - example: - 'adbf752f-6457-4ddd-89b3-98ae2252b83b,adbf752f-6457-4ddd-89b3-98ae2252b83c', - type: 'string', - nullable: true, - additionalProperties: false, - }, - source_types: { - description: 'A comma-separated list of source types to filter the results by.', - example: 'DASHBOARD,SYNTHETIC_WEBHOOK', - type: 'string', - nullable: true, - additionalProperties: false, - }, - source_values: { - description: 'A comma-separated list of source values to filter the results by.', - type: 'string', - nullable: true, - additionalProperties: false, - }, - source_ids: { - description: 'A comma-separated list of source IDs to filter the results by.', - type: 'string', - nullable: true, - additionalProperties: false, - }, - http_methods: { - description: 'A comma-separated list of HTTP methods to filter the results by.', - example: 'GET,POST', - type: 'string', - nullable: true, - additionalProperties: false, - }, - providers: { - description: 'A comma-separated list of provider keys to filter the results by.', - example: 'ashby,greenhouse', - type: 'string', - nullable: true, - additionalProperties: false, - }, - services: { - description: 'A comma-separated list of services to filter the results by.', - example: 'hris,ats', - type: 'string', - nullable: true, - additionalProperties: false, - }, - resources: { - description: 'A comma-separated list of resources to filter the results by.', - example: 'employees,users', - type: 'string', - nullable: true, - additionalProperties: false, - }, - child_resources: { - description: - 'A comma-separated list of child resources to filter the results by.', - example: 'documents,time-off', - type: 'string', - nullable: true, - additionalProperties: false, - }, - sub_resources: { - description: 'A comma-separated list of sub resources to filter the results by.', - example: 'documents,employees', - type: 'string', - nullable: true, - additionalProperties: false, - }, - actions: { - description: 'A comma-separated list of actions to filter the results by.', - example: 'download,upload', - type: 'string', - nullable: true, - additionalProperties: false, - }, - status_codes: { - description: 'A comma-separated list of status codes to filter the results by.', - example: '200,400', - type: 'string', - nullable: true, - additionalProperties: false, - }, - success: { - description: 'A boolean value to filter the results by success or failure.', - example: true, - type: 'boolean', - nullable: true, - additionalProperties: false, - }, - order_by: { - description: 'The field to order the results by.', - example: 'created_at', - type: 'string', - nullable: true, - enum: ['provider', 'service', 'status', 'eventDatetime', 'duration', null], - additionalProperties: false, - }, - order_direction: { - description: 'The direction to order the results by.', - example: 'asc', - type: 'string', - nullable: true, - enum: ['asc', 'desc', null], - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - ], - responses: { - '200': { - description: 'The list of logs was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnifiedLogsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Logs', - tags: ['Request Logs'], - 'x-speakeasy-name-override': 'list_logs', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/requests/platform-logs': { - get: { - operationId: 'stackone_list_platform_logs', - parameters: [ - { - name: 'order_by', - required: false, - in: 'query', - description: 'The field to order the results by.', - 'x-speakeasy-unknown-values': 'allow', - schema: { - additionalProperties: false, - nullable: true, - example: 'created_at', - type: 'string', - enum: ['provider', 'service', 'status', 'eventDatetime', 'duration', null], - }, - }, - { - name: 'order_direction', - required: false, - in: 'query', - description: 'The direction to order the results by.', - 'x-speakeasy-unknown-values': 'allow', - schema: { - additionalProperties: false, - nullable: true, - example: 'asc', - type: 'string', - enum: ['asc', 'desc', null], - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - maximum: 100, - nullable: true, - type: 'number', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - schema: { - properties: { - account_ids: { - description: 'A comma-separated list of account IDs to filter the results by.', - example: '45355976281015164504,45355976281015164505', - type: 'string', - nullable: true, - additionalProperties: false, - }, - start_date: { - description: 'A ISO8601 date string to filter the results by start_date.', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - end_date: { - description: 'A ISO8601 date string to filter the results by end_date.', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - request_ids: { - description: 'A comma-separated list of request IDs to filter the results by.', - example: - 'adbf752f-6457-4ddd-89b3-98ae2252b83b,adbf752f-6457-4ddd-89b3-98ae2252b83c', - type: 'string', - nullable: true, - additionalProperties: false, - }, - source_types: { - description: 'A comma-separated list of source types to filter the results by.', - example: 'DASHBOARD,SYNTHETIC_WEBHOOK', - type: 'string', - nullable: true, - additionalProperties: false, - }, - source_values: { - description: 'A comma-separated list of source values to filter the results by.', - type: 'string', - nullable: true, - additionalProperties: false, - }, - source_ids: { - description: 'A comma-separated list of source IDs to filter the results by.', - type: 'string', - nullable: true, - additionalProperties: false, - }, - http_methods: { - description: 'A comma-separated list of HTTP methods to filter the results by.', - example: 'GET,POST', - type: 'string', - nullable: true, - additionalProperties: false, - }, - categories: { - description: 'A comma-separated list of categories to filter the results by.', - example: 'hris,ats', - type: 'string', - nullable: true, - additionalProperties: false, - }, - resources: { - description: 'A comma-separated list of resources to filter the results by.', - example: 'employees,users', - type: 'string', - nullable: true, - additionalProperties: false, - }, - actions: { - description: 'A comma-separated list of actions to filter the results by.', - example: 'download,upload', - type: 'string', - nullable: true, - additionalProperties: false, - }, - status_codes: { - description: 'A comma-separated list of status codes to filter the results by.', - example: '200,400', - type: 'string', - nullable: true, - additionalProperties: false, - }, - success: { - description: 'A boolean value to filter the results by success or failure.', - example: true, - type: 'boolean', - nullable: true, - additionalProperties: false, - }, - order_by: { - description: 'The field to order the results by.', - example: 'created_at', - type: 'string', - nullable: true, - enum: ['provider', 'service', 'status', 'eventDatetime', 'duration', null], - additionalProperties: false, - }, - order_direction: { - description: 'The direction to order the results by.', - example: 'asc', - type: 'string', - nullable: true, - enum: ['asc', 'desc', null], - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - ], - responses: { - '200': { - description: 'The list of platform logs was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PlatformLogsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Platform Logs', - tags: ['Request Logs'], - 'x-speakeasy-name-override': 'list_platform_logs', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/connectors/meta': { - get: { - operationId: 'stackone_list_connectors_meta', - parameters: [ - { - name: 'include', - required: false, - in: 'query', - description: 'The comma separated list of data that will be included in the response', - schema: { - nullable: true, - example: 'field_path,unmapped_fields,resources,inactive,webhooks,static_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of connectors meta information was retrieved.', - content: { - 'application/json': { - schema: { - type: 'array', - items: { - $ref: '#/components/schemas/ConnectorsMeta', - }, - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Connector Meta Information', - tags: ['Connectors'], - 'x-speakeasy-name-override': 'list_connectors_meta', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/connectors/meta/{provider}': { - get: { - operationId: 'stackone_get_connector_meta', - parameters: [ - { - name: 'provider', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'include', - required: false, - in: 'query', - description: 'The comma separated list of data that will be included in the response', - schema: { - nullable: true, - example: 'field_path,unmapped_fields,resources,inactive,webhooks,static_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The connector meta information was retrieved', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConnectorsMeta', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Connector Meta Information', - tags: ['Connectors'], - 'x-speakeasy-name-override': 'get_connector_meta', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/mcp': { - post: { - description: 'Send JSON-RPC request to the MCP server over HTTP streaming transport', - operationId: 'stackone_mcp_post', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: - 'Account secure id for the target provider account (optional if x-account-id query parameter is provided)', - required: false, - schema: { - type: 'string', - }, - }, - { - name: 'x-account-id', - required: false, - in: 'query', - description: 'Account secure id (alternative to x-account-id header)', - schema: {}, - }, - { - name: 'mcp-session-id', - in: 'header', - description: 'Session id; omit for initialize, include for subsequent calls', - required: false, - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - description: 'JSON-RPC 2.0 message', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/JsonRpcMessageDto', - }, - examples: { - initialize: { - summary: 'Initialize session', - value: { - jsonrpc: '2.0', - method: 'initialize', - params: { - clientInfo: { - name: 'my-client', - version: '1.0.0', - }, - protocolVersion: '2025-03-26', - capabilities: {}, - }, - id: 'init-1', - }, - }, - toolsList: { - summary: 'List tools', - value: { - jsonrpc: '2.0', - method: 'tools/list', - params: {}, - id: 'tools-1', - }, - }, - toolsCall: { - summary: 'Call a tool', - value: { - jsonrpc: '2.0', - method: 'tools/call', - params: { - name: 'unified_hris_list_employees', - arguments: {}, - }, - id: 'call-1', - }, - }, - }, - }, - }, - }, - responses: { - '200': { - description: 'Processed successfully', - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - { - ApiKey: [], - }, - ], - summary: 'Send MCP JSON-RPC message', - tags: ['MCP'], - 'x-speakeasy-name-override': 'mcp_post', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - get: { - description: 'Open a dedicated Server-Sent Events stream for MCP notifications', - operationId: 'stackone_mcp_get', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: - 'Account secure id for the target provider account (optional if x-account-id query parameter is provided)', - required: false, - schema: { - type: 'string', - }, - }, - { - name: 'x-account-id', - required: false, - in: 'query', - description: 'Account secure id (alternative to x-account-id header)', - schema: {}, - }, - { - name: 'Accept', - in: 'header', - description: 'Must be text/event-stream', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'mcp-session-id', - in: 'header', - description: 'Session id', - required: true, - schema: { - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'SSE stream opened', - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - { - ApiKey: [], - }, - ], - summary: 'Open MCP SSE stream', - tags: ['MCP'], - 'x-speakeasy-name-override': 'mcp_get', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - delete: { - description: 'Close an existing MCP session for the provided session id', - operationId: 'stackone_mcp_delete', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: - 'Account secure id for the target provider account (optional if x-account-id query parameter is provided)', - required: false, - schema: { - type: 'string', - }, - }, - { - name: 'x-account-id', - required: false, - in: 'query', - description: 'Account secure id (alternative to x-account-id header)', - schema: {}, - }, - { - name: 'mcp-session-id', - in: 'header', - description: 'Session id', - required: true, - schema: { - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'Session closed', - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - { - ApiKey: [], - }, - ], - summary: 'Delete MCP session', - tags: ['MCP'], - 'x-speakeasy-name-override': 'mcp_delete', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/proxy': { - post: { - operationId: 'stackone_proxy_request', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - description: 'The request body', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ProxyRequestBody', - }, - }, - }, - }, - responses: { - '200': { - description: 'The proxy request was successful.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ProxyResponseApiModel', - }, - }, - }, - }, - '201': { - description: 'Resource was successfully created by the target service.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ProxyResponseApiModel', - }, - }, - }, - }, - '202': { - description: 'Request accepted by the target service.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ProxyResponseApiModel', - }, - }, - }, - }, - '204': { - description: 'Request succeeded with no content.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ProxyResponseApiModel', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Proxy Request', - tags: ['Proxy'], - 'x-speakeasy-name-override': 'proxy_request', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/actions': { - get: { - description: 'Retrieves a list of all actions metadata', - operationId: 'stackone_list_actions_meta', - parameters: [ - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'group_by', - required: false, - in: 'query', - description: 'The relation to group the results by', - schema: { - nullable: true, - default: 'connector', - example: ['connector'], - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Actions Metadata filters', - explode: true, - style: 'deepObject', - schema: { - properties: { - connectors: { - description: 'A comma-separated list of connectors to filter the results by.', - example: 'connector1,connector2', - type: 'string', - nullable: true, - additionalProperties: false, - }, - account_ids: { - description: 'A comma-separated list of account IDs to filter the results by.', - example: 'account1,account2', - type: 'string', - nullable: true, - additionalProperties: false, - }, - action_key: { - description: 'The action key to filter the results by', - example: 'action1', - type: 'string', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'include', - required: false, - in: 'query', - description: 'Additional data to include in the response', - schema: { - nullable: true, - example: ['action_details'], - type: 'array', - items: { - type: 'string', - enum: ['action_details'], - }, - }, - }, - ], - responses: { - '200': { - description: 'List of actions metadata', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ActionsMetaPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - summary: 'List all actions metadata', - tags: ['Actions'], - 'x-speakeasy-name-override': 'list_actions_meta', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/actions/rpc': { - post: { - description: 'Makes a remote procedure call to the specified action', - operationId: 'stackone_rpc_action', - parameters: [], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ActionsRpcRequestDto', - }, - }, - }, - }, - responses: { - '200': { - description: 'Action response', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ActionsRpcResponse', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - summary: 'Make an RPC call to an action', - tags: ['Actions'], - 'x-speakeasy-name-override': 'rpc_action', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - }, - info: { - title: 'StackOne', - description: 'The documentation for the StackOne API', - version: '1.0.0', - contact: {}, - }, - tags: [ - { - name: 'Accounts', - description: 'View and manage linked accounts.', - }, - { - name: 'Actions', - description: 'Retrieve Actions metadata and definitions.', - }, - { - name: 'AI', - description: 'AI-powered features.', - }, - { - name: 'Connect Sessions', - description: - 'Generate connection session tokens or auth URLs to allow your customers to connect their accounts.', - }, - { - name: 'Connectors', - description: 'Retrieve metadata for connectors.', - }, - { - name: 'MCP', - description: 'Model Context Protocol endpoint.', - }, - { - name: 'Proxy', - description: 'Routing API requests through StackOne directly to the underlying provider.', - }, - { - name: 'Request Logs', - description: 'API requests and response logs.', - }, - { - name: 'Webhooks', - description: 'Configure and manage webhooks.', - }, - ], - servers: [ - { - url: 'https://api.stackone.com', - }, - ], - components: { - securitySchemes: { - basic: { - type: 'http', - scheme: 'basic', - }, - }, - schemas: { - ActionMetaItem: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'The action ID', - nullable: true, - }, - label: { - type: 'string', - description: 'The action label', - nullable: true, - }, - description: { - type: 'string', - description: 'The action description', - nullable: true, - }, - schema_type: { - type: 'string', - description: 'The schema type for the action', - nullable: true, - }, - tags: { - description: 'The tags associated with this action', - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - authentication: { - description: 'The authentication methods supported by this action', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/AuthenticationMetaItem', - }, - }, - operation_details: { - type: 'object', - description: 'The operation details for the action', - additionalProperties: true, - nullable: true, - }, - }, - }, - ActionsMeta: { - type: 'object', - properties: { - version: { - type: 'string', - description: 'The version of the actions metadata', - nullable: true, - }, - name: { - type: 'string', - description: 'The name of the provider', - nullable: true, - }, - key: { - type: 'string', - description: 'The unique key for the provider', - nullable: true, - }, - icon: { - type: 'string', - description: 'The icon URL for the provider', - nullable: true, - }, - description: { - type: 'string', - description: 'The description of the provider', - nullable: true, - }, - authentication: { - description: 'The authentication methods supported by the provider', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/AuthenticationMetaItem', - }, - }, - actions: { - description: 'The list of actions available for this provider', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/ActionMetaItem', - }, - }, - }, - }, - ActionsMetaPaginated: { - type: 'object', - properties: { - next: { - type: 'string', - description: 'Cursor for fetching the next page of results', - nullable: true, - }, - data: { - description: 'The list of actions metadata', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/ActionsMeta', - }, - }, - }, - }, - ActionsRpcQueryDto: { - type: 'object', - properties: { - debug: { - type: 'boolean', - description: 'Enable debug mode for the action execution', - example: false, - nullable: true, - }, - }, - }, - ActionsRpcRequestDto: { - type: 'object', - properties: { - action: { - type: 'string', - description: 'The action to execute', - example: 'create_employee', - }, - path: { - type: 'object', - description: 'Path parameters for the action', - example: { - id: '123', - }, - nullable: true, - additionalProperties: true, - }, - query: { - description: 'Query parameters for the action', - nullable: true, - additionalProperties: true, - allOf: [ - { - $ref: '#/components/schemas/ActionsRpcQueryDto', - }, - ], - }, - headers: { - type: 'object', - description: 'Headers for the action', - example: { - 'Content-Type': 'application/json', - }, - nullable: true, - additionalProperties: true, - }, - body: { - type: 'object', - description: 'Request body for the action', - example: { - data: 'example', - }, - nullable: true, - additionalProperties: true, - }, - }, - required: ['action'], - }, - ActionsRpcResponse: { - type: 'object', - properties: { - next: { - type: 'string', - description: 'Cursor for fetching the next page of results', - nullable: true, - }, - data: { - description: 'The response data from the action RPC call', - oneOf: [ - { - type: 'object', - additionalProperties: true, - }, - { - type: 'array', - items: { - type: 'object', - additionalProperties: true, - }, - }, - { - type: 'null', - }, - ], - nullable: true, - }, - }, - }, - AdvancedLogRequestData: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'The request ID', - example: 'adbf752f-6457-4ddd-89b3-98ae2252b83b', - nullable: true, - }, - method: { - type: 'string', - description: 'The request method', - example: 'get', - nullable: true, - }, - headers: { - type: 'object', - additionalProperties: true, - example: { - 'content-type': 'application/json', - authorization: 'Bearer token', - }, - nullable: true, - }, - url: { - description: 'The request URL data', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/AdvancedLogRequestDataUrl', - }, - ], - }, - body: { - oneOf: [ - { - type: 'string', - }, - { - type: 'object', - }, - { - type: 'string', - format: 'binary', - }, - { - type: 'array', - items: { - type: 'integer', - format: 'int32', - minimum: 0, - maximum: 255, - }, - }, - { - type: 'string', - format: 'byte', - }, - ], - additionalProperties: true, - nullable: true, - }, - }, - }, - AdvancedLogRequestDataUrl: { - type: 'object', - properties: { - url: { - type: 'string', - description: 'The request URL', - example: 'https://example.com/api/v1/resource', - nullable: true, - }, - hostname: { - type: 'string', - description: 'The request URL hostname', - example: 'example.com', - nullable: true, - }, - path: { - type: 'string', - description: 'The request path', - example: '/api/v1/resource', - nullable: true, - }, - query_params: { - type: 'object', - description: 'The request query parameters', - additionalProperties: true, - example: { - page: 1, - limit: 10, - }, - nullable: true, - }, - }, - }, - AdvancedLogResponseData: { - type: 'object', - properties: { - status_code: { - type: 'number', - description: 'The response status code', - example: 200, - nullable: true, - }, - headers: { - type: 'object', - additionalProperties: true, - example: { - 'content-type': 'application/json', - authorization: 'Bearer token', - }, - nullable: true, - }, - body: { - oneOf: [ - { - type: 'string', - }, - { - type: 'object', - }, - { - type: 'string', - format: 'binary', - }, - { - type: 'array', - items: { - type: 'integer', - format: 'int32', - minimum: 0, - maximum: 255, - }, - }, - { - type: 'string', - format: 'byte', - }, - ], - additionalProperties: true, - nullable: true, - }, - custom_mapping_errors: { - description: 'The custom mapping errors', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/CustomMappingError', - }, - }, - provider_errors: { - description: 'The provider errors', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/ProviderError', - }, - }, - }, - }, - AuthenticationMetaItem: { - type: 'object', - properties: { - type: { - type: 'string', - description: 'The authentication type', - nullable: true, - }, - label: { - type: 'string', - description: 'The authentication label', - nullable: true, - }, - key: { - type: 'string', - description: 'The authentication key', - nullable: true, - }, - }, - }, - BadGatewayResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 502, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Bad Gateway', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - BadRequestResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 400, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Bad Request', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - data: { - description: 'Error details', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/UnifiedError', - }, - ], - }, - provider_errors: { - description: 'List of provider-specific errors', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/ProviderError', - }, - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - ConflictResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 409, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Conflict', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - ConnectorsMeta: { - type: 'object', - properties: { - provider: { - type: 'string', - example: 'hibob', - description: 'The provider key', - }, - provider_name: { - type: 'string', - example: 'Hibob', - description: 'The provider human-readable label', - }, - category: { - type: 'string', - enum: [ - 'ats', - 'hris', - 'hris-legacy', - 'crm', - 'iam', - 'marketing', - 'lms', - 'stackone', - 'documents', - 'ticketing', - 'screening', - 'messaging', - 'accounting', - 'scheduling', - ], - example: 'hris', - description: 'The provider service category', - 'x-speakeasy-unknown-values': 'allow', - }, - active: { - type: 'boolean', - example: true, - description: - 'Whether this provider has been enabled on the integrations page for the current project', - nullable: true, - }, - models: { - type: 'object', - additionalProperties: true, - example: { - employees: { - create: { - apiPath: '/unified/hris/employees/:id', - input: { - defaultFields: [ - { - name: 'first_name', - type: 'string', - }, - ], - }, - output: { - defaultFields: [ - { - name: 'id', - type: 'string', - }, - ], - }, - }, - }, - time_off: { - get: { - apiPath: '/unified/hris/employees/:id/time_off/:id', - output: { - defaultFields: [ - { - name: 'id', - type: 'string', - }, - ], - }, - }, - }, - }, - }, - resources: { - description: 'Resources for this provider, such as image assets', - example: { - images: { - logo_url: 'https://app.stackone.com/assets/logos/hibob.png', - original_logo_horizontal_url: - 'https://app.stackone.com/assets/logos/original/hibob_horizontal.png', - }, - }, - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/ConnectorsMetaResources', - }, - ], - }, - }, - required: ['provider', 'provider_name', 'category', 'models'], - }, - ConnectorsMetaResources: { - type: 'object', - properties: { - images: { - description: 'Image assets for this provider', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/ConnectorsMetaResourcesImagesApiModel', - }, - ], - }, - }, - }, - ConnectorsMetaResourcesImagesApiModel: { - type: 'object', - properties: { - logo_url: { - type: 'string', - example: 'https://app.stackone.com/assets/logos/hibob.png', - description: 'URL of the square logo designed and used by StackOne for this provider', - nullable: true, - }, - original_logo_horizontal_url: { - type: 'string', - example: 'https://app.stackone.com/assets/logos/source/hibob.png', - description: - 'URL of the original provider logo (with logo and/or name aligned horizontally)', - nullable: true, - }, - }, - }, - ConnectSession: { - type: 'object', - properties: { - id: { - type: 'number', - }, - organization_id: { - type: 'number', - }, - project_id: { - type: 'string', - }, - categories: { - type: 'array', - example: [ - 'ats', - 'hris', - 'hrisLegacy', - 'crm', - 'iam', - 'marketing', - 'lms', - 'stackOne', - 'documents', - 'ticketing', - 'screening', - 'messaging', - 'accounting', - 'scheduling', - ], - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - items: { - type: 'string', - enum: [ - 'ats', - 'hris', - 'hris-legacy', - 'crm', - 'iam', - 'marketing', - 'lms', - 'stackone', - 'documents', - 'ticketing', - 'screening', - 'messaging', - 'accounting', - 'scheduling', - null, - ], - }, - }, - provider: { - type: 'string', - nullable: true, - }, - origin_owner_id: { - type: 'string', - }, - origin_owner_name: { - type: 'string', - }, - origin_username: { - type: 'string', - nullable: true, - }, - account_id: { - type: 'string', - nullable: true, - }, - label: { - type: 'string', - nullable: true, - }, - created_at: { - format: 'date-time', - type: 'string', - }, - metadata: { - type: 'object', - description: - 'Arbitrary set of key and values defined during the session token creation. This can be used to tag an account (eg. based on their pricing plan)', - nullable: true, - }, - external_trigger_token: { - type: 'string', - description: 'External trigger token to be used to trigger actions on the account', - example: 'f0bc3d88-2178-5423-8c81-b81d6c9da824', - nullable: true, - }, - type: { - type: 'string', - description: 'The connect session account type', - enum: ['production', 'test', 'unmapped_value', null], - example: ['PRODUCTION', 'TEST'], - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - integration_id: { - type: 'string', - description: 'The integration ID (UUID) associated with this connect session', - nullable: true, - }, - }, - required: [ - 'id', - 'organization_id', - 'project_id', - 'origin_owner_id', - 'origin_owner_name', - 'created_at', - ], - }, - ConnectSessionAuthenticate: { - type: 'object', - properties: { - token: { - type: 'string', - description: 'The token to authenticate with', - }, - }, - required: ['token'], - }, - ConnectSessionCreate: { - type: 'object', - properties: { - categories: { - type: 'array', - description: 'The categories of the provider to connect to', - example: [ - 'ats', - 'hris', - 'hrisLegacy', - 'crm', - 'iam', - 'marketing', - 'lms', - 'stackOne', - 'documents', - 'ticketing', - 'screening', - 'messaging', - 'accounting', - 'scheduling', - ], - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - items: { - type: 'string', - enum: [ - 'ats', - 'hris', - 'hris-legacy', - 'crm', - 'iam', - 'marketing', - 'lms', - 'stackone', - 'documents', - 'ticketing', - 'screening', - 'messaging', - 'accounting', - 'scheduling', - null, - ], - }, - }, - provider: { - type: 'string', - description: 'The provider to connect to', - nullable: true, - }, - provider_version: { - type: 'string', - description: 'The provider version to connect to', - nullable: true, - }, - origin_owner_id: { - type: 'string', - description: 'The origin owner identifier', - }, - origin_owner_name: { - type: 'string', - description: 'The origin owner name', - }, - origin_username: { - type: 'string', - description: 'The origin username', - nullable: true, - }, - account_id: { - type: 'string', - description: - 'The unique identifier for the account associated with this connect session. When this field is present, the hub will launch in edit mode using the retrieved token.', - nullable: true, - }, - expires_in: { - type: 'number', - description: 'How long the session should be valid for in seconds', - default: 1800, - nullable: true, - }, - metadata: { - type: 'object', - description: 'The metadata for the connection', - nullable: true, - }, - multiple: { - type: 'boolean', - description: - 'If set, this connect session will allow creation of multiple accounts with the same origin owner id and provider. Has no effect if account_id is set.', - default: false, - nullable: true, - }, - label: { - type: 'string', - description: - 'The label to be applied to the account associated with this connect session.', - nullable: true, - }, - type: { - type: 'string', - description: 'The connect session account type', - enum: ['production', 'test', null], - example: ['PRODUCTION', 'TEST'], - default: 'production', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - integration_id: { - type: 'string', - description: 'The integration ID associated with this connect session', - nullable: true, - }, - }, - required: ['origin_owner_id', 'origin_owner_name'], - }, - ConnectSessionTokenAuthLink: { - type: 'object', - properties: { - id: { - type: 'number', - }, - organization_id: { - type: 'number', - }, - project_id: { - type: 'string', - }, - categories: { - type: 'array', - example: [ - 'ats', - 'hris', - 'hrisLegacy', - 'crm', - 'iam', - 'marketing', - 'lms', - 'stackOne', - 'documents', - 'ticketing', - 'screening', - 'messaging', - 'accounting', - 'scheduling', - ], - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - items: { - type: 'string', - enum: [ - 'ats', - 'hris', - 'hris-legacy', - 'crm', - 'iam', - 'marketing', - 'lms', - 'stackone', - 'documents', - 'ticketing', - 'screening', - 'messaging', - 'accounting', - 'scheduling', - null, - ], - }, - }, - provider: { - type: 'string', - nullable: true, - }, - origin_owner_id: { - type: 'string', - }, - origin_owner_name: { - type: 'string', - }, - origin_username: { - type: 'string', - nullable: true, - }, - account_id: { - type: 'string', - nullable: true, - }, - label: { - type: 'string', - nullable: true, - }, - created_at: { - format: 'date-time', - type: 'string', - }, - metadata: { - type: 'object', - description: - 'Arbitrary set of key and values defined during the session token creation. This can be used to tag an account (eg. based on their pricing plan)', - nullable: true, - }, - external_trigger_token: { - type: 'string', - description: 'External trigger token to be used to trigger actions on the account', - example: 'f0bc3d88-2178-5423-8c81-b81d6c9da824', - nullable: true, - }, - type: { - type: 'string', - description: 'The connect session account type', - enum: ['production', 'test', 'unmapped_value', null], - example: ['PRODUCTION', 'TEST'], - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - integration_id: { - type: 'string', - description: 'The integration ID (UUID) associated with this connect session', - nullable: true, - }, - token: { - type: 'string', - }, - auth_link_url: { - type: 'string', - }, - }, - required: [ - 'id', - 'organization_id', - 'project_id', - 'origin_owner_id', - 'origin_owner_name', - 'created_at', - 'token', - 'auth_link_url', - ], - }, - CustomMappingError: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'The custom mapping identifier', - example: 'adbf752f-6457-4ddd-89b3-98ae2252b83b', - nullable: true, - }, - message: { - type: 'string', - description: 'The error message', - example: 'Invalid value', - nullable: true, - }, - targetField: { - type: 'string', - description: 'The target field where the error occurred', - example: 'first_name', - nullable: true, - }, - }, - }, - ForbiddenResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 403, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Forbidden resource', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - InternalServerErrorResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 500, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Internal server error', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - JsonRpcMessageDto: { - type: 'object', - properties: { - jsonrpc: { - type: 'string', - example: '2.0', - description: 'JSON-RPC protocol version', - }, - method: { - type: 'string', - example: 'initialize', - description: 'JSON-RPC method name', - }, - params: { - type: 'object', - description: 'Method parameters (arbitrary JSON)', - nullable: true, - }, - id: { - type: 'object', - description: 'Request id (arbitrary JSON scalar)', - }, - }, - required: ['jsonrpc', 'method'], - }, - LinkedAccount: { - type: 'object', - properties: { - id: { - type: 'string', - }, - provider: { - type: 'string', - }, - provider_name: { - type: 'string', - nullable: true, - }, - status: { - type: 'string', - enum: ['active', 'inactive', 'suspended', 'archived', 'expired', 'error'], - 'x-speakeasy-unknown-values': 'allow', - }, - status_reasons: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/StatusReason', - }, - }, - origin_owner_id: { - type: 'string', - }, - origin_owner_name: { - type: 'string', - }, - origin_username: { - type: 'string', - nullable: true, - }, - credentials: { - type: 'object', - nullable: true, - }, - setup_information: { - type: 'object', - additionalProperties: true, - nullable: true, - }, - label: { - type: 'string', - nullable: true, - }, - created_at: { - format: 'date-time', - type: 'string', - }, - updated_at: { - format: 'date-time', - type: 'string', - }, - type: { - type: 'string', - description: 'The account type', - enum: ['production', 'test', 'unmapped_value', null], - example: ['PRODUCTION', 'TEST'], - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - }, - required: [ - 'id', - 'provider', - 'status', - 'origin_owner_id', - 'origin_owner_name', - 'created_at', - 'updated_at', - ], - }, - LinkedAccountMeta: { - type: 'object', - properties: { - provider: { - type: 'string', - }, - category: { - type: 'string', - enum: [ - 'ats', - 'hris', - 'hris-legacy', - 'crm', - 'iam', - 'marketing', - 'lms', - 'stackone', - 'documents', - 'ticketing', - 'screening', - 'messaging', - 'accounting', - 'scheduling', - ], - 'x-speakeasy-unknown-values': 'allow', - }, - models: { - type: 'object', - additionalProperties: true, - }, - }, - required: ['provider', 'category', 'models'], - }, - NotFoundResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 404, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Not Found', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - NotImplementedResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 501, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Not Implemented', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - PatchAccountExternalDto: { - type: 'object', - properties: { - provider: { - type: 'string', - nullable: true, - }, - origin_owner_id: { - type: 'string', - nullable: true, - }, - origin_owner_name: { - type: 'string', - nullable: true, - }, - origin_username: { - type: 'string', - nullable: true, - }, - credentials: { - type: 'object', - additionalProperties: false, - nullable: true, - }, - setup_information: { - type: 'object', - additionalProperties: false, - nullable: true, - }, - secrets: { - type: 'object', - additionalProperties: false, - nullable: true, - }, - authentication_config_key: { - type: 'string', - nullable: true, - }, - environment: { - type: 'string', - nullable: true, - }, - label: { - type: 'object', - nullable: true, - }, - metadata: { - type: 'object', - additionalProperties: false, - nullable: true, - }, - type: { - type: 'string', - description: 'The account type', - enum: ['production', 'test', null], - example: ['PRODUCTION', 'TEST'], - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - integration_id: { - type: 'string', - nullable: true, - }, - }, - }, - PlatformLog: { - type: 'object', - properties: { - request_id: { - type: 'string', - description: 'The request ID', - example: 'adbf752f-6457-4ddd-89b3-98ae2252b83b', - nullable: true, - }, - event_datetime: { - type: 'string', - description: 'The event ISO8601 date string', - example: '2021-01-01T00:00:00Z', - format: 'date-time', - nullable: true, - }, - start_time: { - type: 'string', - description: 'The request start time ISO8601 date string', - example: '2021-01-01T00:00:00Z', - format: 'date-time', - nullable: true, - }, - end_time: { - type: 'string', - description: 'The request end time ISO8601 date string', - example: '2021-01-01T00:00:00Z', - format: 'date-time', - nullable: true, - }, - account_id: { - type: 'string', - description: 'The account ID of the request', - example: '45355976281015164504', - nullable: true, - }, - project_id: { - type: 'string', - description: 'The project ID of the request', - example: 'dev-project-68574', - nullable: true, - }, - http_method: { - type: 'string', - description: 'The requested HTTP method', - example: 'get', - nullable: true, - }, - path: { - type: 'string', - description: 'The requested path', - example: '/unified/hris/employees', - nullable: true, - }, - url: { - type: 'string', - description: 'The requested URL', - example: 'https://api.stackone.com/unified/hris/employees?raw=false', - nullable: true, - }, - status: { - type: 'number', - description: 'The requests response status code', - example: 200, - nullable: true, - }, - duration: { - type: 'number', - description: 'The request duration in milliseconds', - example: 356, - nullable: true, - }, - success: { - type: 'boolean', - description: 'The request success flag', - example: true, - nullable: true, - }, - resource: { - type: 'string', - description: 'The requested resource', - example: 'employees', - nullable: true, - }, - child_resource: { - type: 'string', - description: 'The requested child resource', - example: 'time-off', - nullable: true, - }, - sub_resource: { - type: 'string', - description: 'The requested sub resource', - example: 'documents', - nullable: true, - }, - action: { - type: 'string', - description: 'The requested action', - example: 'download', - nullable: true, - }, - source_type: { - type: 'string', - description: 'The requests source type', - example: 'DASHBOARD', - nullable: true, - }, - source_value: { - type: 'string', - description: 'The requests source value', - example: 'ACCOUNT_TESTER', - nullable: true, - }, - source_id: { - type: 'string', - description: 'The requests source ID', - example: '1234567890', - nullable: true, - }, - source_ip: { - type: 'string', - description: 'The requests source IPV4 ip address', - example: '192.168.1.1', - nullable: true, - }, - category: { - type: 'string', - description: 'The requested category', - example: 'hris', - nullable: true, - }, - }, - }, - PlatformLogsPaginated: { - type: 'object', - properties: { - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/PlatformLog', - }, - }, - }, - required: ['data'], - }, - PreconditionFailedResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 412, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Precondition failed', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - ProviderError: { - type: 'object', - properties: { - status: { - type: 'number', - description: 'HTTP status code of the provider error', - example: 400, - nullable: true, - }, - url: { - type: 'string', - description: 'URL that caused the error', - example: 'https://api.provider.com/v1/resource', - nullable: true, - }, - raw: { - type: 'object', - description: 'Raw error response from the provider', - example: { - message: 'Invalid input parameters', - }, - nullable: true, - }, - headers: { - type: 'object', - description: 'Response headers', - example: { - 'content-type': 'application/json', - 'x-request-id': '5678c28b211dace4e0a0f9171e6b88c5', - }, - nullable: true, - }, - }, - }, - ProviderErrorApiModel: { - type: 'object', - properties: { - status: { - type: 'number', - example: 400, - nullable: true, - }, - url: { - type: 'string', - example: 'https://api.someprovider.com/v1/endpoint', - nullable: true, - }, - raw: { - type: 'object', - nullable: true, - }, - headers: { - type: 'object', - example: { - date: 'Tue, 02 Apr 2024 13:52:01 GMT', - 'content-type': 'application/json; charset=utf-8', - 'transfer-encoding': 'chunked', - connection: 'close', - }, - nullable: true, - }, - }, - }, - ProxyRequestBody: { - type: 'object', - properties: { - url: { - type: 'string', - description: 'The base url of the request', - example: 'https://api.sample-integration.com/v1', - nullable: true, - }, - method: { - type: 'string', - description: 'The method of the request', - enum: ['get', 'post', 'put', 'delete', 'patch', null], - default: 'get', - nullable: true, - 'x-speakeasy-unknown-values': 'allow', - }, - path: { - type: 'string', - description: 'The path of the request including any query parameters', - example: '/employees/directory', - nullable: true, - }, - headers: { - type: 'object', - description: 'The headers to send in the request', - additionalProperties: true, - example: { - 'Content-Type': 'application/json', - }, - nullable: true, - }, - body: { - type: 'object', - description: 'The body of the request', - additionalProperties: true, - nullable: true, - }, - }, - }, - ProxyResponseApiModel: { - type: 'object', - properties: { - status: { - type: 'number', - description: 'The HTTP status code returned by the provider', - example: 200, - }, - headers: { - type: 'object', - description: 'The headers returned by the provider', - example: { - 'content-type': 'application/json', - 'x-request-id': '123e4567-e89b-12d3-a456-426614174000', - }, - additionalProperties: true, - nullable: true, - }, - data: { - description: - 'The response data from the provider. Can be an object, array, or primitive value.', - example: { - id: '123', - name: 'John Doe', - email: 'john.doe@example.com', - }, - oneOf: [ - { - type: 'object', - additionalProperties: true, - }, - { - type: 'array', - items: { - type: 'object', - additionalProperties: true, - }, - }, - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - ], - nullable: true, - }, - provider_errors: { - description: 'Provider-specific errors if any occurred', - example: [ - { - status: 400, - url: 'https://api.someprovider.com/v1/endpoint', - raw: { - error: 'Bad Request', - message: 'The supplied data is invalid', - }, - headers: { - date: 'Tue, 02 Apr 2024 13:52:01 GMT', - 'content-type': 'application/json; charset=utf-8', - }, - }, - ], - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/ProviderErrorApiModel', - }, - }, - }, - required: ['status'], - }, - RequestTimedOutResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 408, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Request timed out', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - StatusReason: { - type: 'object', - properties: { - code: { - type: 'string', - nullable: true, - }, - description: { - type: 'string', - nullable: true, - }, - timestamp: { - format: 'date-time', - type: 'string', - }, - }, - required: ['timestamp'], - }, - StepLog: { - type: 'object', - properties: { - request_id: { - type: 'string', - description: 'The request ID', - example: 'adbf752f-6457-4ddd-89b3-98ae2252b83b', - nullable: true, - }, - start_time: { - type: 'string', - description: 'The request start time ISO8601 date string', - example: '2021-01-01T00:00:00Z', - format: 'date-time', - nullable: true, - }, - end_time: { - type: 'string', - description: 'The request end time ISO8601 date string', - example: '2021-01-01T00:00:00Z', - format: 'date-time', - nullable: true, - }, - account_id: { - type: 'string', - description: 'The account ID of the request', - example: '45355976281015164504', - nullable: true, - }, - project_id: { - type: 'string', - description: 'The project ID of the request', - example: 'dev-project-68574', - nullable: true, - }, - http_method: { - type: 'string', - description: 'The requested HTTP method', - example: 'get', - nullable: true, - }, - path: { - type: 'string', - description: 'The requested path', - example: '/unified/hris/employees', - nullable: true, - }, - url: { - type: 'string', - description: 'The requested URL', - example: 'https://api.stackone.com/unified/hris/employees?raw=false', - nullable: true, - }, - status: { - type: 'number', - description: 'The requests response status code', - example: 200, - nullable: true, - }, - duration: { - type: 'number', - description: 'The request duration in milliseconds', - example: 356, - nullable: true, - }, - success: { - type: 'boolean', - description: 'The request success flag', - example: true, - nullable: true, - }, - provider: { - type: 'string', - description: 'The requested provider', - example: 'planday', - nullable: true, - }, - service: { - type: 'string', - description: 'The requested service', - example: 'hris', - nullable: true, - }, - resource: { - type: 'string', - description: 'The requested resource', - example: 'employees', - nullable: true, - }, - child_resource: { - type: 'string', - description: 'The requested child resource', - example: 'time-off', - nullable: true, - }, - sub_resource: { - type: 'string', - description: 'The requested sub resource', - example: 'documents', - nullable: true, - }, - action: { - type: 'string', - description: 'The requested action', - example: 'download', - nullable: true, - }, - is_worker: { - type: 'boolean', - description: 'The asynchronous worker flag', - example: false, - nullable: true, - }, - source_ip: { - type: 'string', - description: 'The requests source IPV4 ip address', - example: '192.168.1.1', - nullable: true, - }, - id: { - type: 'string', - description: 'The provider request ID', - example: 'adbf752f-6457-4ddd-89b3-98ae2252b83b', - nullable: true, - }, - request: { - description: 'The advanced log request data', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/AdvancedLogRequestData', - }, - ], - }, - response: { - description: 'The advanced log response data', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/AdvancedLogResponseData', - }, - ], - }, - }, - }, - StepLogPartial: { - type: 'object', - properties: { - request_id: { - type: 'string', - description: 'The request ID', - example: 'adbf752f-6457-4ddd-89b3-98ae2252b83b', - nullable: true, - }, - start_time: { - type: 'string', - description: 'The request start time ISO8601 date string', - example: '2021-01-01T00:00:00Z', - format: 'date-time', - nullable: true, - }, - end_time: { - type: 'string', - description: 'The request end time ISO8601 date string', - example: '2021-01-01T00:00:00Z', - format: 'date-time', - nullable: true, - }, - account_id: { - type: 'string', - description: 'The account ID of the request', - example: '45355976281015164504', - nullable: true, - }, - project_id: { - type: 'string', - description: 'The project ID of the request', - example: 'dev-project-68574', - nullable: true, - }, - http_method: { - type: 'string', - description: 'The requested HTTP method', - example: 'get', - nullable: true, - }, - path: { - type: 'string', - description: 'The requested path', - example: '/unified/hris/employees', - nullable: true, - }, - url: { - type: 'string', - description: 'The requested URL', - example: 'https://api.stackone.com/unified/hris/employees?raw=false', - nullable: true, - }, - status: { - type: 'number', - description: 'The requests response status code', - example: 200, - nullable: true, - }, - duration: { - type: 'number', - description: 'The request duration in milliseconds', - example: 356, - nullable: true, - }, - success: { - type: 'boolean', - description: 'The request success flag', - example: true, - nullable: true, - }, - provider: { - type: 'string', - description: 'The requested provider', - example: 'planday', - nullable: true, - }, - service: { - type: 'string', - description: 'The requested service', - example: 'hris', - nullable: true, - }, - resource: { - type: 'string', - description: 'The requested resource', - example: 'employees', - nullable: true, - }, - child_resource: { - type: 'string', - description: 'The requested child resource', - example: 'time-off', - nullable: true, - }, - sub_resource: { - type: 'string', - description: 'The requested sub resource', - example: 'documents', - nullable: true, - }, - action: { - type: 'string', - description: 'The requested action', - example: 'download', - nullable: true, - }, - is_worker: { - type: 'boolean', - description: 'The asynchronous worker flag', - example: false, - nullable: true, - }, - id: { - type: 'string', - description: 'The provider request ID', - example: 'adbf752f-6457-4ddd-89b3-98ae2252b83b', - nullable: true, - }, - }, - }, - StepLogsPaginated: { - type: 'object', - properties: { - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/StepLogPartial', - }, - }, - }, - required: ['data'], - }, - TooManyRequestsResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 429, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Too many requests', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - UnauthorizedResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 401, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Unauthorized', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - UnifiedError: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 400, - nullable: true, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Bad Request', - nullable: true, - }, - headers: { - type: 'object', - description: 'Response headers', - example: { - 'content-type': 'application/json', - 'x-request-id': '5678c28b211dace4e0a0f9171e6b88c5', - }, - nullable: true, - }, - }, - }, - UnifiedLogResult: { - type: 'object', - properties: { - data: { - $ref: '#/components/schemas/UnifiedLogs', - }, - }, - required: ['data'], - }, - UnifiedLogs: { - type: 'object', - properties: { - request_id: { - type: 'string', - description: 'The request ID', - example: 'adbf752f-6457-4ddd-89b3-98ae2252b83b', - nullable: true, - }, - event_datetime: { - type: 'string', - description: 'The event ISO8601 date string', - example: '2021-01-01T00:00:00Z', - format: 'date-time', - nullable: true, - }, - start_time: { - type: 'string', - description: 'The request start time ISO8601 date string', - example: '2021-01-01T00:00:00Z', - format: 'date-time', - nullable: true, - }, - end_time: { - type: 'string', - description: 'The request end time ISO8601 date string', - example: '2021-01-01T00:00:00Z', - format: 'date-time', - nullable: true, - }, - account_id: { - type: 'string', - description: 'The account ID of the request', - example: '45355976281015164504', - nullable: true, - }, - project_id: { - type: 'string', - description: 'The project ID of the request', - example: 'dev-project-68574', - nullable: true, - }, - http_method: { - type: 'string', - description: 'The requested HTTP method', - example: 'get', - nullable: true, - }, - path: { - type: 'string', - description: 'The requested path', - example: '/unified/hris/employees', - nullable: true, - }, - url: { - type: 'string', - description: 'The requested URL', - example: 'https://api.stackone.com/unified/hris/employees?raw=false', - nullable: true, - }, - status: { - type: 'number', - description: 'The requests response status code', - example: 200, - nullable: true, - }, - duration: { - type: 'number', - description: 'The request duration in milliseconds', - example: 356, - nullable: true, - }, - success: { - type: 'boolean', - description: 'The request success flag', - example: true, - nullable: true, - }, - provider: { - type: 'string', - description: 'The requested provider', - example: 'planday', - nullable: true, - }, - service: { - type: 'string', - description: 'The requested service', - example: 'hris', - nullable: true, - }, - resource: { - type: 'string', - description: 'The requested resource', - example: 'employees', - nullable: true, - }, - child_resource: { - type: 'string', - description: 'The requested child resource', - example: 'time-off', - nullable: true, - }, - sub_resource: { - type: 'string', - description: 'The requested sub resource', - example: 'documents', - nullable: true, - }, - action: { - type: 'string', - description: 'The requested action', - example: 'download', - nullable: true, - }, - is_worker: { - type: 'boolean', - description: 'The asynchronous worker flag', - example: false, - nullable: true, - }, - source_type: { - type: 'string', - description: 'The requests source type', - example: 'DASHBOARD', - nullable: true, - }, - source_value: { - type: 'string', - description: 'The requests source value', - example: 'ACCOUNT_TESTER', - nullable: true, - }, - source_id: { - type: 'string', - description: 'The requests source ID', - example: '1234567890', - nullable: true, - }, - request: { - description: 'The advanced log request data', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/AdvancedLogRequestData', - }, - ], - }, - response: { - description: 'The advanced log response data', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/AdvancedLogResponseData', - }, - ], - }, - source_ip: { - type: 'string', - description: 'The requests source IPV4 ip address', - example: '192.168.1.1', - nullable: true, - }, - step_requests: { - type: 'array', - description: 'The list of provider requests', - items: { - $ref: '#/components/schemas/StepLog', - }, - nullable: true, - }, - }, - }, - UnifiedLogsPaginated: { - type: 'object', - properties: { - next: { - type: 'string', - nullable: true, - }, - data: { - type: 'array', - items: { - $ref: '#/components/schemas/UnifiedLogsPartial', - }, - }, - }, - required: ['data'], - }, - UnifiedLogsPartial: { - type: 'object', - properties: { - request_id: { - type: 'string', - description: 'The request ID', - example: 'adbf752f-6457-4ddd-89b3-98ae2252b83b', - nullable: true, - }, - event_datetime: { - type: 'string', - description: 'The event ISO8601 date string', - example: '2021-01-01T00:00:00Z', - format: 'date-time', - nullable: true, - }, - start_time: { - type: 'string', - description: 'The request start time ISO8601 date string', - example: '2021-01-01T00:00:00Z', - format: 'date-time', - nullable: true, - }, - end_time: { - type: 'string', - description: 'The request end time ISO8601 date string', - example: '2021-01-01T00:00:00Z', - format: 'date-time', - nullable: true, - }, - account_id: { - type: 'string', - description: 'The account ID of the request', - example: '45355976281015164504', - nullable: true, - }, - project_id: { - type: 'string', - description: 'The project ID of the request', - example: 'dev-project-68574', - nullable: true, - }, - http_method: { - type: 'string', - description: 'The requested HTTP method', - example: 'get', - nullable: true, - }, - path: { - type: 'string', - description: 'The requested path', - example: '/unified/hris/employees', - nullable: true, - }, - url: { - type: 'string', - description: 'The requested URL', - example: 'https://api.stackone.com/unified/hris/employees?raw=false', - nullable: true, - }, - status: { - type: 'number', - description: 'The requests response status code', - example: 200, - nullable: true, - }, - duration: { - type: 'number', - description: 'The request duration in milliseconds', - example: 356, - nullable: true, - }, - success: { - type: 'boolean', - description: 'The request success flag', - example: true, - nullable: true, - }, - provider: { - type: 'string', - description: 'The requested provider', - example: 'planday', - nullable: true, - }, - service: { - type: 'string', - description: 'The requested service', - example: 'hris', - nullable: true, - }, - resource: { - type: 'string', - description: 'The requested resource', - example: 'employees', - nullable: true, - }, - child_resource: { - type: 'string', - description: 'The requested child resource', - example: 'time-off', - nullable: true, - }, - sub_resource: { - type: 'string', - description: 'The requested sub resource', - example: 'documents', - nullable: true, - }, - action: { - type: 'string', - description: 'The requested action', - example: 'download', - nullable: true, - }, - is_worker: { - type: 'boolean', - description: 'The asynchronous worker flag', - example: false, - nullable: true, - }, - source_type: { - type: 'string', - description: 'The requests source type', - example: 'DASHBOARD', - nullable: true, - }, - source_value: { - type: 'string', - description: 'The requests source value', - example: 'ACCOUNT_TESTER', - nullable: true, - }, - source_id: { - type: 'string', - description: 'The requests source ID', - example: '1234567890', - nullable: true, - }, - source_ip: { - type: 'string', - description: 'The requests source IPV4 ip address', - example: '192.168.1.1', - nullable: true, - }, - step_requests: { - type: 'array', - description: 'The list of provider requests', - items: { - $ref: '#/components/schemas/StepLogPartial', - }, - nullable: true, - }, - }, - }, - UnprocessableEntityResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 422, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Unprocessable Entity', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - }, - }, -}; diff --git a/src/openapi/generated/ticketing.ts b/src/openapi/generated/ticketing.ts deleted file mode 100644 index c820f171..00000000 --- a/src/openapi/generated/ticketing.ts +++ /dev/null @@ -1,7794 +0,0 @@ -// Generated OpenAPI specification for ticketing -// DO NOT EDIT THIS FILE DIRECTLY -export const ticketingSpec = { - openapi: '3.1.0', - paths: { - '/unified/ticketing/tickets': { - get: { - description: 'Retrieve a paginated list of tickets.', - operationId: 'ticketing_list_tickets', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,type,ticket_number,title,creator_id,remote_creator_id,reporters,assignees,content,parent_id,remote_parent_id,closed_at,ticket_url,status,priority,tags,projects,components,organization,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of tickets was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TicketingTicketsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Tickets', - tags: ['Tickets'], - 'x-speakeasy-group': 'ticketing', - 'x-speakeasy-name-override': 'list_tickets', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - post: { - description: 'Create a new ticket record.', - operationId: 'ticketing_create_ticket', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TicketingTicketCreateRequestDto', - }, - }, - }, - }, - responses: { - '201': { - description: 'Record created successfully.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/CreateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Create Ticket', - tags: ['Tickets'], - 'x-speakeasy-group': 'ticketing', - 'x-speakeasy-name-override': 'create_ticket', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ticketing/tickets/{id}': { - get: { - description: 'Retrieve a single ticket by its identifier.', - operationId: 'ticketing_get_ticket', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,type,ticket_number,title,creator_id,remote_creator_id,reporters,assignees,content,parent_id,remote_parent_id,closed_at,ticket_url,status,priority,tags,projects,components,organization,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The ticket with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TicketingTicketResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Ticket', - tags: ['Tickets'], - 'x-speakeasy-group': 'ticketing', - 'x-speakeasy-name-override': 'get_ticket', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - patch: { - description: 'Update an existing ticket record by its identifier.', - operationId: 'ticketing_update_ticket', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - ], - requestBody: { - required: true, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TicketingTicketUpdateRequestDto', - }, - }, - }, - }, - responses: { - '200': { - description: 'Record updated successfully.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UpdateResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Update Ticket', - tags: ['Tickets'], - 'x-speakeasy-group': 'ticketing', - 'x-speakeasy-name-override': 'update_ticket', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ticketing/users': { - get: { - description: 'Retrieve a paginated list of users.', - operationId: 'ticketing_list_users', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,type,name,primary_email,primary_phone,username,active,first_name,last_name,customer_account_reference,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of users was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TicketingUsersPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Users', - tags: ['Users'], - 'x-speakeasy-group': 'ticketing', - 'x-speakeasy-name-override': 'list_users', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ticketing/users/{id}': { - get: { - description: 'Retrieve a single user by their identifier.', - operationId: 'ticketing_get_user', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,type,name,primary_email,primary_phone,username,active,first_name,last_name,customer_account_reference,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The user with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TicketingUserResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get User', - tags: ['Users'], - 'x-speakeasy-group': 'ticketing', - 'x-speakeasy-name-override': 'get_user', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ticketing/tickets/{id}/comments': { - get: { - description: 'Retrieve a paginated list of comments for a ticket.', - operationId: 'ticketing_list_comments', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,ticket_id,remote_ticket_id,content,user_id,remote_user_id,internal,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of comments was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TicketingCommentsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Comments', - tags: ['Tickets', 'Comments'], - 'x-speakeasy-group': 'ticketing', - 'x-speakeasy-name-override': 'list_comments', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ticketing/tickets/{id}/comments/{subResourceId}': { - get: { - description: 'Retrieve a single comment by its identifier for a ticket.', - operationId: 'ticketing_get_comment', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'subResourceId', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,ticket_id,remote_ticket_id,content,user_id,remote_user_id,internal,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The comment with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TicketingCommentResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Comment', - tags: ['Tickets', 'Comments'], - 'x-speakeasy-group': 'ticketing', - 'x-speakeasy-name-override': 'get_comment', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ticketing/tickets/{id}/attachments/{subResourceId}/download': { - get: { - description: 'Download the attachment file from a ticket.', - operationId: 'ticketing_download_ticketing_attachment', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'subResourceId', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'format', - required: false, - in: 'query', - description: 'The format to download the file in', - schema: { - nullable: true, - example: 'base64', - type: 'string', - }, - }, - { - name: 'export_format', - required: false, - in: 'query', - description: 'The export format of the file', - schema: { - nullable: true, - example: 'text/plain', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: - 'The document related to the application with the given identifiers was retrieved.', - content: { - '*/*': { - schema: { - $ref: '#/components/schemas/DownloadApiModel', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Download Attachment', - tags: ['Tickets', 'Attachments'], - 'x-speakeasy-group': 'ticketing', - 'x-speakeasy-name-override': 'download_ticketing_attachment', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ticketing/tickets/{id}/attachments': { - get: { - description: 'Retrieve a paginated list of attachment details for a ticket.', - operationId: 'ticketing_list_attachments', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,ticket_id,remote_ticket_id,user_id,remote_user_id,file_name,file_format,file_url,size,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of attachments was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TicketingAttachmentsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Attachments', - tags: ['Tickets', 'Attachments'], - 'x-speakeasy-group': 'ticketing', - 'x-speakeasy-name-override': 'list_attachments', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ticketing/tickets/{id}/attachments/{subResourceId}': { - get: { - description: 'Retrieve the details of a single attachment for a ticket.', - operationId: 'ticketing_get_attachment', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'subResourceId', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,ticket_id,remote_ticket_id,user_id,remote_user_id,file_name,file_format,file_url,size,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The attachment with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TicketingAttachmentResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Attachment', - tags: ['Tickets', 'Attachments'], - 'x-speakeasy-group': 'ticketing', - 'x-speakeasy-name-override': 'get_attachment', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ticketing/ticket_types': { - get: { - description: 'Retrieve a paginated list of all ticket types.', - operationId: 'ticketing_list_ticket_types', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,name,project_id,remote_project_id,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of ticket types was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TicketingTicketTypePaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Ticket Types', - tags: ['Ticket Types'], - 'x-speakeasy-group': 'ticketing', - 'x-speakeasy-name-override': 'list_ticket_types', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ticketing/ticket_types/{id}': { - get: { - description: 'Retrieve a single ticket type by its identifier.', - operationId: 'ticketing_get_ticket_type', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,name,project_id,remote_project_id,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The ticket type with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TicketingTicketTypeResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Ticket Type', - tags: ['Ticket Types'], - 'x-speakeasy-group': 'ticketing', - 'x-speakeasy-name-override': 'get_ticket_type', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ticketing/projects': { - get: { - description: 'Retrieve a paginated list of projects.', - operationId: 'ticketing_list_projects', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,organization_id,remote_organization_id,name,description,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of projects was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TicketingProjectsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Projects', - tags: ['Projects'], - 'x-speakeasy-group': 'ticketing', - 'x-speakeasy-name-override': 'list_projects', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ticketing/projects/{id}': { - get: { - description: 'Retrieve a single project by its identifier.', - operationId: 'ticketing_get_project', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,organization_id,remote_organization_id,name,description,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The project with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TicketingProjectResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Project', - tags: ['Projects'], - 'x-speakeasy-group': 'ticketing', - 'x-speakeasy-name-override': 'get_project', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ticketing/projects/{id}/components': { - get: { - description: 'Retrieve a paginated list of project components.', - operationId: 'ticketing_list_project_components', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,organization_id,remote_organization_id,project_id,remote_project_id,name,description,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of project components was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TicketingComponentsPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Project Components', - tags: ['Projects', 'Components'], - 'x-speakeasy-group': 'ticketing', - 'x-speakeasy-name-override': 'list_project_components', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ticketing/projects/{id}/components/{subResourceId}': { - get: { - description: 'Retrieve a single project component by its identifier.', - operationId: 'ticketing_get_project_component', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'subResourceId', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: - 'id,remote_id,organization_id,remote_organization_id,project_id,remote_project_id,name,description,created_at,updated_at,unified_custom_fields', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The project component with the given identifier was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TicketingComponentResult', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'Get Project Component', - tags: ['Projects', 'Components'], - 'x-speakeasy-group': 'ticketing', - 'x-speakeasy-name-override': 'get_project_component', - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ticketing/projects/{id}/ticket_types': { - get: { - description: 'Retrieve a paginated list of ticket types for a project.', - operationId: 'ticketing_list_project_ticket_types', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields that will be returned in the response (if empty, all fields are returned)', - schema: { - nullable: true, - example: 'id,remote_id,name,project_id,remote_project_id,unified_custom_fields', - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of project ticket types was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TicketingTicketTypePaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Project Ticket Types', - tags: ['Projects', 'Ticket Types'], - 'x-speakeasy-group': 'ticketing', - 'x-speakeasy-name-override': 'list_project_ticket_types', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - '/unified/ticketing/tickets/{id}/statuses': { - get: { - description: 'Retrieve a paginated list of statuses for a ticket.', - operationId: 'ticketing_list_ticket_statuses', - parameters: [ - { - name: 'x-account-id', - in: 'header', - description: 'The account identifier', - required: true, - schema: { - type: 'string', - }, - }, - { - name: 'id', - required: true, - in: 'path', - schema: { - type: 'string', - }, - }, - { - name: 'raw', - required: false, - in: 'query', - description: - 'Indicates that the raw request result should be returned in addition to the mapped result (default value is false)', - schema: { - nullable: true, - type: 'boolean', - }, - }, - { - name: 'proxy', - required: false, - in: 'query', - description: - "Query parameters that can be used to pass through parameters to the underlying provider request by surrounding them with 'proxy' key", - style: 'deepObject', - explode: true, - schema: { - additionalProperties: true, - nullable: true, - type: 'object', - }, - }, - { - name: 'fields', - required: false, - in: 'query', - description: - 'The comma separated list of fields to return in the response (if empty, all fields are returned)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'filter', - required: false, - in: 'query', - description: 'Filter parameters that allow greater customisation of the list response', - explode: true, - style: 'deepObject', - schema: { - properties: { - updated_after: { - description: - 'Use a string with a date to only select results updated after that given date', - example: '2020-01-01T00:00:00.000Z', - type: 'string', - format: 'date-time', - nullable: true, - additionalProperties: false, - }, - }, - nullable: true, - type: 'object', - }, - }, - { - name: 'page', - required: false, - in: 'query', - description: 'The page number of the results to fetch', - deprecated: true, - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'page_size', - required: false, - in: 'query', - description: 'The number of results per page (default value is 25)', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'next', - required: false, - in: 'query', - description: 'The unified cursor', - schema: { - nullable: true, - type: 'string', - }, - }, - { - name: 'updated_after', - required: false, - in: 'query', - description: - 'Use a string with a date to only select results updated after that given date', - deprecated: true, - schema: { - format: 'date-time', - nullable: true, - example: '2020-01-01T00:00:00.000Z', - type: 'string', - }, - }, - ], - responses: { - '200': { - description: 'The list of ticket statuses was retrieved.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TicketingTicketStatusesPaginated', - }, - }, - }, - }, - '400': { - description: 'Invalid request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadRequestResponse', - }, - }, - }, - }, - '401': { - description: 'Unauthorized access.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnauthorizedResponse', - }, - }, - }, - }, - '403': { - description: 'Forbidden.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ForbiddenResponse', - }, - }, - }, - }, - '404': { - description: 'Resource not found.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotFoundResponse', - }, - }, - }, - }, - '408': { - description: 'The request has timed out.', - headers: { - 'Retry-After': { - description: 'A time in seconds after which the request can be retried.', - schema: { - type: 'string', - }, - }, - }, - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/RequestTimedOutResponse', - }, - }, - }, - }, - '409': { - description: 'Conflict with current state.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/ConflictResponse', - }, - }, - }, - }, - '412': { - description: 'Precondition failed: linked account belongs to a disabled integration.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/PreconditionFailedResponse', - }, - }, - }, - }, - '422': { - description: 'Validation error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/UnprocessableEntityResponse', - }, - }, - }, - }, - '429': { - description: 'Too many requests.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/TooManyRequestsResponse', - }, - }, - }, - }, - '500': { - description: 'Server error while executing the request.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/InternalServerErrorResponse', - }, - }, - }, - }, - '501': { - description: 'This functionality is not implemented.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/NotImplementedResponse', - }, - }, - }, - }, - '502': { - description: 'Bad gateway error.', - content: { - 'application/json': { - schema: { - $ref: '#/components/schemas/BadGatewayResponse', - }, - }, - }, - }, - }, - security: [ - { - basic: [], - }, - ], - summary: 'List Ticket Statuses', - tags: ['Tickets', 'Ticket Statuses'], - 'x-speakeasy-group': 'ticketing', - 'x-speakeasy-name-override': 'list_ticket_statuses', - 'x-speakeasy-pagination': { - type: 'cursor', - inputs: [ - { - name: 'next', - in: 'parameters', - type: 'cursor', - }, - ], - outputs: { - nextCursor: '$.next', - }, - }, - 'x-speakeasy-retries': { - statusCodes: [429, 408], - strategy: 'backoff', - }, - }, - }, - }, - info: { - title: 'Ticketing', - description: 'The documentation for the StackOne Unified API - TICKETING', - version: '1.0.0', - contact: {}, - }, - tags: [ - { - name: 'Tickets', - description: 'Requests for support, assistance, or resolution.', - }, - { - name: 'Users', - description: 'Accounts that can create or work on tickets.', - }, - { - name: 'Comments', - description: 'Notes or messages added to tickets.', - }, - { - name: 'Attachments', - description: 'Files attached to tickets.', - }, - { - name: 'Ticket Types', - description: 'Types or categories of tickets.', - }, - { - name: 'Collections', - description: 'Groupings in which related tickets can be classified under.', - }, - { - name: 'Projects', - description: 'The top level grouping of tickets.', - }, - { - name: 'Components', - description: - 'A sub grouping under projects in which related tickets can be classified together.', - }, - { - name: 'Ticket Statuses', - description: 'Statuses representing ticket progress.', - }, - ], - servers: [ - { - url: 'https://api.stackone.com', - }, - ], - components: { - securitySchemes: { - basic: { - type: 'http', - scheme: 'basic', - }, - }, - schemas: { - BadGatewayResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 502, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Bad Gateway', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - BadRequestResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 400, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Bad Request', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - data: { - description: 'Error details', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/UnifiedError', - }, - ], - }, - provider_errors: { - description: 'List of provider-specific errors', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/ProviderError', - }, - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - ConflictResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 409, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Conflict', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - CreateResult: { - type: 'object', - properties: { - statusCode: { - type: 'number', - example: 201, - }, - message: { - type: 'string', - example: 'Record created successfully.', - }, - timestamp: { - type: 'string', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - }, - data: { - $ref: '#/components/schemas/CreateResultDataApiModel', - }, - }, - required: ['statusCode', 'message', 'timestamp', 'data'], - }, - CreateResultDataApiModel: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - }, - }, - DownloadApiModel: { - type: 'object', - properties: { - headers: { - description: 'Headers related to the download', - allOf: [ - { - $ref: '#/components/schemas/DownloadHeadersApiModel', - }, - ], - }, - data: { - type: 'string', - description: 'The file data in binary format', - format: 'binary', - }, - }, - required: ['headers', 'data'], - }, - DownloadHeadersApiModel: { - type: 'object', - properties: { - 'content-disposition': { - type: 'string', - description: 'Value of the Content-Disposition header', - example: 'attachment; filename="example.pdf"', - nullable: true, - }, - 'content-type': { - type: 'string', - description: 'MIME type of the file', - example: 'application/pdf', - nullable: true, - }, - 'content-length': { - type: 'number', - description: 'Size of the content in bytes', - example: 1024, - nullable: true, - }, - 'content-range': { - type: 'string', - description: 'Range of the content being sent', - example: 'bytes 0-1023/2048', - nullable: true, - }, - 'content-encoding': { - type: 'string', - description: 'Encoding of the content', - example: 'gzip', - nullable: true, - }, - 'transfer-encoding': { - type: 'string', - description: 'Transfer encoding type', - example: 'chunked', - nullable: true, - }, - }, - }, - FileFormatEnum: { - type: 'object', - properties: { - value: { - type: 'string', - description: 'The file format of the file, expressed as a file extension', - enum: [ - 'unmapped_value', - 'ez', - 'aw', - 'atom', - 'atomcat', - 'atomdeleted', - 'atomsvc', - 'dwd', - 'held', - 'rsat', - 'bdoc', - 'xcs', - 'ccxml', - 'cdfx', - 'cdmia', - 'cdmic', - 'cdmid', - 'cdmio', - 'cdmiq', - 'cu', - 'mpd', - 'davmount', - 'dbk', - 'dssc', - 'xdssc', - 'es', - 'ecma', - 'emma', - 'emotionml', - 'epub', - 'exi', - 'exp', - 'fdt', - 'pfr', - 'geojson', - 'gml', - 'gpx', - 'gxf', - 'gz', - 'hjson', - 'stk', - 'ink', - 'inkml', - 'ipfix', - 'its', - 'jar', - 'war', - 'ear', - 'ser', - 'class', - 'js', - 'mjs', - 'json', - 'map', - 'json5', - 'jsonml', - 'jsonld', - 'lgr', - 'lostxml', - 'hqx', - 'cpt', - 'mads', - 'webmanifest', - 'mrc', - 'mrcx', - 'ma', - 'nb', - 'mb', - 'mathml', - 'mbox', - 'mscml', - 'metalink', - 'meta4', - 'mets', - 'maei', - 'musd', - 'mods', - 'm21', - 'mp21', - 'mp4s', - 'm4p', - 'doc', - 'dot', - 'mxf', - 'nq', - 'nt', - 'cjs', - 'bin', - 'dms', - 'lrf', - 'mar', - 'so', - 'dist', - 'distz', - 'pkg', - 'bpk', - 'dump', - 'elc', - 'deploy', - 'exe', - 'dll', - 'deb', - 'dmg', - 'iso', - 'img', - 'msi', - 'msp', - 'msm', - 'buffer', - 'oda', - 'opf', - 'ogx', - 'omdoc', - 'onetoc', - 'onetoc2', - 'onetmp', - 'onepkg', - 'oxps', - 'relo', - 'xer', - 'pdf', - 'pgp', - 'asc', - 'sig', - 'prf', - 'p10', - 'p7m', - 'p7c', - 'p7s', - 'p8', - 'ac', - 'cer', - 'crl', - 'pkipath', - 'pki', - 'pls', - 'ai', - 'eps', - 'ps', - 'provx', - 'pskcxml', - 'raml', - 'rdf', - 'owl', - 'rif', - 'rnc', - 'rl', - 'rld', - 'rs', - 'rapd', - 'sls', - 'rusd', - 'gbr', - 'mft', - 'roa', - 'rsd', - 'rss', - 'rtf', - 'sbml', - 'scq', - 'scs', - 'spq', - 'spp', - 'sdp', - 'senmlx', - 'sensmlx', - 'setpay', - 'setreg', - 'shf', - 'siv', - 'sieve', - 'smi', - 'smil', - 'rq', - 'srx', - 'gram', - 'grxml', - 'sru', - 'ssdl', - 'ssml', - 'swidtag', - 'tei', - 'teicorpus', - 'tfi', - 'tsd', - 'toml', - 'trig', - 'ttml', - 'ubj', - 'rsheet', - 'td', - 'vxml', - 'wasm', - 'wgt', - 'hlp', - 'wsdl', - 'wspolicy', - 'xaml', - 'xav', - 'xca', - 'xdf', - 'xel', - 'xns', - 'xenc', - 'xhtml', - 'xht', - 'xlf', - 'xml', - 'xsl', - 'xsd', - 'rng', - 'dtd', - 'xop', - 'xpl', - '*xsl', - 'xslt', - 'xspf', - 'mxml', - 'xhvml', - 'xvml', - 'xvm', - 'yang', - 'yin', - 'zip', - '*3gpp', - 'adp', - 'amr', - 'au', - 'snd', - 'mid', - 'midi', - 'kar', - 'rmi', - 'mxmf', - '*mp3', - 'm4a', - 'mp4a', - 'mpga', - 'mp2', - 'mp2a', - 'mp3', - 'm2a', - 'm3a', - 'oga', - 'ogg', - 'spx', - 'opus', - 's3m', - 'sil', - 'wav', - '*wav', - 'weba', - 'xm', - 'ttc', - 'otf', - 'ttf', - 'woff', - 'woff2', - 'exr', - 'apng', - 'avif', - 'bmp', - 'cgm', - 'drle', - 'emf', - 'fits', - 'g3', - 'gif', - 'heic', - 'heics', - 'heif', - 'heifs', - 'hej2', - 'hsj2', - 'ief', - 'jls', - 'jp2', - 'jpg2', - 'jpeg', - 'jpg', - 'jpe', - 'jph', - 'jhc', - 'jpm', - 'jpx', - 'jpf', - 'jxr', - 'jxra', - 'jxrs', - 'jxs', - 'jxsc', - 'jxsi', - 'jxss', - 'ktx', - 'ktx2', - 'png', - 'sgi', - 'svg', - 'svgz', - 't38', - 'tif', - 'tiff', - 'tfx', - 'webp', - 'wmf', - 'disposition-notification', - 'u8msg', - 'u8dsn', - 'u8mdn', - 'u8hdr', - 'eml', - 'mime', - '3mf', - 'gltf', - 'glb', - 'igs', - 'iges', - 'msh', - 'mesh', - 'silo', - 'mtl', - 'obj', - 'stpx', - 'stpz', - 'stpxz', - 'stl', - 'wrl', - 'vrml', - '*x3db', - 'x3dbz', - 'x3db', - '*x3dv', - 'x3dvz', - 'x3d', - 'x3dz', - 'x3dv', - 'appcache', - 'manifest', - 'ics', - 'ifb', - 'coffee', - 'litcoffee', - 'css', - 'csv', - 'html', - 'htm', - 'shtml', - 'jade', - 'jsx', - 'less', - 'markdown', - 'md', - 'mml', - 'mdx', - 'n3', - 'txt', - 'text', - 'conf', - 'def', - 'list', - 'log', - 'in', - 'ini', - 'rtx', - '*rtf', - 'sgml', - 'sgm', - 'shex', - 'slim', - 'slm', - 'spdx', - 'stylus', - 'styl', - 'tsv', - 't', - 'tr', - 'roff', - 'man', - 'me', - 'ms', - 'ttl', - 'uri', - 'uris', - 'urls', - 'vcard', - 'vtt', - '*xml', - 'yaml', - 'yml', - '3gp', - '3gpp', - '3g2', - 'h261', - 'h263', - 'h264', - 'm4s', - 'jpgv', - '*jpm', - 'jpgm', - 'mj2', - 'mjp2', - 'ts', - 'mp4', - 'mp4v', - 'mpg4', - 'mpeg', - 'mpg', - 'mpe', - 'm1v', - 'm2v', - 'ogv', - 'qt', - 'mov', - 'webm', - 'cww', - '1km', - 'plb', - 'psb', - 'pvb', - 'tcap', - 'pwn', - 'aso', - 'imp', - 'acu', - 'atc', - 'acutc', - 'air', - 'fcdt', - 'fxp', - 'fxpl', - 'xdp', - 'xfdf', - 'ahead', - 'azf', - 'azs', - 'azw', - 'acc', - 'ami', - 'apk', - 'cii', - 'fti', - 'atx', - 'mpkg', - 'key', - 'm3u8', - 'numbers', - 'pages', - 'pkpass', - 'swi', - 'iota', - 'aep', - 'bmml', - 'mpm', - 'bmi', - 'rep', - 'cdxml', - 'mmd', - 'cdy', - 'csl', - 'cla', - 'rp9', - 'c4g', - 'c4d', - 'c4f', - 'c4p', - 'c4u', - 'c11amc', - 'c11amz', - 'csp', - 'cdbcmsg', - 'cmc', - 'clkx', - 'clkk', - 'clkp', - 'clkt', - 'clkw', - 'wbs', - 'pml', - 'ppd', - 'car', - 'pcurl', - 'dart', - 'rdz', - 'dbf', - 'uvf', - 'uvvf', - 'uvd', - 'uvvd', - 'uvt', - 'uvvt', - 'uvx', - 'uvvx', - 'uvz', - 'uvvz', - 'fe_launch', - 'dna', - 'mlp', - 'mle', - 'dpg', - 'dfac', - 'kpxx', - 'ait', - 'svc', - 'geo', - 'mag', - 'nml', - 'esf', - 'msf', - 'qam', - 'slt', - 'ssf', - 'es3', - 'et3', - 'ez2', - 'ez3', - 'fdf', - 'mseed', - 'seed', - 'dataless', - 'gph', - 'ftc', - 'fm', - 'frame', - 'maker', - 'book', - 'fnc', - 'ltf', - 'fsc', - 'oas', - 'oa2', - 'oa3', - 'fg5', - 'bh2', - 'ddd', - 'xdw', - 'xbd', - 'fzs', - 'txd', - 'ggb', - 'ggt', - 'gex', - 'gre', - 'gxt', - 'g2w', - 'g3w', - 'gmx', - 'gdoc', - 'gslides', - 'gsheet', - 'kml', - 'kmz', - 'gqf', - 'gqs', - 'gac', - 'ghf', - 'gim', - 'grv', - 'gtm', - 'tpl', - 'vcg', - 'hal', - 'zmm', - 'hbci', - 'les', - 'hpgl', - 'hpid', - 'hps', - 'jlt', - 'pcl', - 'pclxl', - 'sfd-hdstx', - 'mpy', - 'afp', - 'listafp', - 'list3820', - 'irm', - 'sc', - 'icc', - 'icm', - 'igl', - 'ivp', - 'ivu', - 'igm', - 'xpw', - 'xpx', - 'i2g', - 'qbo', - 'qfx', - 'rcprofile', - 'irp', - 'xpr', - 'fcs', - 'jam', - 'rms', - 'jisp', - 'joda', - 'ktz', - 'ktr', - 'karbon', - 'chrt', - 'kfo', - 'flw', - 'kon', - 'kpr', - 'kpt', - 'ksp', - 'kwd', - 'kwt', - 'htke', - 'kia', - 'kne', - 'knp', - 'skp', - 'skd', - 'skt', - 'skm', - 'sse', - 'lasxml', - 'lbd', - 'lbe', - 'apr', - 'pre', - 'nsf', - 'org', - 'scm', - 'lwp', - 'portpkg', - 'mvt', - 'mcd', - 'mc1', - 'cdkey', - 'mwf', - 'mfm', - 'flo', - 'igx', - 'mif', - 'daf', - 'dis', - 'mbk', - 'mqy', - 'msl', - 'plc', - 'txf', - 'mpn', - 'mpc', - 'xul', - 'cil', - 'cab', - 'xls', - 'xlm', - 'xla', - 'xlc', - 'xlt', - 'xlw', - 'xlam', - 'xlsb', - 'xlsm', - 'xltm', - 'eot', - 'chm', - 'ims', - 'lrm', - 'thmx', - 'msg', - 'cat', - '*stl', - 'ppt', - 'pps', - 'pot', - 'ppam', - 'pptm', - 'sldm', - 'ppsm', - 'potm', - 'mpp', - 'mpt', - 'docm', - 'dotm', - 'wps', - 'wks', - 'wcm', - 'wdb', - 'wpl', - 'xps', - 'mseq', - 'mus', - 'msty', - 'taglet', - 'nlu', - 'ntf', - 'nitf', - 'nnd', - 'nns', - 'nnw', - '*ac', - 'ngdat', - 'n-gage', - 'rpst', - 'rpss', - 'edm', - 'edx', - 'ext', - 'odc', - 'otc', - 'odb', - 'odf', - 'odft', - 'odg', - 'otg', - 'odi', - 'oti', - 'odp', - 'otp', - 'ods', - 'ots', - 'odt', - 'odm', - 'ott', - 'oth', - 'xo', - 'dd2', - 'obgx', - 'oxt', - 'osm', - 'pptx', - 'sldx', - 'ppsx', - 'potx', - 'xlsx', - 'xltx', - 'docx', - 'dotx', - 'mgp', - 'dp', - 'esa', - 'pdb', - 'pqa', - 'oprc', - 'paw', - 'str', - 'ei6', - 'efif', - 'wg', - 'plf', - 'pbd', - 'box', - 'mgz', - 'qps', - 'ptid', - 'qxd', - 'qxt', - 'qwd', - 'qwt', - 'qxl', - 'qxb', - 'rar', - 'bed', - 'mxl', - 'musicxml', - 'cryptonote', - 'cod', - 'rm', - 'rmvb', - 'link66', - 'st', - 'see', - 'sema', - 'semd', - 'semf', - 'ifm', - 'itp', - 'iif', - 'ipk', - 'twd', - 'twds', - 'mmf', - 'teacher', - 'fo', - 'sdkm', - 'sdkd', - 'dxp', - 'sfs', - 'sdc', - 'sda', - 'sdd', - 'smf', - 'sdw', - 'vor', - 'sgl', - 'smzip', - 'sm', - 'wadl', - 'sxc', - 'stc', - 'sxd', - 'std', - 'sxi', - 'sti', - 'sxm', - 'sxw', - 'sxg', - 'stw', - 'sus', - 'susp', - 'svd', - 'sis', - 'sisx', - 'xsm', - 'bdm', - 'xdm', - 'ddf', - 'tao', - 'pcap', - 'cap', - 'dmp', - 'tmo', - 'tpt', - 'mxs', - 'tra', - 'ufd', - 'ufdl', - 'utz', - 'umj', - 'unityweb', - 'uoml', - 'vcx', - 'vsd', - 'vst', - 'vss', - 'vsw', - 'vis', - 'vsf', - 'wbxml', - 'wmlc', - 'wmlsc', - 'wtb', - 'nbp', - 'wpd', - 'wqd', - 'stf', - 'xar', - 'xfdl', - 'hvd', - 'hvs', - 'hvp', - 'osf', - 'osfpvg', - 'saf', - 'spf', - 'cmp', - 'zir', - 'zirz', - 'zaz', - '7z', - 'abw', - 'ace', - '*dmg', - 'arj', - 'aab', - 'x32', - 'u32', - 'vox', - 'aam', - 'aas', - 'bcpio', - '*bdoc', - 'torrent', - 'blb', - 'blorb', - 'bz', - 'bz2', - 'boz', - 'cbr', - 'cba', - 'cbt', - 'cbz', - 'cb7', - 'vcd', - 'cfs', - 'chat', - 'pgn', - 'crx', - 'cco', - 'nsc', - 'cpio', - 'csh', - '*deb', - 'udeb', - 'dgc', - 'dir', - 'dcr', - 'dxr', - 'cst', - 'cct', - 'cxt', - 'w3d', - 'fgd', - 'swa', - 'wad', - 'ncx', - 'dtb', - 'res', - 'dvi', - 'evy', - 'eva', - 'bdf', - 'gsf', - 'psf', - 'pcf', - 'snf', - 'pfa', - 'pfb', - 'pfm', - 'afm', - 'arc', - 'spl', - 'gca', - 'ulx', - 'gnumeric', - 'gramps', - 'gtar', - 'hdf', - 'php', - 'install', - '*iso', - '*key', - '*numbers', - '*pages', - 'jardiff', - 'jnlp', - 'kdbx', - 'latex', - 'luac', - 'lzh', - 'lha', - 'run', - 'mie', - 'prc', - 'mobi', - 'application', - 'lnk', - 'wmd', - 'wmz', - 'xbap', - 'mdb', - 'obd', - 'crd', - 'clp', - '*exe', - '*dll', - 'com', - 'bat', - '*msi', - 'mvb', - 'm13', - 'm14', - '*wmf', - '*wmz', - '*emf', - 'emz', - 'mny', - 'pub', - 'scd', - 'trm', - 'wri', - 'nc', - 'cdf', - 'pac', - 'nzb', - 'pl', - 'pm', - '*prc', - '*pdb', - 'p12', - 'pfx', - 'p7b', - 'spc', - 'p7r', - '*rar', - 'rpm', - 'ris', - 'sea', - 'sh', - 'shar', - 'swf', - 'xap', - 'sql', - 'sit', - 'sitx', - 'srt', - 'sv4cpio', - 'sv4crc', - 't3', - 'gam', - 'tar', - 'tcl', - 'tk', - 'tex', - 'tfm', - 'texinfo', - 'texi', - '*obj', - 'ustar', - 'hdd', - 'ova', - 'ovf', - 'vbox', - 'vbox-extpack', - 'vdi', - 'vhd', - 'vmdk', - 'src', - 'webapp', - 'der', - 'crt', - 'pem', - 'fig', - '*xlf', - 'xpi', - 'xz', - 'z1', - 'z2', - 'z3', - 'z4', - 'z5', - 'z6', - 'z7', - 'z8', - 'uva', - 'uvva', - 'eol', - 'dra', - 'dts', - 'dtshd', - 'lvp', - 'pya', - 'ecelp4800', - 'ecelp7470', - 'ecelp9600', - 'rip', - 'aac', - 'aif', - 'aiff', - 'aifc', - 'caf', - 'flac', - '*m4a', - 'mka', - 'm3u', - 'wax', - 'wma', - 'ram', - 'ra', - 'rmp', - '*ra', - 'cdx', - 'cif', - 'cmdf', - 'cml', - 'csml', - 'xyz', - 'btif', - 'pti', - 'psd', - 'azv', - 'uvi', - 'uvvi', - 'uvg', - 'uvvg', - 'djvu', - 'djv', - '*sub', - 'dwg', - 'dxf', - 'fbs', - 'fpx', - 'fst', - 'mmr', - 'rlc', - 'ico', - 'dds', - 'mdi', - 'wdp', - 'npx', - 'b16', - 'tap', - 'vtf', - 'wbmp', - 'xif', - 'pcx', - '3ds', - 'ras', - 'cmx', - 'fh', - 'fhc', - 'fh4', - 'fh5', - 'fh7', - '*ico', - 'jng', - 'sid', - '*bmp', - '*pcx', - 'pic', - 'pct', - 'pnm', - 'pbm', - 'pgm', - 'ppm', - 'rgb', - 'tga', - 'xbm', - 'xpm', - 'xwd', - 'wsc', - 'dae', - 'dwf', - 'gdl', - 'gtw', - 'mts', - 'ogex', - 'x_b', - 'x_t', - 'vds', - 'usdz', - 'bsp', - 'vtu', - 'dsc', - 'curl', - 'dcurl', - 'mcurl', - 'scurl', - 'sub', - 'fly', - 'flx', - 'gv', - '3dml', - 'spot', - 'jad', - 'wml', - 'wmls', - 's', - 'asm', - 'c', - 'cc', - 'cxx', - 'cpp', - 'h', - 'hh', - 'dic', - 'htc', - 'f', - 'for', - 'f77', - 'f90', - 'hbs', - 'java', - 'lua', - 'mkd', - 'nfo', - 'opml', - '*org', - 'p', - 'pas', - 'pde', - 'sass', - 'scss', - 'etx', - 'sfv', - 'ymp', - 'uu', - 'vcs', - 'vcf', - 'uvh', - 'uvvh', - 'uvm', - 'uvvm', - 'uvp', - 'uvvp', - 'uvs', - 'uvvs', - 'uvv', - 'uvvv', - 'dvb', - 'fvt', - 'mxu', - 'm4u', - 'pyv', - 'uvu', - 'uvvu', - 'viv', - 'f4v', - 'fli', - 'flv', - 'm4v', - 'mkv', - 'mk3d', - 'mks', - 'mng', - 'asf', - 'asx', - 'vob', - 'wm', - 'wmv', - 'wmx', - 'wvx', - 'avi', - 'movie', - 'smv', - 'ice', - 'mht', - null, - ], - example: 'pdf', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - example: 'application/pdf', - nullable: true, - }, - }, - }, - ForbiddenResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 403, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Forbidden resource', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - InternalServerErrorResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 500, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Internal server error', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - NotFoundResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 404, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Not Found', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - NotImplementedResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 501, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Not Implemented', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - PreconditionFailedResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 412, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Precondition failed', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - ProviderError: { - type: 'object', - properties: { - status: { - type: 'number', - description: 'HTTP status code of the provider error', - example: 400, - nullable: true, - }, - url: { - type: 'string', - description: 'URL that caused the error', - example: 'https://api.provider.com/v1/resource', - nullable: true, - }, - raw: { - type: 'object', - description: 'Raw error response from the provider', - example: { - message: 'Invalid input parameters', - }, - nullable: true, - }, - headers: { - type: 'object', - description: 'Response headers', - example: { - 'content-type': 'application/json', - 'x-request-id': '5678c28b211dace4e0a0f9171e6b88c5', - }, - nullable: true, - }, - }, - }, - RawResponse: { - type: 'object', - properties: { - method: { - type: 'string', - }, - url: { - type: 'string', - }, - body: { - oneOf: [ - { - type: 'string', - }, - { - type: 'object', - }, - { - type: 'array', - items: { - type: 'integer', - format: 'int32', - minimum: 0, - maximum: 255, - }, - }, - ], - additionalProperties: true, - nullable: true, - }, - response: { - oneOf: [ - { - type: 'object', - additionalProperties: true, - }, - { - type: 'array', - items: {}, - }, - { - type: 'string', - }, - ], - nullable: true, - }, - }, - required: ['method', 'url'], - }, - RequestTimedOutResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 408, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Request timed out', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - TicketingAttachment: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - ticket_id: { - type: 'string', - example: 'ticket-001', - description: 'The reference ticket ID the attachment belongs to', - nullable: true, - }, - user_id: { - type: 'string', - description: 'The user who uploaded the file', - example: 'user-001', - nullable: true, - }, - file_name: { - type: 'string', - description: 'The name of the file', - example: 'file.pdf', - nullable: true, - }, - file_format: { - description: 'The type of the file', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/FileFormatEnum', - }, - ], - }, - file_url: { - type: 'string', - description: 'The resource URL of the file', - example: 'https://example.com/files/screenshot.png', - nullable: true, - }, - size: { - type: 'number', - description: 'The size of the file', - example: 1024, - nullable: true, - }, - created_at: { - type: 'string', - description: 'The timestamp when the record was created', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'The timestamp when the record was last updated', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - }, - }, - TicketingAttachmentResult: { - type: 'object', - properties: { - data: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/TicketingAttachment', - }, - ], - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - }, - TicketingAttachmentsPaginated: { - type: 'object', - properties: { - next: { - type: 'string', - nullable: true, - }, - data: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/TicketingAttachment', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - }, - TicketingComment: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - ticket_id: { - type: 'string', - description: 'The ticket ID associated with the comment', - example: 'ticket-001', - }, - user_id: { - type: 'string', - description: 'The user who created the comment', - example: 'user-001', - nullable: true, - }, - internal: { - description: 'Whether the comment is internal', - example: false, - oneOf: [ - { - type: 'boolean', - }, - { - type: 'string', - enum: ['true', 'false'], - }, - ], - nullable: true, - }, - content: { - description: 'Array of content associated with the comment', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/TicketingContent', - }, - }, - created_at: { - type: 'string', - description: 'The timestamp when the record was created', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'The timestamp when the record was last updated', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - }, - required: ['ticket_id'], - }, - TicketingCommentResult: { - type: 'object', - properties: { - data: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/TicketingComment', - }, - ], - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - }, - TicketingCommentsPaginated: { - type: 'object', - properties: { - next: { - type: 'string', - nullable: true, - }, - data: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/TicketingComment', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - }, - TicketingComponent: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - organization_id: { - type: 'string', - description: 'The organization id related to the component', - example: 'organization-001', - nullable: true, - }, - project_id: { - type: 'string', - description: 'The project id related to the component', - example: 'project-001', - nullable: true, - }, - name: { - type: 'string', - description: 'The name of the component', - example: 'Component Falcon', - nullable: true, - }, - description: { - type: 'string', - description: 'The description of the component', - example: 'Description of the component', - nullable: true, - }, - created_at: { - type: 'string', - description: 'The timestamp when the record was created', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'The timestamp when the record was last updated', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - }, - }, - TicketingComponentResult: { - type: 'object', - properties: { - data: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/TicketingComponent', - }, - ], - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - }, - TicketingComponentsPaginated: { - type: 'object', - properties: { - next: { - type: 'string', - nullable: true, - }, - data: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/TicketingComponent', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - }, - TicketingContent: { - type: 'object', - properties: { - plain: { - type: 'string', - description: 'The content of the ticket', - example: 'This is some content', - nullable: true, - }, - html: { - type: 'string', - description: 'The HTML content of the ticket', - example: 'This is some content
', - nullable: true, - }, - }, - }, - TicketingOrganization: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - domain: { - type: 'string', - description: 'The domain of the organization', - example: 'company.com', - nullable: true, - }, - name: { - type: 'string', - description: 'The name of the organization', - example: 'Company', - nullable: true, - }, - }, - }, - TicketingProject: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - name: { - type: 'string', - description: 'The name of the project', - example: 'Project Falcon', - nullable: true, - }, - description: { - type: 'string', - description: 'The description of the project', - example: 'Description of the project', - nullable: true, - }, - organization_id: { - type: 'string', - description: 'The organization id related to the project', - example: 'organization-001', - nullable: true, - }, - created_at: { - type: 'string', - description: 'The timestamp when the record was created', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'The timestamp when the record was last updated', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - }, - }, - TicketingProjectResult: { - type: 'object', - properties: { - data: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/TicketingProject', - }, - ], - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - }, - TicketingProjectsPaginated: { - type: 'object', - properties: { - next: { - type: 'string', - nullable: true, - }, - data: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/TicketingProject', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - }, - TicketingReadTicket: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - title: { - type: 'string', - description: 'The title or subject of the ticket', - example: 'System outage in production environment', - nullable: true, - }, - creator_id: { - type: 'string', - description: 'The creator of the ticket', - example: 'user-001', - nullable: true, - }, - reporters: { - description: 'Users who reported the ticket', - example: ['user-001', 'user-002'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - assignees: { - description: 'Agents assigned to the ticket', - example: ['user-001', 'user-002'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - content: { - description: 'Array of content associated with the ticket', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/TicketingContent', - }, - }, - parent_id: { - type: 'string', - description: 'ID of the parent ticket if this is a sub-ticket', - example: 'ticket-002', - nullable: true, - }, - priority: { - description: 'Priority of the ticket', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/TicketingTicketPriorityTypeEnum', - }, - ], - }, - tags: { - description: 'The tags of the ticket', - example: ['tag-001', 'tag-002'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - projects: { - description: 'Projects the ticket belongs to', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/TicketingProject', - }, - }, - ticket_number: { - type: 'string', - example: 'ticket-001', - description: 'The unique ticket number or reference ID', - nullable: true, - }, - type: { - description: 'The type of the ticket', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/TicketingTicketType', - }, - ], - }, - closed_at: { - type: 'string', - description: 'The date the ticket was closed', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - ticket_url: { - type: 'string', - description: 'URL to view the ticket in the source system', - example: 'https://help.company.com/tickets/SUP-5689', - nullable: true, - }, - status: { - description: 'Current status of the ticket', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/TicketingTicketStatus', - }, - ], - }, - organization: { - description: 'Organization associated with the ticket', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/TicketingOrganization', - }, - ], - }, - components: { - description: 'Components associated with the ticket', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/TicketingComponent', - }, - }, - created_at: { - type: 'string', - description: 'The timestamp when the record was created', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'The timestamp when the record was last updated', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - }, - }, - TicketingTicketCreateRequestDto: { - type: 'object', - properties: { - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - title: { - type: 'string', - description: 'The title or subject of the ticket', - example: 'System outage in production environment', - nullable: true, - }, - creator_id: { - type: 'string', - description: 'The creator of the ticket', - example: 'user-001', - nullable: true, - }, - reporters: { - description: 'Users who reported the ticket', - example: ['user-001', 'user-002'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - assignees: { - description: 'Agents assigned to the ticket', - example: ['user-001', 'user-002'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - content: { - description: 'Array of content associated with the ticket', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/TicketingContent', - }, - }, - parent_id: { - type: 'string', - description: 'ID of the parent ticket if this is a sub-ticket', - example: 'ticket-002', - nullable: true, - }, - priority: { - description: 'Priority of the ticket', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/TicketingTicketPriorityTypeEnum', - }, - ], - }, - tags: { - description: 'The tags of the ticket', - example: ['tag-001', 'tag-002'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - organization_id: { - type: 'string', - description: 'Organization associated with the ticket', - example: 'organization-001', - nullable: true, - }, - project_id: { - type: 'string', - description: 'Project the ticket belongs to', - example: 'project-001', - nullable: true, - }, - component_ids: { - type: 'string', - description: 'Components to associate with the ticket', - example: ['component-001', 'component-002'], - nullable: true, - }, - type: { - type: 'string', - description: 'The type of the ticket', - example: 'ticket-type-001', - nullable: true, - }, - }, - }, - TicketingTicketPriorityTypeEnum: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'The id of the ticket priority.', - example: '001', - nullable: true, - }, - value: { - type: 'string', - enum: ['lowest', 'low', 'medium', 'high', 'highest', 'unmapped_value', null], - description: 'The priority of the ticket.', - example: 'medium', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - description: 'The source value of the ticket priority.', - example: 'Normal', - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - TicketingTicketResult: { - type: 'object', - properties: { - data: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/TicketingReadTicket', - }, - ], - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - }, - TicketingTicketsPaginated: { - type: 'object', - properties: { - next: { - type: 'string', - nullable: true, - }, - data: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/TicketingReadTicket', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - }, - TicketingTicketStatus: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'The id of the ticket status.', - example: '001', - nullable: true, - }, - type: { - description: 'The type of this status', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/TicketingTicketStatusTypeEnum', - }, - ], - }, - name: { - type: 'string', - description: 'The name of the ticket status.', - example: 'Backlog', - nullable: true, - }, - }, - }, - TicketingTicketStatusesPaginated: { - type: 'object', - properties: { - next: { - type: 'string', - nullable: true, - }, - data: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/TicketingTicketStatus', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - }, - TicketingTicketStatusTypeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: ['to-do', 'in-progress', 'closed', 'unmapped_value', null], - description: 'The type of this status', - example: 'to-do', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - description: 'The source value of this status type', - example: 'New', - nullable: true, - }, - }, - }, - TicketingTicketType: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'The id of the ticket type.', - example: '001', - nullable: true, - }, - name: { - type: 'string', - description: 'The name of the ticket type.', - example: 'Task', - nullable: true, - }, - project_id: { - type: 'string', - description: 'The project the ticket type belongs to.', - example: 'project-001', - nullable: true, - }, - }, - }, - TicketingTicketTypePaginated: { - type: 'object', - properties: { - next: { - type: 'string', - nullable: true, - }, - data: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/TicketingTicketType', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - }, - TicketingTicketTypeResult: { - type: 'object', - properties: { - data: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/TicketingTicketType', - }, - ], - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - }, - TicketingTicketUpdateRequestDto: { - type: 'object', - properties: { - unified_custom_fields: { - type: 'object', - description: 'Custom Unified Fields configured in your StackOne project', - additionalProperties: true, - example: { - my_project_custom_field_1: 'REF-1236', - my_project_custom_field_2: 'some other value', - }, - nullable: true, - }, - title: { - type: 'string', - description: 'The title or subject of the ticket', - example: 'System outage in production environment', - nullable: true, - }, - reporters: { - description: 'Users who reported the ticket', - example: ['user-001', 'user-002'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - assignees: { - description: 'Agents assigned to the ticket', - example: ['user-001', 'user-002'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - content: { - description: 'Array of content associated with the ticket', - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/TicketingContent', - }, - }, - parent_id: { - type: 'string', - description: 'ID of the parent ticket if this is a sub-ticket', - example: 'ticket-002', - nullable: true, - }, - priority: { - description: 'Priority of the ticket', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/TicketingTicketPriorityTypeEnum', - }, - ], - }, - tags: { - description: 'The tags of the ticket', - example: ['tag-001', 'tag-002'], - nullable: true, - type: 'array', - items: { - type: 'string', - }, - }, - project_id: { - type: 'string', - description: 'Project the ticket belongs to', - example: 'project-001', - nullable: true, - }, - component_ids: { - type: 'string', - description: 'Components to associate with the ticket', - example: ['component-001', 'component-002'], - nullable: true, - }, - status: { - description: 'Current status of the ticket', - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/TicketingTicketStatus', - }, - ], - }, - }, - }, - TicketingUser: { - type: 'object', - properties: { - id: { - type: 'string', - description: 'Unique identifier', - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - remote_id: { - type: 'string', - description: "Provider's unique identifier", - example: '8187e5da-dc77-475e-9949-af0f1fa4e4e3', - nullable: true, - }, - type: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/TicketingUserTypeEnum', - }, - ], - }, - name: { - type: 'string', - description: 'John Doe', - example: 'John Doe', - nullable: true, - }, - primary_email: { - type: 'string', - description: "The user's primary email address", - example: 'john.doe@example.com', - nullable: true, - }, - primary_phone: { - type: 'string', - description: "The user's primary phone number", - example: '555-5555-5555', - nullable: true, - }, - username: { - type: 'string', - description: 'The username of the user in the provider system', - example: 'johndoe', - nullable: true, - }, - active: { - description: 'If the user is active', - example: true, - oneOf: [ - { - type: 'boolean', - }, - { - type: 'string', - enum: ['true', 'false'], - }, - ], - nullable: true, - }, - first_name: { - type: 'string', - description: 'The first name of the user', - example: 'John', - nullable: true, - }, - last_name: { - type: 'string', - description: 'The last name of the user', - example: 'Doe', - nullable: true, - }, - customer_account_reference: { - type: 'string', - description: - 'The unique account reference assigned as an external user (e.g. the customer account identifier registered on the customer-facing site or portal)', - example: 'JohnDoe123', - nullable: true, - }, - created_at: { - type: 'string', - description: 'The timestamp when the record was created', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - updated_at: { - type: 'string', - description: 'The timestamp when the record was last updated', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - nullable: true, - }, - }, - }, - TicketingUserResult: { - type: 'object', - properties: { - data: { - nullable: true, - allOf: [ - { - $ref: '#/components/schemas/TicketingUser', - }, - ], - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - }, - TicketingUsersPaginated: { - type: 'object', - properties: { - next: { - type: 'string', - nullable: true, - }, - data: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/TicketingUser', - }, - }, - raw: { - nullable: true, - type: 'array', - items: { - $ref: '#/components/schemas/RawResponse', - }, - }, - }, - }, - TicketingUserTypeEnum: { - type: 'object', - properties: { - value: { - type: 'string', - enum: ['agent', 'contact', 'bot', 'unmapped_value', null], - description: 'The type of the user.', - example: 'agent', - 'x-speakeasy-unknown-values': 'allow', - nullable: true, - }, - source_value: { - description: 'The source value of the user type.', - example: 'Live', - oneOf: [ - { - type: 'string', - }, - { - type: 'number', - }, - { - type: 'boolean', - }, - { - type: 'object', - }, - { - type: 'array', - items: {}, - }, - ], - nullable: true, - }, - }, - }, - TooManyRequestsResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 429, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Too many requests', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - UnauthorizedResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 401, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Unauthorized', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - UnifiedError: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 400, - nullable: true, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Bad Request', - nullable: true, - }, - headers: { - type: 'object', - description: 'Response headers', - example: { - 'content-type': 'application/json', - 'x-request-id': '5678c28b211dace4e0a0f9171e6b88c5', - }, - nullable: true, - }, - }, - }, - UnprocessableEntityResponse: { - type: 'object', - properties: { - statusCode: { - type: 'number', - description: 'HTTP status code', - example: 422, - }, - message: { - type: 'string', - description: 'Error message', - example: 'Unprocessable Entity', - }, - timestamp: { - type: 'string', - description: 'Timestamp when the error occurred', - example: '2023-05-30T00:00:00.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - UpdateResult: { - type: 'object', - properties: { - statusCode: { - type: 'number', - example: 200, - }, - message: { - type: 'string', - example: 'Record updated successfully.', - }, - timestamp: { - type: 'string', - example: '2021-01-01T01:01:01.000Z', - format: 'date-time', - }, - }, - required: ['statusCode', 'message', 'timestamp'], - }, - }, - }, -}; diff --git a/src/openapi/loader.ts b/src/openapi/loader.ts deleted file mode 100644 index 9b6102e9..00000000 --- a/src/openapi/loader.ts +++ /dev/null @@ -1,97 +0,0 @@ -import { ToolSetLoadError } from '../toolsets/base'; -import type { ToolDefinition } from '../types'; -import { readJsonFile } from '../utils/file'; -import { OpenAPIParser } from './parser'; - -// Import all specs from the generated index file -import * as specs from '../openapi/generated'; - -// Import the OpenAPIDocument type -import type { OpenAPIV3, OpenAPIV3_1 } from 'openapi-types'; -type OpenAPIDocument = OpenAPIV3.Document | OpenAPIV3_1.Document; - -/** - * Load all OpenAPI specs from the oas directory - * @param baseUrl Optional base URL to use for all operations - * @param removedParams Optional array of parameter names to remove from all tools - * @returns Dict mapping vertical names to their tool definitions - */ -export const loadStackOneSpecs = ( - baseUrl?: string, - removedParams: string[] = [] -): Record