Skip to main content
POST
/
projects
/
{projectIdOrName}
/
integrations
/
{integrationId}
/
revisions
Create a new revision.
curl --request POST \
  --url https://api.withampersand.com/v1/projects/{projectIdOrName}/integrations/{integrationId}/revisions \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "sourceZipUrl": "https://storage.googleapis.com/my-bucket/source-files/integration-v1.2.3.zip",
  "sourceYaml": "<string>"
}
'
This response has no body data.

Documentation Index

Fetch the complete documentation index at: https://docs.withampersand.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
X-Api-Key
string
header
required

Path Parameters

​
projectIdOrName
string
required

The Ampersand project ID or project name.

​
integrationId
string
required

The integration ID.

Query Parameters

​
destructive
boolean

Defaults to false. This flag controls whether to perform destructive actions when deploying integrations, like pausing all read actions for an object that was removed in the latest revision.

Body

application/json

The source of the revision to create. One of sourceZipUrl or sourceYaml is required.

​
sourceZipUrl
string

URL of where a zip of the source files can be downloaded (e.g. Google Cloud Storage URL).

Example:

"https://storage.googleapis.com/my-bucket/source-files/integration-v1.2.3.zip"

​
sourceYaml
string

The source YAML file that defines the revision.

Response