Deployment Integrations

Update a deployment integration

Updates API token or other settings for a deployment integration. A changed Fastly API token is saved before redeployment; if deployment fails, the token remains saved for worker retries while other settings remain unchanged. A concurrent configuration change rejects the token update with 409; reload and retry.

post/v2/organization/{organization}/deployment-integration/{integration}

Request

Base URL: https://api.zephyr-cloud.io
URL: https://api.zephyr-cloud.io/v2/organization/{organization}/deployment-integration/{integration}
Auth: HTTP bearer

Path parameters

organizationstring required

Organization slug

Example:zephyr-cloud

integrationstring required

Integration name

Example:cloudflare-prod

Request body

displayNamestring

New display name

isDefaultboolean

Set as default integration (will unset other defaults)

Example request

{
  "integrationConfig": {
    "workerName": "ze-worker-for-static-upload",
    "kvEnvsNamespaceName": "ze_envs",
    "kvSnapshotsNamespaceName": "ze_envs",
    "kvFilesNamespaceName": "ze_envs"
  }
}

Response

Integration updated successfully

Example response

{
  "value": {
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "name": "cloudflare-prod",
    "enabled": true,
    "workerVersion": "0.1.2",
    "integrationConfig": {
      "workerName": "ze-worker-for-static-upload",
      "kvEnvsNamespaceName": "ze_envs",
      "kvSnapshotsNamespaceName": "ze_envs",
      "kvFilesNamespaceName": "ze_envs"
    },
    "deploymentConfig": {
      "kvEnvsNamespaceName": "ze_envs",
      "kvSnapshotsNamespaceName": "ze_envs",
      "kvFilesNamespaceName": "ze_envs"
    },
    "organizationId": "550e8400-e29b-41d4-a716-446655440000"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.