{"name":"flag","stage":"ga","description":"Package flags is feature flags: ship it dark, then turn it on for who you pick.","operations":[{"operationId":"post_flag","method":"POST","href":"/v1/flag","summary":"Runs the caller's flag definitions for one identity and returns the flag verdict: which flags are on (or which variant), their payloads, and whether any definition failed to compute."},{"operationId":"get_flag_activity","method":"GET","href":"/v1/flag/activity","summary":"Returns the caller's flag change log newest-first: every create, update and delete, with the actor and the time."},{"operationId":"post_flag_decide","method":"POST","href":"/v1/flag/decide","summary":"Runs the caller's flag definitions for one identity and returns the flag verdict: which flags are on (or which variant), their payloads, and whether any definition failed to compute."},{"operationId":"get_flag_defs","method":"GET","href":"/v1/flag/defs","summary":"Returns every flag definition in the caller's (org, project) store, by key, with its version and who last changed it."},{"operationId":"delete_flag_defs_by_key","method":"DELETE","href":"/v1/flag/defs/{key}","summary":"Removes one flag definition by key and records the deletion in the change log."},{"operationId":"get_flag_defs_by_key","method":"GET","href":"/v1/flag/defs/{key}","summary":"Returns one flag definition by key, or 404 when the caller's store has none under that key."},{"operationId":"put_flag_defs_by_key","method":"PUT","href":"/v1/flag/defs/{key}","summary":"Creates or replaces the flag definition at the path's key and returns the stored row."},{"operationId":"get_flag_health","method":"GET","href":"/v1/flag/health","summary":"Reports that the flag engine is serving."},{"operationId":"get_flag_optin","method":"GET","href":"/v1/flag/optin","summary":"Answers the signed-in caller's opt-in to public betas: whether they opted in, whether the org they act in blocked it, and which betas are public."},{"operationId":"put_flag_optin","method":"PUT","href":"/v1/flag/optin","summary":"Sets the signed-in caller's OWN opt-in to public betas: on, every public beta and each one promoted later is on for them; off, none is."},{"operationId":"put_flag_optin_org","method":"PUT","href":"/v1/flag/optin/org","summary":"Blocks or unblocks the opt-in to public betas for every member of the org the caller acts in."},{"operationId":"get_flag_platform","method":"GET","href":"/v1/flag/platform","summary":"Answers the platform switches that are decided per caller — `beta`, whether the caller sees what is not yet generally available — as they apply to the signed-in caller: its validated org and user, never anything the request states."}],"_links":{"describedby":{"href":"/v1/openapi.json?capability=flag"},"self":{"href":"/v1/flag"},"up":{"href":"/v1"}}}