Platform & admin
Admin
Explore the data types and operations available in Admin.
167 operations
Append a plain text comment to a proposed or applied Change Request. Retry the same id and body after a lost response.
iacAdvisoryPlanQueryNon-executable advisory plan; persists no source, approval, lease or execution state.
iacAdvisorySnapshotQueryRead-only coordinator capability; ordinary clients cannot invoke it.
iacApplyChangeMutationAtomically Apply the reviewed plan as the actual user, publishing main only on success. The stack's rules must be met (REVIEW_REQUIRED, CHANGES_REQUESTED) unless a stack admin bypasses them.
iacApplyStatusQueryReconcile a lost Apply response. Only the planning principal may inspect the result.
iacCancelChangeMutationClose a draft Change Request without applying it. Allowed for its author and for anyone who may apply the stack; the conversation stays readable.
iacChangeTimelineQueryRead up to 100 comments and events, oldest first, with an exclusive cursor. Includes comment capability, never apply authority.
iacConfigureStackMutationConfigure stack ownership and archival under stack administration permissions.
iacCreateStackMutationCreate a hosted Git stack.
iacDeclaredVariablesQueryList the variables a commit's source declares, in declaration order, for checking that a stack holds a value for each before promoting that commit. Requires stack read access.
iacDeleteStackSecretMutationMark a stack secret deleted by writing a deleted version; earlier versions are kept for audit. True when the secret was deleted. Requires stack administration.
iacDismissReviewMutationWithdraw your own review, or, as a stack admin, dismiss someone else's with a reason. Recorded in the timeline.
iacEditingPresenceSubscriptionObserve current collaborators and stack revision changes while editing a stack.
iacGitChangeQueryRead one draft Change Request in its owning stack.
iacGitChangeReviewQueryRead a safe projection of the original stored plan. No private inputs, approvals or execution authority are returned.
iacGitChangeReviewsQueryRead bounded plan highlights for at most 100 stack-local Change Requests.
iacGitChangesQueryList up to 100 Change Requests, newest first, optionally filtered by branch, status or author. Requires stack read access.
iacGitCreateChangeMutationCapture an immutable draft Change Request; no client-supplied plan is trusted or applied.
iacGitDeleteWorkingRefMutationImmediately delete a working branch with expected-head protection.
iacGitRenameChangeMutationRename a draft proposal without altering source, state, or approval. Requires stack authoring access.
iacGitRepositoryQueryDiscover the authenticated Git remote for an authorized stack.
iacGitReviseChangeMutationCapture the Change Request branch's pushed head as its next revision, keeping the conversation. Returns the Change Request unchanged when the branch has no new commits.
iacGitSnapshotQueryRead a bounded source snapshot after tenant, IAM and stack-grant authorization.
iacGitStageMutationStage immutable objects without changing branch refs or deployed configuration.
iacGitUpdateChangeDescriptionMutationReplace a draft Change Request's description. Only its author may do this.
iacGitUpdateWorkingRefMutationCompare and update a working branch; never publishes main or applies configuration.
iacGrantStackMutationManage stack grants; grants never bypass resource permissions.
iacGuidesQueryEvery authoring guide, for a tool that syncs them to a folder. Intended for `schema pull` to call once and write to disk, not for an agent to call while authoring — a file can be grepped and re-read in part, where a response arrives whole.
iacHostedStateMutationCoordinator-only state capability; unavailable to ordinary clients.
iacImportStackValuesMutationSeed a stack's non-sensitive values once, when it has none (otherwise VALUES_EXIST); every later change is a reviewed values change. Requires stack administration.
iacLeaveEditingMutationEnd an authoring presence session.
iacMigrateStackMutationAtomically create an absent stack and import legacy state. Requires tenant administration; exact retries are idempotent.
iacModulePackagesQueryRead immutable public GitHub package bytes for editor intelligence; validates lock integrity and creates no executable identity.
iacPlanChangeMutationProduce a trusted server plan without applying resources.
iacPrepareChangeMutationPrivately prepare an exact plan without publishing source or creating a change. Expires after 30 minutes; only its creator may publish it.
iacProposeValuesChangeMutationPropose new stack values as a values change: a Change Request on refs/cococo/values that plans main's source with the proposed values and is reviewed, gated and applied like any change. One open values change per stack (CHANGE_EXISTS). Secrets are refused with VALUE_SENSITIVITY_MISMATCH.
iacPublishPreparedChangeMutationPublish a confirmed preparation as a change request and reviewed plan. Repeating publication returns the same change; stack review rules still gate apply.
iacPurgeStackSecretMutationIrreversibly destroy stored secret values, for example after a leak. Metadata stays; plans that used a purged version must be re-planned. Requires stack administration.
iacReviewChangeMutationGive a verdict on the current revision; it replaces your earlier verdict on that revision. The Change Request's author and anyone who captured a revision cannot approve (SELF_APPROVAL). Requires stack write access.
iacSchemaQueryThe infrastructure-only view of this schema, for declarative tooling. Contains only annotated resources and the types they reach.
iacSchemaDocumentQueryFetch the JSON Schema document a SCHEMA-kind validator references, for declarative tooling.
iacSetStackSecretMutationWrite a new version of a stack secret; earlier versions are kept. Plans made before it need re-planning. Requires stack administration.
iacStackHistoryQueryList a stack's applied revisions, newest first, each linked to the Change Request that produced it. Requires stack read access.
iacStackOverviewQuerySummarise a stack: revision, owner, last apply, resource kinds and pending changes. Requires stack read access.
iacStackPermissionsQueryRead what the viewer may do on a stack, and who may apply its changes.
iacStackReadmeQueryRead README.md at the root of the stack's main branch as UTF-8 text; null without main or without a root README. Refused with README_TOO_LARGE above 256 KiB. Requires stack read access.
iacStackResourcesQueryList deployed resources and those only open Change Requests would create, with the last and pending Change Requests for each. Requires stack read access.
iacStackRulesQueryRead a stack's rules; a stack that never set any reads the defaults. Requires stack read access.
iacStacksQueryList stacks visible to this user, up to 100 per page.
iacStackSecretsQueryList a stack's secrets by name with their version history, never their values. Requires stack read access.