aria.publish

Validate a hosted service's draft and publish it as an immutable revision.

Freeze the draft into a servable revision.

Overview

Field	Type	Required	Default	Description
`slug`	string	Yes	—	—
`acknowledge_breaking`	boolean	No	—	Required when the new revision renames or removes a tool: clients cache the catalogue when the connector is added and keep calling the old name.

Field	Type	Required	Default	Description
`service`	json	No	—	—
`revision`	integer	No	—	—
`endpoint`	string	No	—	—
`diff`	json	No	—	—
`breaking`	boolean	No	—	—
`violations`	list	No	—	Why the publish was refused, one entry per problem
`dropped_types`	list	No	—	—
`failure_reason`	string	No	—	—
`failed_at_state`	string	No	—	—
`failed_step`	json	No	—	—
`failed_layer`	integer	No	—	—
`error`	string	No	—	—
`error_type`	string	No	—	—
`failed_at`	string	No	—	—

State	Initial	Terminal	Success	Auto-advance	Description
`pending`	Yes	No	—	`execute`	—
`completed`	No	Yes	Yes	—	—
`failed`	No	Yes	No	—	—

From	Action	To	Description
`pending`	`execute`	`completed`	—
`*` (any state)	`fail`	`failed`	—

Outcome	Type	Description	State Data Keys
`published`	SUCCESS	A new revision is being served	`revision`, `endpoint`
`failed`	FAILURE	The action was refused or failed	`failure_reason`

Code	Message Template
`ARIA_SERVICE_NOT_FOUND`	No such service in this organization
`ARIA_REFUSED`	The action was refused
`ARIA_REFUSED`	The action was refused

bash

POST /api/workflows/start
Content-Type: application/json

{
  "workflow_type": "aria.publish",
  "initial_data": {
    "slug": "value"
  }
}