Skip to main content

Deploy a new automation

POST /api/deploy
Creates a new automation from an uploaded artifact. No sandbox test required (but recommended). Body:
{
  "artifactId": "art_abc123",
  "changeNote": "Initial deploy"
}
FieldRequiredDescription
artifactIdYesID from POST /api/artifacts
changeNoteNoVersion note for history
Response:
{
  "id": "auto_xyz789",
  "url": "https://dashboard.floom.dev/a/auto_xyz789"
}
The url is a shareable link to the automation’s web UI.

Update an existing automation

POST /api/automations/:id/update
Deploys a new version of an existing automation. The URL stays the same; the code changes. Body:
{
  "artifactId": "art_def456",
  "changeNote": "Added error handling"
}
FieldRequiredDescription
artifactIdYesNew artifact ID
changeNoteNoWhat changed

Rollback

POST /api/automations/:id/rollback
Reverts an automation to a previous version. Body:
{
  "versionId": "ver_abc123"
}