Pexip Engage API documentation

Create a fetch configuration

POST /fetch-configurations

OAuth2

Create a fetch configuration

Headers

Authorization string

Bearer token used for authorization

Minimum length is 1.
X-Correlation-Id string

Unique identifier to allow referencing a particular transaction or event chain

Minimum length is 1.

application/json

Body Required

body string | null

Minimum length is 1.
mapping array[object] Required

At least 1 element.
Hide mapping attributes Show mapping attributes object
- sourceProperty string Required
  
  Minimum length is 1.
- targetProperty string Required
  
  Minimum length is 1, maximum length is 512.
- Additional properties are NOT allowed
endpoint string(uri) Required

Minimum length is 1.
method string Required

Values are DELETE, GET, PATCH, POST, or PUT.
headers array[object] | null

At least 1 element.
Hide headers attributes Show headers attributes object
- name string Required
  
  Minimum length is 1.
- value string Required
  
  Minimum length is 1.
- Additional properties are NOT allowed
Additional properties are NOT allowed

Responses

• 201 application/json

Successful operation
Hide response attributes Show response attributes object
- data object Required
  
  Hide data attributes Show data attributes
  
  id string Required
  
  Minimum length is 1.
  
  body string | null
  
  Minimum length is 1.
  
  mapping array[object] Required
  
  At least 1 element.
  
  Hide mapping attributes Show mapping attributes object
  
  sourceProperty string Required
  
  Minimum length is 1.
  
  targetProperty string Required
  
  Minimum length is 1, maximum length is 512.
  
  Additional properties are NOT allowed
  
  endpoint string(uri) Required
  
  Minimum length is 1.
  
  method string Required
  
  Values are DELETE, GET, PATCH, POST, or PUT.
  
  headers array[object] Required
  
  At least 1 element.
  
  Hide headers attributes Show headers attributes object
  
  name string Required
  
  Minimum length is 1.
  
  Additional properties are NOT allowed
  
  createdAt string(date-time) Required
  
  Minimum length is 1.
  
  updatedAt string(date-time) Required
  
  Minimum length is 1.
  
  deletedAt string(date-time) | null Required
  
  Minimum length is 1.
  
  Additional properties are NOT allowed
- Additional properties are NOT allowed
• 422 application/json

Business validation failed

See Error codes
Hide response attribute Show response attribute object
- errors array[object] Required
  
  At least 1 element.
  
  Hide errors attributes Show errors attributes object
  
  message string Required
  
  Minimum length is 1.
  
  code string Required
  
  Minimum length is 1.
  
  type string Required
  
  Minimum length is 1.
  
  statusCode string Required
  
  Minimum length is 1.
  
  arguments object | null

POST /fetch-configurations

curl \
 -X POST https://api.pexipengage.com/enterprises/acme/fetch-configurations \
 -H "Content-Type: application/json" \
 -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c" \
 -H "X-Correlation-Id: a4f0048e-c983-11ed-afa1-0242ac120002" \
 -d '{"body":"string","mapping":[{"sourceProperty":"string","targetProperty":"string"}],"endpoint":"https://wwww.example.net/abc123","method":"DELETE","headers":[{"name":"Authorization","value":"apiKey ABCDEFG"}]}'

Request example

# Headers
Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c
X-Correlation-Id: a4f0048e-c983-11ed-afa1-0242ac120002

# Payload
{
  "body": "string",
  "mapping": [
    {
      "sourceProperty": "string",
      "targetProperty": "string"
    }
  ],
  "endpoint": "https://wwww.example.net/abc123",
  "method": "DELETE",
  "headers": [
    {
      "name": "Authorization",
      "value": "apiKey ABCDEFG"
    }
  ]
}

Response examples (201)

{
  "data": {
    "id": "123",
    "body": "string",
    "mapping": [
      {
        "sourceProperty": "string",
        "targetProperty": "string"
      }
    ],
    "endpoint": "https://wwww.example.net/abc123",
    "method": "DELETE",
    "headers": [
      {
        "name": "Authorization"
      }
    ],
    "createdAt": "2022-08-17T19:05:21.362Z",
    "updatedAt": "2022-08-17T19:05:21.362Z",
    "deletedAt": "2022-08-17T19:05:21.362Z"
  }
}

Response examples (422)

{
  "errors": [
    {
      "message": "string",
      "code": "string",
      "type": "string",
      "statusCode": "string",
      "arguments": {}
    }
  ]
}