v1
API
CLI
JS Client

Project / External Addons /

Update external addon

Updates configuration for an external addon

Required permission

Project > ExternalAddons > General > Update

Path parameters

    • projectId

      string required
      ID of the project
    • externalAddonId

      string required
      ID of the external addon

Request body

  • {object}
    Request body for updating an external addon
    • description

      string
      max length
      200
      pattern
      ^[a-zA-Z0-9.,?\s\\/'"()[\];`%^&*\-_:!]+$
    • tags

      [array]
      An array of previously defined tags to help identify and group the resource.
      • string
        min length
        3
        max length
        100
        pattern
        ^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*$
    • environmentId

      string
    • spec

      {object}

Response body

  • {object}
    Response object.
    • data

      {object} required
      Result data.
      • description

        string
        max length
        200
        pattern
        ^[a-zA-Z0-9.,?\s\\/'"()[\];`%^&*\-_:!]+$
      • tags

        [array]
        An array of previously defined tags to help identify and group the resource.
        • string
          min length
          3
          max length
          100
          pattern
          ^[a-zA-Z0-9]+(-[a-zA-Z0-9]+)*$
      • environmentId

        string
      • spec

        {object}
      • name

        string required
        min length
        3
        max length
        100
        pattern
        ^[a-zA-Z0-9]+((-|\s)[a-zA-Z0-9]+)*$
API
CLI
JS Client

PATCH /v1/projects/{projectId}/external-addons/{externalAddonId}

PATCH /v1/teams/{teamId}/projects/{projectId}/external-addons/{externalAddonId}

Example request

Request body
curl --header "Content-Type: application/json" \
  --header "Authorization: Bearer NORTHFLANK_API_TOKEN" \
  --request PATCH \
  --data '{"spec":{"provider":{"aws":{"region":"eu-west-1"},"google":{"region":"us-central1","zone":"us-central1-c"}}}}' \
  https://api.northflank.com/v1/projects/{projectId}/external-addons/{externalAddonId}

Example response

200 OK

Details about the updated external addon.

JSON

{
  "data": {
    "spec": {
      "provider": {
        "aws": {
          "region": "eu-west-1"
        },
        "google": {
          "region": "us-central1",
          "zone": "us-central1-c"
        }
      }
    }
  }
}

© 2026 Northflank Ltd. All rights reserved.