config/history

GET/config/history

List up to 200 of the most recent config history rows with publish-time diff metadata. Results are newest first and are not an exhaustive account history. Requires the configuration:read permission.

Request

cURL

curl -X GET "https://provisioning.cloudx.io/api/v1/config/history" \
  -H "Authorization: Bearer $CLOUDX_API_KEY"

Query parameters

Name	Type	Description
`since`	`string`	Only include configuration rows created at or after this time. Supports RFC3339 timestamps or YYYY-MM-DD dates.
`author`	`string`	Filter by creator user ID, email, or name substring.
`include_drafts`	`boolean`	Whether to include configuration drafts. By default, only published versions are returned.
`limit`	`integer<int32>`	Maximum number of the most recent rows to return.

Responses

Config history rows.

{
  "entries": [
    {
      "id": "<string>",
      "account_id": "<string>",
      "kind": "version",
      "version_number": 123,
      "version_label": "<string>",
      "created_at": "<string>",
      "created_by_user_id": "<string>",
      "created_by_name": "<string>",
      "description": "<string>",
      "diff_additions": 123,
      "diff_deletions": 123
    }
  ]
}

200 Config history rows.

Field	Type	Description
`entries`required	`array of object`

400 Invalid request parameters.

Field	Type	Description
`error`required	`string`

401 Unauthorized.

Field	Type	Description
`error`required	`string`

403 Forbidden.

Field	Type	Description
`error`required	`string`

500 Internal server error.

Field	Type	Description
`error`required	`string`