Edit

PATCH
/workspaces
/:workspace
/integrations
/:hash_id

Edits the integration with the specified ID.

Request

REQUIRED SCOPES

INTEGRATION_MANAGE

URL PARAMETERS

workspacerequiredstring

The workspace name.

hash_idrequiredstring

The hash_id of the integration.

POST PARAMETERS

namerequiredstring

The name of the integration.

identifierstring

Readable ID for integration. It can consist of uppercase and lowercase letters, numbers, and underscores. It must start with a letter.

usernamestring

The username for UPCLOUD, RACKSPACE or DOCKER_HUB integration.

shopstring

The name of the shop for SHOPIFY integration.

tokenstring

The token for integrations: DIGITAL_OCEAN, SHOPIFY, RACKSPACE, CLOUDFLARE, NEW_RELIC, SENTRY, ROLLBAR, DATADOG, HONEYBADGER, VULTR, SENTRY_ENTERPRISE, LOGGLY, FIREBASE, GHOST_INSPECTOR

access_keystring

The access key for integrations DO_SPACES and AMAZON.

secret_keystring

The secret key for integrations DO_SPACES and AMAZON.

app_idstring

The application ID for AZURE_CLOUD integration.

tenant_idstring

The tenant ID for AZURE_CLOUD integration.

passwordstring

The password for AZURE_CLOUD, UPCLOUD and DOCKER_HUB integrations.

api_keystring

The API key from the account for CLOUDFLARE integration. The alternative option to add it besides using the token.

role_assumptionsstring

The list of role assumptions for AMAZON integration.

emailstring

Email for CLOUDFLARE integration. Required if api_key is sent.

permissionspermissions

Define to set permissions for the integration.

all_pipelines_allowedboolean

Defines whether all pipelines are allowed to use the integration.

allowed_pipelinesPipeline[]

Defines an object with the property id for pipelines that can use this integration.

Last modified on Jan 19, 2026

List Delete

Request example


curl -X PATCH "https://api.buddy.works/workspaces/:workspace/integrations/:hash_id" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "Buddy AWS integration",
  "access_key": "AKIAVASPKE3ZWWV7V5BI",
  "secret_key": "Pd7TefPBRjF3CfevJaXdyYMZmiC9V+aSnYLvY+GC",
  "identifier": "my_aws_integration",
  "role_assumptions": [
    {
      "arn": "arn:aws:iam::123457465779:role/TESTS",
      "external_id": "ext_id",
      "duration": 9000
    }
  ],
  "all_pipelines_allowed": false,
  "permissions": {
    "admins": "MANAGE",
    "others": "DENIED",
    "users": [
      {
        "id": 1,
        "access_level": "USE_ONLY"
      }
    ],
    "groups": [
      {
        "id": 1,
        "access_level": "USE_ONLY"
      }
    ]
  },
  "allowed_pipelines": [
    {
      "id": 1
    }
  ]
}'

Response

EXAMPLE RESPONSE
{
  "url": "https://api.buddy.works/workspaces/buddy/integrations/5fff3231277e1449d8eb3e6a",
  "html_url": "https://app.buddy.works/buddy/workspace/integrations",
  "identifier": "my_aws_integration",
  "name": "Buddy AWS integration",
  "type": "AMAZON",
  "scope": "PROJECT",
  "project_name": "company-website",
  "all_pipelines_allowed": false,
  "permissions": {
    "admins": "MANAGE",
    "others": "DENIED",
    "users": [
      {
        "id": 1,
        "access_level": "USE_ONLY"
      }
    ],
    "groups": [
      {
        "id": 1,
        "access_level": "USE_ONLY"
      }
    ]
  },
  "allowed_pipelines": [
    {
      "url": "https://api.buddy.works/workspaces/buddy/projects/company-website/pipelines/1",
      "html_url": "https://app.buddy.works/buddy/company-website/pipelines/pipeline/1",
      "id": 1,
      "identifier": "tests",
      "name": "Tests"
    }
  ]
}