---
title: "Update integration"
method: PATCH
path: "/integrations/{id}"
tags: ["Integrations"]
---

# Update integration

`PATCH /integrations/{id}`

## Path parameters

- `id` integer, required

## Request body

- union
  - object
    - `integration` object, required
      - `name` string — The name of the integration
      - `enabled` boolean — Whether the integration is enabled
      - `active_directory_group_id` string — The group ID of the Active Directory
      - `active_directory_tenant_id` string — The tenant ID of the Active Directory
      - `active_directory_user_email_property` 'mail' | 'userPrincipalName' — Which property match against when importing users
      - `group_id` integer, nullable — The group ID of the integration
      - `import_members_only` boolean — Whether users should be imported to the place or organization, without adding them to a group
  - object
    - `integration` object, required
      - `name` string — The name of the integration
      - `enabled` boolean — Whether the integration is enabled
      - `place_id` integer — The place ID of the integration
      - `api_key` string — The Braxos API key
  - object
    - `integration` object, required
      - `name` string — The name of the integration
      - `enabled` boolean — Whether the integration is enabled
      - `url` string, uri — The URL to call when events are triggered
      - `enabled_events` string[] — The event types for which the webhook would be enabled.
      - `signature_key` string — The key to use for webhook payload signatures. We build and attach the signature as follows: - Take the body - Calculate the HMAC-SHA256 MAC using the body as payload and the signature key as key - Set the "X-Signature" header to `sha256=<MAC>`
  - object
    - `integration` object, required
      - `name` string — The name of the integration
      - `enabled` boolean — Whether the integration is enabled
      - `jumpcloud_organization_id` string, nullable — The ID of the organization in JumpCloud to import from. Required for multi-tenant JumpCloud users.
      - `jumpcloud_group_id` string, nullable — The ID of the group in JumpCloud to import from. Required to enable integration
      - `group_id` integer, nullable — The group ID of the integration
      - `import_members_only` boolean — Whether users should be imported to the place or organization, without adding them to a group
      - `api_key` string — The JumpCloud API key
  - object
    - `integration` object, required
      - `name` string — The name of the integration
      - `enabled` boolean — Whether the integration is enabled
      - `place_id` integer — The place ID of the integration
      - `api_key` string — The Rhombus Systems API key
      - `certificate` string — The Rhombus Systems certificate
      - `private_key` string — The Rhombus Systems private key

## Response `204`

No Content

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `422` — Unprocessable Content

---

[API](https://skmtc.dev/kisi/apis/kisi-api.md) · [All operations](https://skmtc.dev/kisi/apis/kisi-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/kisi/kisi-api/revisions/998700ffff5a/schema)