Update an integration

PUT 
https://euwest.api.elasticpath.com/integrations/:integration_uuid

Updates the Integration for the given UUID. Specify whichever attributes you want to change. The values of the other attributes remain the same. If the attributes section is empty, the integration is not updated.

Request

Path Parameters

integration_uuid stringrequired

The unique identifier of the integration.

application/json

Body

data IntegrationUpdaterequired
typestringrequired
The type represents the object being returned. Always integration.
Possible values: [integration]
Default value: integration
Example: integration
namestring
The name of the integration.
Example: Order shipping notification
descriptionstring
A description of what the integration is for.
Example: Send a shipping notification via email with discount code
enabledboolean
Whether the integration is enabled.
Example: true
integration_typestring
Possible values: [webhook, aws_sqs, stomp]
Default value: webhook
Example: webhook
observesstring[]
The list of events you want to observe. See Observable Events.
configuration object
The content of the configuration object depends on the value of integration_type.
oneOf
AWSSQSConfigurationObject
WebhookConfigurationObject
STOMPConfigurationObject

Responses

200

Success. All integrations are returned

application/json

Schema

Schema

data object
idstring
The unique identifier of the integration.
Example: 2da46671-b4c2-44ac-b133-d1221aafc77b
typestring
The type represents the object being returned. Always integration.
Possible values: [integration]
Default value: integration
Example: integration
namestring
The name of the integration.
Example: Order shipping notification
descriptionstring
A description of what the integration is for.
Example: Send a shipping notification via email with discount code
enabledboolean
Whether the integration is enabled.
Example: true
integration_typestring
Specifies how the event is delivered. The options are webhook, aws-sqs, or stomp.
Possible values: [webhook, aws_sqs, stomp]
Default value: webhook
Example: webhook
observesstring[]
The list of events you want to observe. See Observable Events.
configuration object
oneOf
AWSSQSConfigurationObject
WebhookConfigurationObject
STOMPConfigurationObject
links object
Links are used to allow you to move between requests.
selfuri
Single entities use a self parameter with a link to that specific resource.
Example: ?page[offset]=0&page[limit]=25
meta object
timestamps Timestamps
The date and time a transaction is created.
created_atdate-time
The date and time an integration is updated.
Example: 2017-07-21T17:32:28Z
updated_atdate-time
The date and time an integration is updated.
Example: 2017-07-21T17:32:28Z
links object
links object
Links are used to allow you to move between requests.
selfuri
Single entities use a self parameter with a link to that specific resource.
Example: ?page[offset]=0&page[limit]=25
meta object
meta object
timestamps Timestamps
The date and time a transaction is created.
created_atdate-time
The date and time an integration is updated.
Example: 2017-07-21T17:32:28Z
updated_atdate-time
The date and time an integration is updated.
Example: 2017-07-21T17:32:28Z

Example (auto)

{
  "data": {
    "id": "2da46671-b4c2-44ac-b133-d1221aafc77b",
    "type": "integration",
    "name": "Order shipping notification",
    "description": "Send a shipping notification via email with discount code",
    "enabled": true,
    "integration_type": "webhook",
    "observes": [
      "string"
    ],
    "configuration": {
      "url": "https://sqs.eu-west-1.amazonaws.com/123456789/epcc-external-queue",
      "aws_access_key_id": "****************JIMB",
      "aws_secret_access_key": "************************************HK4o",
      "region": "eu-west-1"
    },
    "links": {
      "self": "?page[offset]=0&page[limit]=25"
    },
    "meta": {
      "timestamps": {
        "created_at": "2017-07-21T17:32:28Z",
        "updated_at": "2017-07-21T17:32:28Z"
      }
    }
  },
  "links": {
    "links": {
      "self": "?page[offset]=0&page[limit]=25"
    }
  },
  "meta": {
    "meta": {
      "timestamps": {
        "created_at": "2017-07-21T17:32:28Z",
        "updated_at": "2017-07-21T17:32:28Z"
      }
    }
  }
}

404

Not found. The requested entity does not exist.

application/json

Schema

Schema

errors ErrorBody[]required
Array [
statusint
The HTTP response code of the error.
Example: 500
titlestringrequired
A brief summary of the error.
Example: Internal server error
detailstring
Optional additional detail about the error.
Example: An internal error has occurred.
]

Example (auto)

{
  "errors": [
    {
      "status": 500,
      "title": "Internal server error",
      "detail": "An internal error has occurred."
    }
  ]
}

not-found

{
  "errors": [
    {
      "title": "Not Found",
      "status": 404,
      "detail": "The resource could not be found"
    }
  ]
}

422

Bad request. The request failed validation.

application/json

Schema

Schema

errors ErrorBody[]required
Array [
statusint
The HTTP response code of the error.
Example: 500
titlestringrequired
A brief summary of the error.
Example: Internal server error
detailstring
Optional additional detail about the error.
Example: An internal error has occurred.
]

Example (auto)

{
  "errors": [
    {
      "status": 500,
      "title": "Internal server error",
      "detail": "An internal error has occurred."
    }
  ]
}

missing-name

{
  "errors": [
    {
      "title": "Validation Error",
      "status": 400,
      "detail": "Your request was invalid"
    }
  ]
}

500

Internal server error. There was a system failure in the platform.

application/json

Schema

Schema

errors ErrorBody[]required
Array [
statusint
The HTTP response code of the error.
Example: 500
titlestringrequired
A brief summary of the error.
Example: Internal server error
detailstring
Optional additional detail about the error.
Example: An internal error has occurred.
]

Example (auto)

{
  "errors": [
    {
      "status": 500,
      "title": "Internal server error",
      "detail": "An internal error has occurred."
    }
  ]
}

internal-server-error

{
  "errors": [
    {
      "title": "Internal Server Error",
      "status": 500
    }
  ]
}

Authorization: http

name: bearerAuthtype: httpscheme: bearer

• csharp
• curl
• dart
• go
• http
• java
• javascript
• kotlin
• c
• nodejs
• objective-c
• ocaml
• php
• powershell
• python
• r
• ruby
• rust
• shell
• swift

• HTTPCLIENT
• RESTSHARP

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Put, "https://euwest.api.elasticpath.com/integrations/:integration_uuid");
request.Headers.Add("Accept", "application/json");
request.Headers.Add("Authorization", "Bearer <token>");
var content = new StringContent("{\n  \"data\": {\n    \"type\": \"integration\",\n    \"name\": \"Order shipping notification\",\n    \"description\": \"Send a shipping notification via email with discount code\",\n    \"enabled\": true,\n    \"integration_type\": \"webhook\",\n    \"observes\": [\n      \"string\"\n    ],\n    \"configuration\": {\n      \"url\": \"https://sqs.eu-west-1.amazonaws.com/123456789/epcc-external-queue\",\n      \"aws_access_key_id\": \"****************JIMB\",\n      \"aws_secret_access_key\": \"************************************HK4o\",\n      \"region\": \"eu-west-1\"\n    }\n  }\n}", null, "application/json");
request.Content = content;
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

Request Collapse all

Base URL

https://euwest.api.elasticpath.com

Auth

Bearer Token

Parameters

integration_uuid — pathrequired

Body

{
  "data": {
    "type": "integration",
    "name": "Order shipping notification",
    "description": "Send a shipping notification via email with discount code",
    "enabled": true,
    "integration_type": "webhook",
    "observes": [
      "string"
    ],
    "configuration": {
      "url": "https://sqs.eu-west-1.amazonaws.com/123456789/epcc-external-queue",
      "aws_access_key_id": "****************JIMB",
      "aws_secret_access_key": "************************************HK4o",
      "region": "eu-west-1"
    }
  }
}

ResponseClear

Click the Send API Request button above and see the response here!