--- title: "Update an existing third-party integration" method: PATCH path: "/projects/{projectId}/integrations/{integrationId}" tags: ["Third-Party Integrations"] --- # Update an existing third-party integration `PATCH /projects/{projectId}/integrations/{integrationId}` ## Path parameters - `projectId` string, required - `integrationId` string, required ## Request body - union - BitbucketIntegrationPatch - `type` string, required - `fetch_branches` boolean — Whether or not to fetch branches. - `prune_branches` boolean — Whether or not to remove branches that disappeared remotely (requires `fetch_branches`). - `environment_init_resources` 'default' | 'manual' | 'minimum' | 'parent' — The resources used when initializing a new service - `app_credentials` object, nullable — The OAuth2 consumer information (optional). - `key` string, required — The OAuth consumer key. - `secret` string, required — The OAuth consumer secret. - `addon_credentials` object, nullable — The addon credential information (optional). - `addon_key` string, required — The addon key (public identifier). - `client_key` string, required — The client key (public identifier). - `shared_secret` string, required — The secret of the client. - `repository` string, required — The Bitbucket repository (in the form `user/repo`). - `build_pull_requests` boolean — Whether or not to build pull requests. - `pull_requests_clone_parent_data` boolean — Whether or not to clone parent data when building merge requests. - `resync_pull_requests` boolean — Whether or not pull request environment data should be re-synced on every build. - BitbucketServerIntegrationPatch - `type` string, required - `fetch_branches` boolean — Whether or not to fetch branches. - `prune_branches` boolean — Whether or not to remove branches that disappeared remotely (requires `fetch_branches`). - `environment_init_resources` 'default' | 'manual' | 'minimum' | 'parent' — The resources used when initializing a new service - `url` string, required — The base URL of the Bitbucket Server installation. - `username` string, required — The Bitbucket Server user. - `token` string, required — The Bitbucket Server personal access token. - `project` string, required — The Bitbucket Server project - `repository` string, required — The Bitbucket Server repository - `build_pull_requests` boolean — Whether or not to build pull requests. - `pull_requests_clone_parent_data` boolean — Whether or not to clone parent data when building merge requests. - BlackfireIntegrationPatch - `type` string, required - FastlyIntegrationPatch - `type` string, required - `events` string[] — Events to execute the hook on - `environments` string[] — The environments to execute the hook on - `excluded_environments` string[] — The environments to not execute the hook on - `states` string[] — Events to execute the hook on - `result` '*' | 'failure' | 'success' — Result to execute the hook on - `token` string, required — Fastly API Token - `service_id` string, required - GithubIntegrationPatch - `type` string, required - `fetch_branches` boolean — Whether or not to fetch branches. - `prune_branches` boolean — Whether or not to remove branches that disappeared remotely (requires `fetch_branches`). - `environment_init_resources` 'default' | 'manual' | 'minimum' | 'parent' — The resources used when initializing a new service - `token` string, required — The GitHub token. - `base_url` string, nullable — The base URL of the Github API endpoint. - `repository` string, required — The GitHub repository (in the form `user/repo`). - `build_pull_requests` boolean — Whether or not to build pull requests. - `build_draft_pull_requests` boolean — Whether or not to build draft pull requests (requires `build_pull_requests`). - `build_pull_requests_post_merge` boolean — Whether to build pull requests post-merge (if true) or pre-merge (if false). - `pull_requests_clone_parent_data` boolean — Whether or not to clone parent data when building pull requests. - GitLabIntegrationPatch - `type` string, required - `fetch_branches` boolean — Whether or not to fetch branches. - `prune_branches` boolean — Whether or not to remove branches that disappeared remotely (requires `fetch_branches`). - `environment_init_resources` 'default' | 'manual' | 'minimum' | 'parent' — The resources used when initializing a new service - `token` string, required — The GitLab private token. - `rotate_token` boolean - `rotate_token_validity_in_weeks` integer - `base_url` string — The base URL of the GitLab installation. - `project` string, required — The GitLab project (in the form `namespace/repo`). - `build_merge_requests` boolean — Whether or not to build merge requests. - `build_wip_merge_requests` boolean — Whether or not to build work in progress merge requests (requires `build_merge_requests`). - `merge_requests_clone_parent_data` boolean — Whether or not to clone parent data when building merge requests. - EmailIntegrationPatch - `type` string, required - `from_address` string, nullable — The email address to use - `recipients` string[], required — Recipients of the email - PagerDutyIntegrationPatch - `type` string, required - `routing_key` string, required — The PagerDuty routing key - SlackIntegrationPatch - `type` string, required - `token` string, required — The Slack token to use - `channel` string, required — The Slack channel to post messages to - HealthWebHookIntegrationPatch - `type` string, required - `shared_key` string, nullable — The JWS shared secret key - `url` string, required — The URL of the webhook - HttpLogIntegrationPatch - `type` string, required - `extra` object — Arbitrary key/value pairs to include with forwarded logs - `url` string, required - `headers` object — HTTP headers to use in POST requests - `tls_verify` boolean — Enable/Disable HTTPS certificate verification - `excluded_services` string[] — Comma separated list of service and application names to exclude from logging - NewRelicIntegrationPatch - `type` string, required - `extra` object — Arbitrary key/value pairs to include with forwarded logs - `url` string, required - `license_key` string, required — The NewRelic Logs License Key - `tls_verify` boolean — Enable/Disable HTTPS certificate verification - `excluded_services` string[] — Comma separated list of service and application names to exclude from logging - HttpLogIntegrationPatch - `type` string, required - `extra` object — Arbitrary key/value pairs to include with forwarded logs - `url` string, required - `headers` object — HTTP headers to use in POST requests - `tls_verify` boolean — Enable/Disable HTTPS certificate verification - `excluded_services` string[] — Comma separated list of service and application names to exclude from logging - ScriptIntegrationPatch - `type` string, required - `events` string[] — Events to execute the hook on - `environments` string[] — The environments to execute the hook on - `excluded_environments` string[] — The environments to not execute the hook on - `states` string[] — Events to execute the hook on - `result` '*' | 'failure' | 'success' — Result to execute the hook on - `script` string, required — The script to run - SplunkIntegrationPatch - `type` string, required - `extra` object — Arbitrary key/value pairs to include with forwarded logs - `url` string, required — The Splunk HTTP Event Connector REST API endpoint - `index` string, required — The Splunk Index - `token` string, required — The Splunk Authorization Token - `sourcetype` string — The event 'sourcetype' - `tls_verify` boolean — Enable/Disable HTTPS certificate verification - `excluded_services` string[] — Comma separated list of service and application names to exclude from logging - SumologicIntegrationPatch - `type` string, required - `extra` object — Arbitrary key/value pairs to include with forwarded logs - `url` string, required - `category` string — The Category used to easy filtering (sent as X-Sumo-Category header) - `tls_verify` boolean — Enable/Disable HTTPS certificate verification - `excluded_services` string[] — Comma separated list of service and application names to exclude from logging - SyslogIntegrationPatch - `type` string, required - `extra` object — Arbitrary key/value pairs to include with forwarded logs - `host` string — Syslog relay/collector host - `port` integer — Syslog relay/collector port - `protocol` 'tcp' | 'tls' | 'udp' — Transport protocol - `facility` integer — Syslog facility - `message_format` 'rfc3164' | 'rfc5424' — Syslog message format - `auth_token` string - `auth_mode` 'prefix' | 'structured_data' - `tls_verify` boolean — Enable/Disable HTTPS certificate verification - `excluded_services` string[] — Comma separated list of service and application names to exclude from logging - WebHookIntegrationPatch - `type` string, required - `events` string[] — Events to execute the hook on - `environments` string[] — The environments to execute the hook on - `excluded_environments` string[] — The environments to not execute the hook on - `states` string[] — Events to execute the hook on - `result` '*' | 'failure' | 'success' — Result to execute the hook on - `shared_key` string, nullable — The JWS shared secret key - `url` string, required — The URL of the webhook ## Response `default` - AcceptedResponse - `status` string, required — The status text of the response - `code` integer, required — The status code of the response --- [API](https://skmtc.net/upsun/apis/upsun-com-rest-api.md) · [All operations](https://skmtc.net/upsun/apis/upsun-com-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/upsun/upsun-com-rest-api/revisions/6cc88fde6435/schema)