Integrations (v1)
Add new integration for given organization.
Required permissions
-
View Organization
-
View Integrations
-
Edit Integrations
The organization ID. The API_KEY
must have admin access to this organization.
4a18d42f-0706-4ad0-b127-24078731fbed
{"id":"9a3e5d90-b782-468a-a042-9a2073736f0b"}
POST /v1/org/{orgId}/integrations HTTP/1.1
Host: api.snyk.io
Content-Type: application/json; charset=utf-8
Accept: */*
Content-Length: 88
{
"type": "acr",
"credentials": {
"username": "text",
"password": "text",
"registryBase": "text"
}
}
{
"id": "9a3e5d90-b782-468a-a042-9a2073736f0b"
}
Required permissions
-
View Organization
-
View Integrations
The organization public ID. The API_KEY
must have admin access to this organization.
4a18d42f-0706-4ad0-b127-24078731fbed
application/json; charset=utf-8
Possible values: {"github":"9a3e5d90-b782-468a-a042-9a2073736f0b","gitlab":"1b3e3d90-c678-347a-n232-6a3453738h1e","bitbucket-cloud":"6jje4c92-e7rn-t59a-f456-8n5675432fe9"}
GET /v1/org/{orgId}/integrations HTTP/1.1
Host: api.snyk.io
Content-Type: application/json; charset=utf-8
Accept: */*
{
"github": "9a3e5d90-b782-468a-a042-9a2073736f0b",
"gitlab": "1b3e3d90-c678-347a-n232-6a3453738h1e",
"bitbucket-cloud": "6jje4c92-e7rn-t59a-f456-8n5675432fe9"
}
Required permissions
View Organization
-View Integrations
The API_KEY
must have admin access to this organization.
4a18d42f-0706-4ad0-b127-24078731fbed
Integration type.
Integration type.
github
application/json; charset=utf-8
Possible values: {"id":"9a3e5d90-b782-468a-a042-9a2073736f0b"}
GET /v1/org/{orgId}/integrations/{type} HTTP/1.1
Host: api.snyk.io
Content-Type: application/json; charset=utf-8
Accept: */*
{
"id": "9a3e5d90-b782-468a-a042-9a2073736f0b"
}
-
Update integration's credentials for given organization. Integration must be not brokered
-
Enable or disable brokered integration for given organization. Credentials required for disabling brokered integration
Examples:
Required permissions
-
View Organization
-
View Integrations
-
Edit Integrations
The organization ID. The API_KEY
must have admin access to this organization.
4a18d42f-0706-4ad0-b127-24078731fbed
The unique identifier for the configured integration. This can be found on the Integration page in the Settings area for all integrations that have been configured.
9a3e5d90-b782-468a-a042-9a2073736f0b
{"type":"github","broker":{"enabled":true}}
{"id":"9a3e5d90-b782-468a-a042-9a2073736f0b","brokerToken":"4a18d42f-0706-4ad0-b127-24078731fbed"}
PUT /v1/org/{orgId}/integrations/{integrationId} HTTP/1.1
Host: api.snyk.io
Content-Type: application/json; charset=utf-8
Accept: */*
Content-Length: 43
{
"type": "github",
"broker": {
"enabled": true
}
}
{
"id": "9a3e5d90-b782-468a-a042-9a2073736f0b",
"brokerToken": "4a18d42f-0706-4ad0-b127-24078731fbed"
}
Required permissions
-
View Organization
-
View Integrations
-
Edit Integrations
The organization ID. The API_KEY
must have admin access to this organization.
4a18d42f-0706-4ad0-b127-24078731fbed
The unique identifier for the configured integration. This can be found on the Integration page in the Settings area for all integrations that have been configured.
9a3e5d90-b782-468a-a042-9a2073736f0b
{"autoDepUpgradeLimit":2,"autoDepUpgradeIgnoredDependencies":[],"autoDepUpgradeEnabled":false,"autoDepUpgradeMinAge":21,"pullRequestTestEnabled":true,"pullRequestFailOnAnyVulns":false,"pullRequestFailOnlyForHighSeverity":true,"pullRequestAssignment":"{\"enabled\":true,\"type\":\"manual\",\"assignees\":[\"username\"]}","autoRemediationPrs":{"backlogPrsEnabled":false,"backlogPrStrategy":"vuln","freshPrsEnabled":true,"usePatchRemediation":false},"manualRemediationPrs":{"useManualPatchRemediation":false},"dockerfileSCMEnabled":true}
{"autoDepUpgradeLimit":2,"autoDepUpgradeIgnoredDependencies":[],"autoDepUpgradeEnabled":false,"autoDepUpgradeMinAge":21,"pullRequestTestEnabled":true,"pullRequestFailOnAnyVulns":false,"pullRequestFailOnlyForHighSeverity":true,"pullRequestAssignment":"{\"enabled\":true,\"type\":\"manual\",\"assignees\":[\"username\"]}","autoRemediationPrs":{"backlogPrsEnabled":false,"backlogPrStrategy":"vuln","freshPrsEnabled":true,"usePatchRemediation":false},"manualRemediationPrs":{"useManualPatchRemediation":false},"dockerfileSCMEnabled":true}
PUT /v1/org/{orgId}/integrations/{integrationId}/settings HTTP/1.1
Host: api.snyk.io
Content-Type: application/json; charset=utf-8
Accept: */*
Content-Length: 534
{
"autoDepUpgradeLimit": 2,
"autoDepUpgradeIgnoredDependencies": [],
"autoDepUpgradeEnabled": false,
"autoDepUpgradeMinAge": 21,
"pullRequestTestEnabled": true,
"pullRequestFailOnAnyVulns": false,
"pullRequestFailOnlyForHighSeverity": true,
"pullRequestAssignment": "{\"enabled\":true,\"type\":\"manual\",\"assignees\":[\"username\"]}",
"autoRemediationPrs": {
"backlogPrsEnabled": false,
"backlogPrStrategy": "vuln",
"freshPrsEnabled": true,
"usePatchRemediation": false
},
"manualRemediationPrs": {
"useManualPatchRemediation": false
},
"dockerfileSCMEnabled": true
}
{
"autoDepUpgradeLimit": 2,
"autoDepUpgradeIgnoredDependencies": [],
"autoDepUpgradeEnabled": false,
"autoDepUpgradeMinAge": 21,
"pullRequestTestEnabled": true,
"pullRequestFailOnAnyVulns": false,
"pullRequestFailOnlyForHighSeverity": true,
"pullRequestAssignment": "{\"enabled\":true,\"type\":\"manual\",\"assignees\":[\"username\"]}",
"autoRemediationPrs": {
"backlogPrsEnabled": false,
"backlogPrStrategy": "vuln",
"freshPrsEnabled": true,
"usePatchRemediation": false
},
"manualRemediationPrs": {
"useManualPatchRemediation": false
},
"dockerfileSCMEnabled": true
}
Required permissions
-
View Organization
-
View Integrations
The organization ID. The API_KEY
must have admin access to this organization.
4a18d42f-0706-4ad0-b127-24078731fbed
The unique identifier for the configured integration. This can be found on the Integration page in the Settings area for all integrations that have been configured.
9a3e5d90-b782-468a-a042-9a2073736f0b
application/json; charset=utf-8
Possible values: GET /v1/org/{orgId}/integrations/{integrationId}/settings HTTP/1.1
Host: api.snyk.io
Content-Type: application/json; charset=utf-8
Accept: */*
{
"autoDepUpgradeLimit": 1,
"autoDepUpgradeIgnoredDependencies": [
"text"
],
"autoDepUpgradeEnabled": true,
"autoDepUpgradeMinAge": 1,
"pullRequestFailOnAnyVulns": true,
"pullRequestFailOnlyForHighSeverity": true,
"pullRequestTestEnabled": true,
"pullRequestAssignment": "text",
"autoRemediationPrs": {
"backlogPrsEnabled": true,
"backlogPrStrategy": null,
"freshPrsEnabled": true,
"usePatchRemediation": true
},
"manualRemediationPrs": {
"usePatchRemediation": true
},
"dockerfileSCMEnabled": true
}
Clone an integration, including all of its settings and credentials from one organization to another organization in the same group. This API supports both brokered and non-brokered integrations.
Use this API for when you want to share a Broker token between several Snyk organizations (integrations).
Required permissions
-
View Organization
-
View Integrations
-
Edit Integrations
Source organization public ID to clone integration settings from. The API_KEY
must have access to this organization.
4a18d42f-0706-4ad0-b127-24078731fbed
Source integration public ID to clone.
4a18d42f-0706-4ad0-b127-24078731fbed
{"destinationOrgPublicId":"9a3e5d90-b782-468a-a042-9a2073736f0b1"}
{"newIntegrationId":"9a3e5d90-b782-468a-a042-9a2073736f0b"}
POST /v1/org/{orgId}/integrations/{integrationId}/clone HTTP/1.1
Host: api.snyk.io
Content-Type: application/json
Accept: */*
Content-Length: 66
{
"destinationOrgPublicId": "9a3e5d90-b782-468a-a042-9a2073736f0b1"
}
{
"newIntegrationId": "9a3e5d90-b782-468a-a042-9a2073736f0b"
}
Required permissions
-
View Organization
-
View Integrations
-
Edit Integrations
Removes any credentials set for this integration. If this is a brokered connection the operation will have no effect.
The organization ID. The API_KEY
must have access to this organization.
4a18d42f-0706-4ad0-b127-24078731fbed
The integration ID.
4a18d42f-0706-4ad0-b127-24078731fbed
application/json
Possible values: DELETE /v1/org/{orgId}/integrations/{integrationId}/authentication HTTP/1.1
Host: api.snyk.io
Content-Type: application/json
Accept: */*
No content
Switch the existing broker token with the provisioned token for this integration and any other in the same group. Only perform this action when you have a Broker client running with the provisioned token. This action will fail if there is no token provisioned for this integration or any integration in the same group.
Required permissions
-
View Organization
-
View Integrations
-
Edit Integrations
The API_KEY
must have access to this organization.
4a18d42f-0706-4ad0-b127-24078731fbed
4a18d42f-0706-4ad0-b127-24078731fbed
application/json
Possible values: POST /v1/org/{orgId}/integrations/{integrationId}/authentication/switch-token HTTP/1.1
Host: api.snyk.io
Content-Type: application/json
Accept: */*
No content
Issue a new and unique provisional broker token for the brokered integration.
Used for zero down-time token rotation with the Snyk Broker. Once provisioned, the token can be used to initialize a new broker client before using the switch API to update the token in use by the integration.
The new provisional token will fail to be created if the integration, or any other integration in the same group, already has one provisioned.
Required permissions
-
View Organization
-
View Integrations
-
Edit Integrations
The API_KEY
must have access to this organization.
4a18d42f-0706-4ad0-b127-24078731fbed
4a18d42f-0706-4ad0-b127-24078731fbed
application/json
Possible values: {"id":"9a3e5d90-b782-468a-a042-9a2073736f0b","provisionalBrokerToken":"4a18d42f-0706-4ad0-b127-24078731fbed"}
POST /v1/org/{orgId}/integrations/{integrationId}/authentication/provision-token HTTP/1.1
Host: api.snyk.io
Content-Type: application/json
Accept: */*
{
"id": "9a3e5d90-b782-468a-a042-9a2073736f0b",
"provisionalBrokerToken": "4a18d42f-0706-4ad0-b127-24078731fbed"
}
Last updated
Was this helpful?