Skip to main content
POST
/
headless
/
editInstallation
Edit Installation
curl --request POST \
  --url https://production.runalloy.com/headless/editInstallation \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --header 'x-api-version: <x-api-version>' \
  --data '{
  "userId": "string",
  "integrationId": "string",
  "credentialIds": [
    "<string>"
  ],
  "installationId": "<string>"
}'
{
  "data": {
    "installationId": "674570d5160c297be4a3ee74",
    "integrationId": "66fa99433793749b64c1bf82",
    "userId": "659d28e18c35f07db18fcd8c",
    "formData": [
      "<any>"
    ],
    "credentialIds": {
      "klaviyoApi": "66c79e5965ede8edfa909553"
    },
    "workflowIds": [
      "66fa99453793749b64c1bfa8"
    ],
    "installedData": [
      "<any>"
    ],
    "installedAt": "2024-11-26T06:55:33Z"
  }
}

Headers

​
Authorization
string
default:bearer YOUR_API_KEY
required
​
x-api-version
string
default:2025-09
required

The version of the API to use. The current API version is 2025-09.

Body

application/json
​
userId
string
required

The id of the user to generate this link for.

Example:

"string"

​
integrationId
string
required

The integration you want to install.

Example:

"string"

​
credentialIds
string[]

List of credentials to be used in this installation. If the user has authorized any of the apps in the integration more than once, then this field is required. Otherwise, the user's credentials will be automatically detected.

​
installationId
string

ID you received when you started the installation.

Response

200 - application/json

Successful response

​
data
object
⌘I