Control Plane API: schemas

The request and response bodies of the operations in this API.

ResourceChangeDto

PropertyTypeRequiredDescription
actionobjectyes
driftFromActualbooleanno
kindobjectyes
logicalIdstringyes
physicalIdstringno

ResourceDto

PropertyTypeRequiredDescription
kindstring (24 values)yes
managedKeystring or nullyesThe owning service's natural key for the resource; null when it has none.
physicalIdstringyesService-native physical id.
specobjectnoThe live read-back spec (present on get/list).
statusobjectnoObserved, read-only state the owning service reports beside the spec (for example a revision). Never part of a declaration and never compared for drift; absent for a kind that reports none.

ResourceDtoDataArrayEnvelope

PropertyTypeRequiredDescription
dataarray of ResourceDtoyes

ResourceDtoDataEnvelope

PropertyTypeRequiredDescription
dataResourceDtoyes

ResourceHandleDto

PropertyTypeRequiredDescription
kindstring (24 values)yes
managedKeystring or nullyesThe created resource's natural key; null when it has none (a project created without a managedKey).
physicalIdstringyes

ResourceHandleDtoDataEnvelope

PropertyTypeRequiredDescription
dataResourceHandleDtoyes

ResourcePlanDto

PropertyTypeRequiredDescription
changesarray of ResourceChangeDtoyes
driftDetectedbooleanyes
stackNamestringyes

ResourcePlanDtoDataEnvelope

PropertyTypeRequiredDescription
dataResourcePlanDtoyes

ResourceSpecDto

PropertyTypeRequiredDescription
specobjectyesKind-native resource spec, forwarded verbatim to the owning service.

StackApplyResultDto

PropertyTypeRequiredDescription
creatednumberyes
retirednumberyes
stackNamestringyes
unchangednumberyes
updatednumberyes

StackApplyResultDtoDataEnvelope

PropertyTypeRequiredDescription
dataStackApplyResultDtoyes

StackExportDto

PropertyTypeRequiredDescription
manifestobjectyes

StackExportDtoDataEnvelope

PropertyTypeRequiredDescription
dataStackExportDtoyes

StackManifestDto

PropertyTypeRequiredDescription
manifestobjectyesA xema/v1 manifest (XemaManifest). Re-validated on receipt.

StackSummaryDto

PropertyTypeRequiredDescription
createdAtstring (date-time)yes
namestringyesStack name, unique within the org.
resourceCountnumberyesPersisted managed-resource mappings. Not a live drift check.
schemaVersionnumberyesResource-contract schema version the mappings were written against.
updatedAtstring (date-time)yes

StackSummaryDtoDataArrayEnvelope

PropertyTypeRequiredDescription
dataarray of StackSummaryDtoyes