Create
Creates an integration of the selected type.
Supported integration types: DIGITAL_OCEAN, AMAZON, SHOPIFY, PUSHOVER, RACKSPACE, CLOUDFLARE, NEW_RELIC, SENTRY, ROLLBAR, DATADOG, DO_SPACES, HONEYBADGER, VULTR, SENTRY_ENTERPRISE, LOGGLY, FIREBASE, UPCLOUD, GHOST_INSPECTOR, AZURE_CLOUD, DOCKER_HUB, GIT_HUB, GOOGLE_SERVICE_ACCOUNT.
Required scopes: INTEGRATION_ADD
Resource URL
POST /workspaces/:domain/integrationsURL Parameters
| Name | Type | Description |
|---|---|---|
domain Required | String | The workspace domain. |
POST Parameters
| Name | Type | Description |
|---|---|---|
name Required | String | The name of the integration. |
type Required | String | The type of the integration (listed above). |
scope Required | String | The scope of the integration. Can be one of: PRIVATE, PRIVATE_IN_PROJECT WORKSPACE, ADMIN, GROUP, PROJECT, ADMIN_IN_PROJECT or GROUP_IN_PROJECT. |
| project_name | String | The name of the project. Required if scope is set to PROJECT, PRIVATE_IN_PROJECT, ADMIN_IN_PROJECT or GROUP_IN_PROJECT. |
| group_id | Integer | The ID of the group. Required if scope is set to GROUP or GROUP_IN_PROJECT. |
| username | String | The username for UPCLOUD, RACKSPACE or DOCKER_HUB integration. |
| shop | String | The name of the shop for SHOPIFY integration. |
| token | String | The token for integrations: DIGITAL_OCEAN, SHOPIFY, RACKSPACE, CLOUDFLARE, NEW_RELIC, SENTRY, ROLLBAR, DATADOG, HONEYBADGER, VULTR, SENTRY_ENTERPRISE, LOGGLY, FIREBASE, GHOST_INSPECTOR, GIT_HUB. |
| access_key | String | The access key for integrations DO_SPACES and AMAZON. |
| secret_key | String | The secret key for integrations DO_SPACES and AMAZON. |
| app_id | String | The application ID for AZURE_CLOUD integration. |
| tenant_id | String | The tenant ID for AZURE_CLOUD integration. |
| password | String | The password for AZURE_CLOUD, UPCLOUD or DOCKER_HUB integrations. |
| api_key | String | The API key from the account for CLOUDFLARE integration. The alternative option to add it besides using the token. |
| role_assumptions | String | The list of role assumptions for AMAZON integration. |
| String | Email for CLOUDFLARE integration. Required if api_key is sent. | |
| partner_token | String | The partner token for SHOPIFY integration. |
| key_id | String | The access key for BACKBLAZE integration. |
| application_key | String | The secret key for BACKBLAZE integration. |
Role assumptions
| Name | Type | Description |
|---|---|---|
arn Required | String | The role arn for assumption. |
external_id Required | String | The external ID for the role. |
| duration | Integer | Maximum session duration setting for the role. Can have values between 900 and 43200. |
Example
Request
POST https://api.buddy.works/workspaces/buddy/integrationsJSON
{
"name":"Buddy AWS integration",
"type":"AMAZON",
"scope":"PROJECT",
"project_name": "theproject",
"access_key":"AKIAVASPKE3ZWWV7V5BI",
"secret_key":"Pd7TefPBRjF3CfevJaXdyYMZmiC9V+aSnYLvY+GC",
"role_assumptions":[
{
"arn":"arn:aws:iam::123457465779:role/TESTS",
"external_id":"ext_id",
"duration":9000
}
]
}Sample Response
{
"url": "https://api.buddy.works/workspaces/buddy/integrations/5fff3231277e1449d8eb3e6a",
"html_url": "https://app.buddy.works/buddy/workspace/integrations",
"hash_id": "5fff3231277e1449d8eb3e6a",
"name": "Buddy AWS integration",
"type": "AMAZON",
"scope": "PROJECT",
"project_name": "theproject"
}Last modified on May 26, 2023