GetConfig / Config

GetConfig by config project — config revisions, config groups, rendered device config and applicable config-maps.

📄️ Get all config revisions for a project

Returns the config revision history for the project, optionally filtered by the query parameters.

📄️ Get a specific config revision by ID

Returns a single config revision identified by its `revisionId`.

📄️ Get the assembled device config (latest active version, or a specific semver when provided; prefers S3 cache)

Get the assembled device config (latest active version, or a specific semver when provided; prefers S3 cache)

📄️ Apply the current DRAFT revision (promotes to ACTIVE)

Promotes the current DRAFT revision to ACTIVE, making it the effective config for the project.

📄️ Create a new DRAFT revision (only when no draft exists)

Opens a new DRAFT revision for editing. Fails if a DRAFT revision already exists.

📄️ Delete the current DRAFT revision

Discards the current DRAFT revision along with its unsaved changes.

📄️ Create or update a config group in the DRAFT revision

Creates a new group or updates an existing one inside the current DRAFT revision. **Sensitive keys**: any key path listed in `sensitiveKeys` will have its value encrypted in Vault; the API returns `***` for those paths instead of the real value. **Preserving secrets**: if you send `***` as the value for a sensitive key (e.g. you are only updating non-sensitive fields), the existing secret is kept — you do not need to re-supply the plaintext. **Apply**: set `apply: true` to immediately promote the DRAFT to a new ACTIVE config version after saving this group; existing groups that were not changed are carried over. Defaults to false.

📄️ Delete a config group from the DRAFT revision

Removes a group from the current DRAFT revision. **Apply**: set `apply: true` to immediately promote the DRAFT to a new ACTIVE config version after deleting this group; existing groups that were not changed are carried over. Defaults to false.

📄️ List all ConfigMap projects that apply to this CONFIG project (via device type or global)

List all ConfigMap projects that apply to this CONFIG project (via device type or global)