swagger: '2.0'
info:
version: 1.0.0
title: Integration configurations API
basePath: /services/integration-api/v1
schemes:
- https
security:
- token: []
tags:
- name: configurations
paths:
/configurations:
get:
description: Returns a list of available processor configurations
tags:
- configurations
operationId: getProcessorConfigurations
consumes:
- application/json
produces:
- application/json
parameters:
- $ref: '#/parameters/connectorType'
- $ref: '#/parameters/connectorId'
- $ref: '#/parameters/connectorVersion'
- $ref: '#/parameters/processingDirection'
- $ref: '#/parameters/processingMode'
responses:
'200':
description: successful operation
schema:
type: array
$ref: '#/definitions/ProcessorConfiguration'
'403':
description: The user is not allowed to use this endpoint.
put:
description: Inserts a new processor configuration or updates an existing one
tags:
- configurations
operationId: upsertProcessorConfiguration
consumes:
- application/json
produces:
- application/json
parameters:
- in: body
name: body
required: false
schema:
$ref: '#/definitions/ProcessorConfiguration'
responses:
'204':
description: Upsert successful.
'403':
description: The user is not allowed to use this endpoint.
delete:
description: Delete a single processor configuration
tags:
- configurations
operationId: deleteProcessorConfiguration
consumes:
- application/json
produces:
- application/json
parameters:
- $ref: '#/parameters/connectorType'
- $ref: '#/parameters/connectorId'
- $ref: '#/parameters/connectorVersion'
- $ref: '#/parameters/processingDirection'
- $ref: '#/parameters/processingMode'
responses:
default:
description: successful operation
'400':
description: Not all necessary fields are set in parameters.
'403':
description: The user is not allowed to use this endpoint.
'404':
description: No such processor configuration found.
'422':
description: Could not process the given processor configuration.
definitions:
ProcessorConfiguration:
type: object
discriminator: processingDirection
required:
- connectorType
- connectorId
- connectorVersion
- processingDirection
properties:
connectorType:
description: The type of connector that is used
example: lxKubernetes
type: string
connectorId:
description: The identifier of the connector instance
example: Kub Dev-001
type: string
connectorVersion:
description: The version of the connector that is expected to process this LDIF file
example: 1.2.0
type: string
processingDirection:
description: The data flow direction, could be [inbound, outbound]
type: string
example: inbound
processingMode:
description: The processing mode, could be [partial, full]
type: string
default: partial
enum:
- partial
- full
sequentialExecution:
description: When set to true, all synchronizations runs processed by this processor configuration will be executed sequentially instead of in parallel.
type: boolean
default: false
parameters:
connectorId:
name: connectorId
description: The identifier of the connector instance
in: query
required: false
type: string
connectorType:
name: connectorType
description: The type of connector that is used
in: query
required: false
type: string
processingMode:
name: processingMode
description: The processing mode, could be [partial, full]
in: query
required: false
type: string
enum:
- partial
- full
connectorVersion:
name: connectorVersion
description: The version of the connector that is expected to process this LDIF file
in: query
required: false
type: string
processingDirection:
name: processingDirection
description: The data flow direction, could be [inbound, outbound]
in: query
required: false
type: string
enum:
- inbound
- outbound
securityDefinitions:
token:
type: oauth2
tokenUrl: /services/mtm/v1/oauth2/token
flow: application