config/publish

POST/config/publish

Publish a draft configuration as the live config. Requires editor access (the configuration:write permission for API keys, or an admin or member workspace role for signed-in callers); viewers are denied. The draft is validated with the same publish-time checks used by the CloudX app before it becomes live.

Request

cURL

curl -X POST "https://provisioning.cloudx.io/api/v1/config/publish" \
  -H "Authorization: Bearer $CLOUDX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"draft_id":"<string>","version_label":"<string>"}'

Body

Field	Type	Description
`draft_id`required	`string`	Draft config row ID to publish as live.
`version_label`	`string`	Optional label for the published config version.

Responses

Published config now serving as live.

{
  "config_id": "<string>",
  "version_number": 123,
  "validation": {
    "valid": true,
    "error_count": 123,
    "warning_count": 123,
    "issues": [
      {
        "code": "<string>",
        "path": "<string>",
        "message": "<string>",
        "severity": "error",
        "line": 123,
        "column": 123,
        "length": 123
      }
    ],
    "yaml": "<string>",
    "source": {
      "type": "<string>",
      "name": "<string>"
    }
  }
}

200 Published config now serving as live.

Field	Type	Description
`config_id`required	`string`	Published config row ID that is now live.
`version_number`required	`integer<int32>`	Account-local published config version number.
`validation`required	`object`

400 Invalid request or blocking config validation failure.

Field	Type	Description
`error`required	`string`

401 Unauthorized.

Field	Type	Description
`error`required	`string`

403 Forbidden.

Field	Type	Description
`error`required	`string`

404 Draft config not found.

Field	Type	Description
`error`required	`string`

500 Internal server error.

Field	Type	Description
`error`required	`string`