v21

latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-0483151153.1 KB

Rotate a federation enrollment

Transactionally revokes active project-scoped grants for the spoke and installs the caller-supplied replacement token. After canonical capability normalization and token-authenticated actor resolution, an exact replay with the same replacement token, spoke instance, project, canonical capabilities, resolved actor, and adoption policy returns the same active enrollment. An attribute mismatch or revoked replacement enrollment returns 409 with code federation_enrollment_token_conflict.

post/api/v1/federation/enrollments/actions/rotate

Request body

actorstring
allow_adoption_snapshot_authorsboolean
capabilitiesstring required
project_idinteger required
spoke_instance_uidstring required
tokenstring required

Response

OK

actorstring required
capabilitiesstring required
created_atstring date-time required
idinteger required
project_idinteger nullable required
revoked_atstring date-time
spoke_instance_uidstring required
tokenstring
updated_atstring date-time required