openapi: 3.2.0 info: title: Admin - Voice Comm Manager Job Details API description: 'The Voice provider APIs are used to manage information about voice specific elements and different voice related entities e.g. Phone numbers. Voice Services will support multiple ways to provision voice providers 1. Programmatic Interface (Rest APIs) 2. User Interface' contact: name: Avaya API Team url: https://developers.avayacloud.com/onecloud-ccaas email: apiteam@avaya.com license: name: Avaya Software Development Kit (SDK) Software License Terms url: http://support.avaya.com/css/P8/documents/101038288 version: 1.0.2 servers: - url: '{protocol}://{server}{basePath}' description: Open API variables: protocol: enum: - https default: https server: default: HOST-REGION.api.avayacloud.com basePath: default: /api/admin/voice/v1 security: - {} - BearerAuth: [] AppKey: [] tags: - name: Comm Manager Job Details description: This API is used to get details of list of jobs or a single job for a specific Communication Manager. These API are expected to be called by an account administrator. paths: /accounts/{accountId}/communication-managers/{communicationManagerId}/jobs/{jobId}: get: tags: - Comm Manager Job Details summary: Get a single job description: '**This API requires the Account Administrator role.** Gets a single job by its job id.' operationId: getJob parameters: - $ref: '#/components/parameters/accountId' - $ref: '#/components/parameters/communicationManagerId' - $ref: '#/components/parameters/jobId' responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/Job' examples: default: $ref: '#/components/examples/JobResponse' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '500': $ref: '#/components/responses/InternalServerError' /accounts/{accountId}/communication-managers/{communicationManagerId}/jobs/{jobId}:details: get: tags: - Comm Manager Job Details summary: Get details of a single job description: '**This API requires the Account Administrator role.** Gets details of a single job by its job id.' operationId: getJobDetails parameters: - $ref: '#/components/parameters/accountId' - $ref: '#/components/parameters/communicationManagerId' - $ref: '#/components/parameters/jobId' - name: entityType in: query description: The optional entity type to query required: false schema: type: string enum: - AGENT - EXTENSION - REASONCODE_AUX - SYSTEM_PARAMETER_FEATURES example: AGENT responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/JobDetails' examples: default: $ref: '#/components/examples/JobDetailsResponse' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '500': $ref: '#/components/responses/InternalServerError' /accounts/{accountId}/communication-managers/{communicationManagerId}/jobs/{jobId}:entity-details: get: tags: - Comm Manager Job Details summary: Get entity details of a job description: '**This API requires the Account Administrator role.** Gets details of a sync entity by its job id.' operationId: getEntityDetails parameters: - $ref: '#/components/parameters/accountId' - $ref: '#/components/parameters/communicationManagerId' - $ref: '#/components/parameters/jobId' - name: entityType in: query description: The optional entity type to query required: true schema: type: string enum: - AGENT - EXTENSION - REASONCODE_AUX - SYSTEM_PARAMETER_FEATURES example: AGENT - name: statusCode in: query description: The optional job status code to query required: false schema: type: string enum: - IN_PROGRESS - COMPLETED - FAILED - CREATED - UPDATED - DELETED - CREATE_IN_PROGRESS - UPDATE_IN_PROGRESS - DELETE_IN_PROGRESS - NEEDS_ACTION example: COMPLETED - name: filter in: query required: false description: "Specifies details of a row filter.\n The possible fields that can be filtered on are:\n * Name\n * Number\n * StatusCode\nField Names are case-senstive (should be written as it is in description).\nThe allowed format:\n - Begins with the column name to be filtered, followed by a colon will be used to find out word that contains given value.\n" schema: type: string maxLength: 255 examples: contains: description: Example of filtering based on an contains string. value: Name:dummyName - $ref: '#/components/parameters/pageNumber' - name: pageSize in: query description: The maximum number of results per page. Default value is 10, max value is 100. required: false schema: type: integer format: int32 example: 10 default: 10 minimum: 1 maximum: 100 - name: orderBy in: query required: false description: 'Specifies how response data should be sorted. createdAt and updatedAt are valid options. Field Names are case-senstive (should be written as it is in description). To specify descending order, a suffix " desc" should be added. For example, "createdAt" for ascending or "createdAt desc" for descending". The default sorting order is createdAt ascending. ' schema: type: string default: createdAt desc maxLength: 255 examples: orderByCreatedAtInAscendingOrder: value: createdAt summary: sort data based on createdAt in ascending order orderByCreatedAtInDescendingOrder: value: createdAt desc summary: sort data based on createdAt in descending order orderByUpdatedAtInAscendingOrder: value: updatedAt summary: sort data based on updatedAt in ascending order orderByUpdatedAtInDescendingOrder: value: updatedAt desc summary: sort data based on updatedAt in descending order responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/SyncEntityDetailsPage' examples: default: $ref: '#/components/examples/SyncEntityDetailsResponse' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '500': $ref: '#/components/responses/InternalServerError' /accounts/{accountId}/communication-managers/{communicationManagerId}/jobs: get: tags: - Comm Manager Job Details summary: Lists all the jobs description: '**This API requires the Account Administrator role.** Lists all the jobs for the specified Communication Manager.' operationId: listJobs parameters: - $ref: '#/components/parameters/accountId' - $ref: '#/components/parameters/communicationManagerId' - name: name in: query description: "The optional name of the job to query.\nThe allowed format:\n - Begins with the column name to be filtered, followed by a colon, then:\n - Either an exact string to match, or\n - A string expression including the * wildcard character\n - :{PREFIX}* will be used to find out word start with.\n - :*{POSTFIX} will be used to find out word end with\n - : will be used to match exact word\n - Begin with column name to be filtered, followed by a = operator. (this will be used to match exact string)\n" required: false schema: type: string minLength: 1 maxLength: 255 examples: exact: description: Example of filtering based on an exact string. value: name=FullSync_SYNC_Sat Mar 18 16:20:46 GMT 2023 prefix: description: Example of filtering based on a prefix string. value: name:FullSync_SYNC_Sat* postfix: description: Example of filtering based on a postfix string. value: name:*GMT 2024 - name: statusCode in: query description: The optional job status code to query required: false schema: type: string enum: - QUEUED - IN_PROGRESS - COMPLETED - TIMEOUT_FAILED - FAILED - NEEDS_ACTION example: FAILED - name: type in: query description: The optional type of job to query required: false schema: type: string enum: - SYNC - INCREMENTAL_SYNC example: SYNC - $ref: '#/components/parameters/pageNumber' - name: pageSize in: query description: The maximum number of results per page. Default value is 10, max value is 100. required: false schema: type: integer format: int32 example: 10 default: 10 minimum: 1 maximum: 100 - name: orderBy in: query required: false description: 'Specifies how response data should be sorted. name, type, statusCode, createdAt and updatedAt are valid options. Field Names are case-senstive (should be written as it is in description). To specify descending order, a suffix " desc" should be added. For example, "name" for ascending or "name desc" for descending". The default sorting order is name ascending. ' schema: type: string default: createdAt desc maxLength: 255 examples: orderByNameInAscendingOrder: value: name summary: sort data based on name in ascending order orderByNameInDescendingOrder: value: name desc summary: sort data based on name in descending order orderByTypeInAscendingOrder: value: type summary: sort data based on type in ascending order orderByTypeInDescendingOrder: value: type desc summary: sort data based on type in descending order orderByStatusCodeInAscendingOrder: value: statusCode summary: sort data based on statusCode in ascending order orderByStatusCodeInDescendingOrder: value: statusCode desc summary: sort data based on statusCode in descending order orderByCreatedAtInAscendingOrder: value: createdAt summary: sort data based on createdAt in ascending order orderByCreatedAtInDescendingOrder: value: createdAt desc summary: sort data based on createdAt in descending order orderByUpdatedAtInAscendingOrder: value: updatedAt summary: sort data based on updatedAt in ascending order orderByUpdatedAtInDescendingOrder: value: updatedAt desc summary: sort data based on updatedAt in descending order responses: '200': description: OK content: application/json: schema: $ref: '#/components/schemas/JobPage' examples: default: $ref: '#/components/examples/JobPageResponse' '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '500': $ref: '#/components/responses/InternalServerError' /accounts/{accountId}/communication-managers/{communicationManagerId}/jobs/{jobId}:abort: post: tags: - Comm Manager Job Details summary: Abort sync job execution description: '**This API requires the Account Administrator role.** Abort execution of a job by its job id.' operationId: abortJob parameters: - $ref: '#/components/parameters/accountId' - $ref: '#/components/parameters/communicationManagerId' - $ref: '#/components/parameters/jobId' responses: '202': description: Accepted '401': $ref: '#/components/responses/Unauthorized' '403': $ref: '#/components/responses/Forbidden' '404': $ref: '#/components/responses/NotFound' '405': $ref: '#/components/responses/MethodNotAllowed' '500': $ref: '#/components/responses/InternalServerError' components: responses: MethodNotAllowed: description: Method Not Allowed content: application/problem+json: schema: $ref: '#/components/schemas/Problem' examples: default: $ref: '#/components/examples/ErrorMethodNotAllowed' InternalServerError: description: All other application errors content: application/problem+json: schema: $ref: '#/components/schemas/Problem' examples: default: $ref: '#/components/examples/ErrorInternalServerError' Unauthorized: description: Unauthorized content: application/problem+json: schema: $ref: '#/components/schemas/Problem' examples: default: $ref: '#/components/examples/ErrorUnauthorized' NotFound: description: Not Found content: application/problem+json: schema: $ref: '#/components/schemas/Problem' examples: default: $ref: '#/components/examples/ErrorNotFound' Forbidden: description: Forbidden content: application/problem+json: schema: $ref: '#/components/schemas/Problem' examples: default: $ref: '#/components/examples/ErrorForbidden' schemas: AgentSyncData: type: object properties: name: type: string description: Name of agent example: agent001 number: type: string description: Number assigned to agent example: '101' loginId: type: string description: Login Id of the associated user example: user@avaya.com SystemParameterFeaturesSyncData: type: object properties: name: type: string description: Name of system parameter feature example: auxWorkResonCodeType value: type: string description: value of System parameter feature example: forced JobPage: type: object description: List of jobs for the Communication Manager properties: pagination: $ref: '#/components/schemas/Pagination' jobs: type: array items: $ref: '#/components/schemas/Job' links: allOf: - $ref: '#/components/schemas/Links' example: prev: /api/admin/voice/v1/accounts/ASDJGE/communication-managers/a4c2c9b5-0e47-491d-b139-dc48cccdea72/jobs?pageNumber=1&pageSize=10 next: /api/admin/voice/v1/accounts/ASDJGE/communication-managers/a4c2c9b5-0e47-491d-b139-dc48cccdea72/jobs?pageNumber=3&pageSize=10 ReasonCodeSyncData: type: object properties: name: type: string description: Name of reason code example: rc001 number: type: string description: Number of the reason code example: '1' EntityData: type: object description: details for entity data properties: agent: $ref: '#/components/schemas/AgentSyncData' extension: $ref: '#/components/schemas/ExtensionSyncData' reasonCode: $ref: '#/components/schemas/ReasonCodeSyncData' systemParameterFeatures: $ref: '#/components/schemas/SystemParameterFeaturesSyncData' Problem: type: object description: 'Problem Detail as a way to carry machine-readable details of errors in a HTTP response to avoid the need to define new error response formats for HTTP APIs RFC 7807 ' properties: type: type: string format: uri description: 'An absolute URI that identifies the problem type. When dereferenced, it SHOULD provide human-readable documentation for the problem type (e.g., using HTML). ' default: about:blank example: https://developers.avayacloud.com/onecloud-ccaas/docs/error-handling#constraint-violation title: type: - string - 'null' description: 'A short, summary of the problem type. Written in english and readable for engineers (usually not suited for non technical stakeholders and not localized). ' example: Service Unavailable status: type: - integer - 'null' format: int32 description: 'The HTTP status code generated by the origin server for this occurrence of the problem. ' minimum: 100 example: 503 exclusiveMaximum: 600 detail: type: - string - 'null' description: 'A human readable explanation specific to this occurrence of the problem. ' example: Connection to database timed out instance: type: - string - 'null' format: uri description: 'An absolute URI that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced. ' violations: type: - array - 'null' description: 'A list of violations that occurred as a result of invalid data provided as part of a request. ' items: type: object properties: field: type: string description: 'The name of the field in the request that caused the violation. This can be the name of a path parameter, query parameter, or a field within the request body. ' example: accountId message: type: string description: 'A human readable explanation specific to this occurrence of the violation. ' example: must match "^[a-zA-Z]{6}$" code: type: integer format: int32 description: 'The violation code generated by the server for this occurrence of the violation. Use this code when implementing any error handling logic instead of the message, as the message can change. ' example: 20006 example: - field: emailAddress message: must not be null code: 20002 - field: accountId message: must match "^[a-zA-Z]{6}$" code: 20006 JobDetails: type: object description: Details of a single job properties: jobEntityDetails: type: array items: $ref: '#/components/schemas/JobEntityDetails' SyncEntityDetailsPage: type: object description: List of sync entity details data properties: pagination: $ref: '#/components/schemas/Pagination' syncEntityDetails: type: array items: $ref: '#/components/schemas/SyncEntityData' links: allOf: - $ref: '#/components/schemas/Links' example: prev: /api/admin/voice/v1/accounts/ASDJGE/communication-managers/a4c2c9b5-0e47-491d-b139-dc48cccdea72/jobs?entityType=AGENT&pageNumber=1&pageSize=10 next: /api/admin/voice/v1/accounts/ASDJGE/communication-managers/a4c2c9b5-0e47-491d-b139-dc48cccdea72/jobs?entityType=AGENTpageNumber=3&pageSize=10 SyncEntityData: type: object description: Details of sync entity data properties: id: type: string readOnly: true entityType: type: string enum: - AGENT - EXTENSION - REASONCODE - SYSTEM_PARAMETER_FEATURES readOnly: true description: Type of the entity example: AGENT entityData: $ref: '#/components/schemas/EntityData' createdAt: type: string readOnly: true format: date-time description: Specifies the date-time in UTC format when the job was created example: 2020-04-21T17:40:28z updateAt: type: string readOnly: true format: date-time description: Specifies the date-time in UTC format when the job was created example: 2020-04-21T17:42:28z statusCode: type: string description: Status of sync entity enum: - COMPLETED - FAILED - IN_PROGRESS - CREATED - UPDATED - DELETED - CREATE_IN_PROGRESS - UPDATE_IN_PROGRESS - NEEDS_ACTION example: COMPLETED statusMessage: type: string description: Message status of sync entity example: Successfully synced ExtensionSyncData: type: object properties: name: type: string description: Name of extention example: extention002 number: type: string description: Number assigned to extention example: '102' JobEntityDetails: type: object description: Details of the entities pertaining to a job properties: entityType: type: string enum: - AGENT - EXTENSION - VDN - REASONCODE_AUX - REASONCODE_LOGOUT - SYSTEM_PARAMETER_FEATURES description: Name of job entity example: AGENT entityStatus: type: string enum: - COMPLETED - FAILED - IN_PROGRESS - CREATED - UPDATED - DELETED - CREATE_IN_PROGRESS - UPDATE_IN_PROGRESS - DELETE_IN_PROGRESS - NEEDS_ACTION description: Status of job entity example: COMPLETED entitySyncDetails: type: array items: $ref: '#/components/schemas/SyncEntityDetails' SyncEntityDetails: type: object properties: entityCount: type: integer format: int64 description: The total number of objects of an entity received in job response example: 20 statusCode: type: string description: Status of the job entity enum: - IN_PROGRESS - FAILED - COMPLETED - CREATED - UPDATED - DELETED - CREATE_IN_PROGRESS - UPDATE_IN_PROGRESS - NEEDS_ACTION example: COMPLETED statusMessage: type: string description: Success or Failure message of the job entity example: Synchronization completed Job: type: object description: Details of a single job properties: id: type: string format: uuid readOnly: true example: fa703a3a-3dfb-4606-ae79-fd0fe0be3e64 description: The unique id of the job. name: type: string example: FullSync_SYNC_Mon Feb 27 10:13:22 GMT 2023 description: The name of the job. If not provided, job name is set using pattern 'FullSync_{JOBTYPE}_{GMT_DateTime}' type: type: string description: The type of job. enum: - SYNC - INCREMENTAL_SYNC example: SYNC statusCode: type: string description: Status code of the job enum: - QUEUED - IN_PROGRESS - COMPLETED - TIMEOUT_FAILED - FAILED - NEEDS_ACTION example: IN_PROGRESS statusMessage: type: string description: Success or Failure message of job example: Synchronization completed createdAt: type: string readOnly: true format: date-time description: Specifies the date-time in UTC format when the job was created example: 2020-04-21T17:40:28z updatedAt: type: string readOnly: true format: date-time description: Specifies the date-time in UTC format when the job was last updated example: 2020-04-21T17:40:28z Pagination: type: object properties: pageNumber: type: integer description: The current page number. pageSize: type: integer description: The max number of records that can be retrieved on this page. total: type: integer description: The total number of records. Links: type: object properties: prev: type: string description: URL of the previous page. Blank if currently on the first page. next: type: string description: URL of the next page. Blank if currently on the last page. examples: ErrorForbidden: description: Forbidden value: type: https://developers.avayacloud.com/onecloud-ccaas/docs/error-handling#forbidden title: Forbidden status: 403 detail: According to the access control policy the current user does not have permission to access this resource. JobResponse: description: Single job response value: id: 18e4f754-5e42-4387-ae13-e9b4fe4aed29 name: FullSync_SYNC_Mon Feb 27 10:13:22 GMT 2023 type: SYNC statusCode: COMPLETED statusMessage: Synchronization completed createdAt: 2020-04-21T17:40:28z updatedAt: 2020-04-21T18:30:28z JobPageResponse: description: Jobs List Example value: pagination: pageNumber: 2 pageSize: 2 total: 3 jobs: - id: 18e4f754-5e42-4387-ae13-e9b4fe4aed29 name: FullSync_SYNC_Mon Feb 27 10:13:22 GMT 2023 type: SYNC statusCode: COMPLETED statusMessage: Synchronization completed createdAt: 2020-04-21T17:40:28z updatedAt: 2020-04-21T18:30:28z links: prev: /api/admin/v1/accounts/ASDJGE/communication-managers/a4c2c9b5-0e47-491d-b139-dc48cccdea72/jobs?pageNumber=1&pageSize=2 next: /api/admin/v1/accounts/ASDJGE/communication-managers/a4c2c9b5-0e47-491d-b139-dc48cccdea72/jobs?pageNumber=3&pageSize=2 ErrorNotFound: description: Not Found value: type: https://developers.avayacloud.com/onecloud-ccaas/docs/error-handling#resource-not-found title: Resource Not Found status: 404 detail: Either there is no API method associated with the URL path of the request, or the request refers to one or more resources that were not found. SyncEntityDetailsResponse: description: Details of a sync entity data value: pagination: pageNumber: 2 pageSize: 2 total: 3 syncEntityDetails: - id: fa703a3a-3dfb-4606-ae79-fd0fe0df3e64 createdAt: 2020-04-21T17:40:28z updateAt: 2020-04-21T17:40:29z entityType: AGENT entityData: agent: name: agent101 number: '101' loginId: user@avaya.com statusCode: COMPLETED statusMessage: Synchronized successfully - id: pk703a3a-3dfb-4606-ae79-fd0fe0be3e98 createdAt: 2020-04-21T17:40:45z updateAt: 2020-04-21T17:40:56z entityType: AGENT entityData: agent: name: agent101 number: '101' loginId: user@avaya.com statusCode: COMPLETED statusMessage: Synchronized successfully links: prev: /api/admin/voice/v1/accounts/ASDJGE/communication-managers/a4c2c9b5-0e47-491d-b139-dc48cccdea72/jobs?entityType?AGENT&pageNumber=1&pageSize=2 next: /api/admin/voice/v1/accounts/ASDJGE/communication-managers/a4c2c9b5-0e47-491d-b139-dc48cccdea72/jobs?entityType?AGENT&pageNumber=3&pageSize=2 ErrorUnauthorized: description: Unauthorized value: type: https://developers.avayacloud.com/onecloud-ccaas/docs/error-handling#unauthorized title: Unauthorized status: 401 detail: This operation requires authentication. See https://developers.avayacloud.com/onecloud-ccaas/docs/how-to-authenticate-with-ccaas-apis ErrorMethodNotAllowed: description: Method not allowed value: title: Method not allowed status: 405 detail: The request calls an HTTP method that is not supported at the resource. JobDetailsResponse: description: Details of a single job value: jobEntityDetails: - entityType: AGENT entityStatus: COMPLETED entitySyncDetails: - entityCount: 20 statusCode: COMPLETED statusMessage: Synchronization completed successfully - entityCount: 2 statusCode: FAILED statusMessage: Synchronization failed because of incorrect domain name. - entityCount: 5 statusCode: IN_PROGRESS statusMessage: Synchronization is in progress. - entityCount: 5 statusCode: CREATED statusMessage: Synchronization completed successfully - entityCount: 5 statusCode: UPDATED statusMessage: Synchronization completed successfully - entityCount: 5 statusCode: CREATE_IN_PROGRESS statusMessage: Synchronization create is in progress. - entityCount: 5 statusCode: UPDATE_IN_PROGRESS statusMessage: Synchronization update is in progress. - entityCount: 5 statusCode: DELETED statusMessage: Synchronization completed successfully - entityCount: 5 statusCode: NEEDS_ACTION statusMessage: Synchronization needs action. ErrorInternalServerError: description: Server Error value: type: https://developers.avayacloud.com/onecloud-ccaas/docs/error-handling#server-error title: Server Error status: 500 detail: An internal server error was encountered. parameters: jobId: name: jobId in: path description: The unique 36 character internal id of the Job required: true schema: type: string format: uuid example: a4c2c9b5-0e47-491d-b139-dc48cccdea72 accountId: name: accountId description: The unique 6 character internal id that represents the customer account. required: true in: path schema: type: string minLength: 6 maxLength: 6 pattern: ^[a-zA-Z]{6}$ example: ABCDEF communicationManagerId: name: communicationManagerId description: The unique id of the Communication Manager in: path required: true schema: type: string format: uuid example: 2ec20580-d204-43f3-ae0b-34795439137f pageNumber: name: pageNumber in: query description: The page number of the records to retrieve. Default value is 1. required: false schema: type: integer format: int32 example: 1 default: 1 minimum: 1 securitySchemes: BearerAuth: type: http scheme: bearer description: This API uses Bearer Token Authorization Flow bearerFormat: JWT AppKey: type: apiKey in: header name: appkey description: This API needs an appKey as header x-explorer-enabled: false x-samples-languages: - curl - node - java - javascript - python - go