---
title: "Patch Customer Integration"
method: PATCH
path: "/v1/integrate/clouds/{integrationId}"
tags: ["IoT Integrator"]
---

# Patch Customer Integration

`PATCH /v1/integrate/clouds/{integrationId}`

## Request

- Base URL: `https://api.1nce.com/management-api`
- URL: `https://api.1nce.com/management-api/v1/integrate/clouds/{integrationId}`
- Auth: HTTP bearer

Patch Customer Integration

## Path parameters

- `integrationId` string, required

## Request body

- Patchschema3: Patch integration request
  - `url` string, uri: URL of the webhook (HTTPS required)
  - `headers` object: Headers that should be sent to the webhook. Only string values and no nested objects
  - `eventTypes` Patchschema3EventTypesInner[]: A list of all event types
    - `type` 'TELEMETRY_DATA' | 'LIFECYCLE' | 'ERROR' | 'GEOFENCE' | 'LOCATION', required: Name of the event type
    - `version` string: Version of the event type
  - `jsonPayloadEnabled` boolean: Flag if the payloads of this integration should be bridged in JSON format.

## Response `200`

Customer Integration Details.

- PatchResponseschema1: Patch integration response
  - `name` string, required: Name of the integration.
  - `eventTypes` PostResponseschema5EventTypesInner[], required: A list of event types
    - `type` 'TELEMETRY_DATA' | 'LIFECYCLE' | 'ERROR' | 'GEOFENCE' | 'LOCATION', required: Name of the event type
    - `version` string, required: Version of the event type
  - `state` 'ROLLOUT_STARTED' | 'ROLLOUT_DONE' | 'ROLLOUT_FAILED' | 'INTEGRATION_ACTIVE' | 'INTEGRATION_FAILED', required: State of the integration.
  - `type` 'WEBHOOK' | 'AWS', required: Type of the integration.
  - `id` string, required: ID of the integration.
  - `createdTime` string, date-time, required: Created timestamp of the integration.
  - `updatedTime` string, date-time, required: Updated timestamp of the integration.
  - `awsAccountId` string: AWS Account Id where the stack was deployed, only showed when AWS Integration
  - `region` string: AWS Region where the stack was deployed, only showed when AWS Integration
  - `jwt` string: JWT token with details for integration stack creation
  - `headers` object: Headers of the integration.
  - `url` string, uri: URL of the integration.
  - `jsonPayloadEnabled` boolean, required: Flag if the payloads of this integration should be bridged in JSON format.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found Error
- `409`: Conflict
- `500`: Internal Server Error

---

[API](https://skmtc.dev/1nce/apis/1nce-os.md) - [All operations](https://skmtc.dev/1nce/apis/1nce-os/llms.txt) - [OpenAPI document](https://skmtc.dev/1nce/apis/1nce-os/revisions/f1aabbc6aeea?raw)