Skip to main content

Idempotently associate an existing application to a group

PUT 

/public/v1/groups/:group_id/applications/:application_identifier

Associates an existing application with a group. The operation is idempotent: if the application is already associated with the group, no duplicate association is created. Distribution to devices is dispatched separately; check the dispatch_status field for the processing outcome. Pass optional version_id to select an active package version belonging to this application for this group. This creates or replaces the group-specific version (Rails test/homologation distribution), without changing the current version or other groups. A matching contingency version is cleared, as in Rails. Omitting version_id preserves any existing group-specific version. Enterprise apps do not support version selection. A new association or changed version returns 202; repeating the same selection returns 200. Acceptance does not confirm installation on devices.

Request​

Responses​

The association was already active; no row was duplicated. Dispatch is reconciled and deduplicated during the configured TTL, and may be re-enqueued after that period.