Update integration by id

Updates the integration by id. Returns the updated integration, or null if not found.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
uuid
required
Body Params
string
length between 2 and 50

Display name for the integration

allowedDurations
array of objects | null, unique

Allowed durations (in seconds) for access requests to resources in this integration. If omitted or set to null, company defaults are used. Empty array is not allowed. Values must be from the predefined enum.

boolean

Allow actors to self-map accounts.

boolean

You must provide either requestable & requestableByDefault OR allowRequests & allowRequestsByDefault.

boolean

You must provide either requestable & requestableByDefault OR allowRequests & allowRequestsByDefault.

boolean

You must provide either requestable & requestableByDefault OR allowRequests & allowRequestsByDefault.

boolean

You must provide either requestable & requestableByDefault OR allowRequests & allowRequestsByDefault.

boolean

Auto-assign recommended maintainers.

boolean

Auto-assign recommended owners.

boolean

Notify on external permission changes.

workflow
object

Workflow to associate with this integration (object with 'id' UUID). To get available workflow IDs, use GET /public/v1/workflows.

owner
object

Owner of the integration (user entity object). To get user entities, use GET /public/v1/users. Provide an object with 'id' (UUID) or 'email' (string) to identify the user.

maintainers
array of objects

Maintainers of the integration. Each maintainer can be either a user or a group. For users, use GET /public/v1/users to get user IDs. For groups, use GET /public/v1/directoryGroups to get group IDs. Provide objects with 'type' ('user' or 'group') and 'id' (UUID).

maintainers
prerequisitePermissions
array of arrays of objects

Prerequisite permissions grouped by any-of/all-of sets. Outer array represents OR logic (any set can match), inner arrays represent AND logic (all permissions in a set must match). To get role permission IDs, use GET /public/v1/roles?resourceId=.

prerequisitePermissions
connectionJson
object

Connector configuration JSON (partial updates).

Response

Language
Credentials
Bearer
JWT
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

©2003-2026 BeyondTrust Corporation. All Rights Reserved. Other trademarks identified on this page are owned by their respective owners. BeyondTrust is not a chartered bank or trust company, or depository institution. It is not authorized to accept deposits or trust accounts and is not licensed or regulated by any state or federal banking authority.