generated: '2026-09-05' method: derived source: openapi/cloudbees-unify-openapi.yml, openapi/cloudbees-unify-beta-openapi.yml note: Derived mechanically from components.schemas $ref links and id-reference field names in the two harvested CloudBees Unify specifications. The schema names carry their protobuf package prefixes (api.flag.*, api.auth.*, api.TargetGroup.*, unify.v4.*), which is itself the clearest statement of the domain split inside the platform. domains: - name: Feature management prefixes: - api.flag - api.TargetGroup - api.CustomProperty - api.fmimpressions root: Application (addressed as applicationId on every flag path) note: The richest part of the contract by far — flags, per-environment configurations, target groups, custom properties and impression rollups. - name: Identity and org prefixes: - api.auth root: Organization note: Organizations nest (parent/child) and own teams, users, invites, roles and connections. - name: Components and services prefixes: - api.service - unify.v4 root: Component note: A component is a source repository; in v4 it owns runs and everything attached to a run. - name: Reporting prefixes: - api.vsm.report root: Environment - name: Protobuf scaffolding prefixes: - google. root: null note: google.rpc.Status, google.protobuf.Any/Value/ListValue — the gRPC-gateway error and dynamic-value types, not domain entities. id_prefixes: observed: false note: CloudBees does not publish typed/prefixed object identifiers (no cus_/flag_ style prefixes). Ids are opaque strings and the only way to know what an id refers to is the path it appeared on. entity_count: 109 core_entity_count: 105 entities: - name: api.Audit source: openapi/cloudbees-unify-openapi.yml fields: 3 - name: api.CustomProperty.AddCustomPropertyResponse source: openapi/cloudbees-unify-openapi.yml fields: 1 - name: api.CustomProperty.CustomProperty source: openapi/cloudbees-unify-openapi.yml fields: 6 - name: api.CustomProperty.GetCustomPropertyFlagsUsagePerEnvironmentResponse source: openapi/cloudbees-unify-openapi.yml fields: 1 - name: api.CustomProperty.GetCustomPropertyResponse source: openapi/cloudbees-unify-openapi.yml fields: 1 - name: api.CustomProperty.GetCustomPropertyTargetGroupUsageResponse source: openapi/cloudbees-unify-openapi.yml fields: 1 - name: api.CustomProperty.ListCustomPropertiesResponse source: openapi/cloudbees-unify-openapi.yml fields: 1 - name: api.CustomProperty.UpdateCustomPropertyResponse source: openapi/cloudbees-unify-openapi.yml fields: 1 - name: api.Pagination source: openapi/cloudbees-unify-openapi.yml fields: 4 - name: api.Sort source: openapi/cloudbees-unify-openapi.yml fields: 2 - name: api.TargetGroup.AddTargetGroupResponse source: openapi/cloudbees-unify-openapi.yml fields: 1 - name: api.TargetGroup.EnvironmentUsage source: openapi/cloudbees-unify-openapi.yml fields: 2 - name: api.TargetGroup.FlagIdName source: openapi/cloudbees-unify-openapi.yml fields: 3 - name: api.TargetGroup.FlagUsageInEnvironment source: openapi/cloudbees-unify-openapi.yml fields: 4 - name: api.TargetGroup.GetTargetGroupFlagsUsagePerEnvironmentResponse source: openapi/cloudbees-unify-openapi.yml fields: 1 - name: api.TargetGroup.GetTargetGroupResponse source: openapi/cloudbees-unify-openapi.yml fields: 1 - name: api.TargetGroup.ListTargetGroupsResponse source: openapi/cloudbees-unify-openapi.yml fields: 1 - name: api.TargetGroup.ListTargetGroupsWithFlagsUsageResponse source: openapi/cloudbees-unify-openapi.yml fields: 1 - name: api.TargetGroup.TargetGroup source: openapi/cloudbees-unify-openapi.yml fields: 6 - name: api.TargetGroup.TargetGroupUsage source: openapi/cloudbees-unify-openapi.yml fields: 3 - name: api.TargetGroup.TargetGroupWithFlagsUsage source: openapi/cloudbees-unify-openapi.yml fields: 6 - name: api.TargetGroup.UpdateTargetGroupResponse source: openapi/cloudbees-unify-openapi.yml fields: 1 - name: api.auth.Connection source: openapi/cloudbees-unify-openapi.yml fields: 13 - name: api.auth.CreateInvitesRequestV3 source: openapi/cloudbees-unify-openapi.yml fields: 6 - name: api.auth.CreateInvitesV3Response source: openapi/cloudbees-unify-openapi.yml fields: 1 - name: api.auth.EmailDomain source: openapi/cloudbees-unify-openapi.yml fields: 6 - name: api.auth.GetOrganizationByNameResponse source: openapi/cloudbees-unify-openapi.yml fields: 1 - name: api.auth.GetOrganizationsResponse source: openapi/cloudbees-unify-openapi.yml fields: 2 - name: api.auth.GetTeamsResponse source: openapi/cloudbees-unify-openapi.yml fields: 2 - name: api.auth.Invite source: openapi/cloudbees-unify-openapi.yml fields: 9 - name: api.auth.InviteV3 source: openapi/cloudbees-unify-openapi.yml fields: 8 - name: api.auth.Login source: openapi/cloudbees-unify-openapi.yml fields: 8 - name: api.auth.Org source: openapi/cloudbees-unify-openapi.yml fields: 15 - name: api.auth.Organization source: openapi/cloudbees-unify-openapi.yml fields: 16 - name: api.auth.Role source: openapi/cloudbees-unify-openapi.yml fields: 8 - name: api.auth.Team source: openapi/cloudbees-unify-openapi.yml fields: 16 - name: api.auth.User source: openapi/cloudbees-unify-openapi.yml fields: 17 - name: api.auth.permission.Permission source: openapi/cloudbees-unify-openapi.yml fields: 2 - name: api.flag.AddFlagResponse source: openapi/cloudbees-unify-openapi.yml fields: 1 - name: api.flag.Flag source: openapi/cloudbees-unify-openapi.yml fields: 12 - name: api.flag.FlagConfigState source: openapi/cloudbees-unify-openapi.yml fields: 1 - name: api.flag.FlagConfiguration source: openapi/cloudbees-unify-openapi.yml fields: 10 - name: api.flag.FlagConfigurationEnvironment source: openapi/cloudbees-unify-openapi.yml fields: 7 - name: api.flag.FlagConfigurationOptional source: openapi/cloudbees-unify-openapi.yml fields: 5 - name: api.flag.FlagConfigurationState source: openapi/cloudbees-unify-openapi.yml fields: 3 - name: api.flag.GetFlagConfigurationResponse source: openapi/cloudbees-unify-openapi.yml fields: 1 - name: api.flag.GetFlagConfigurationStateResponse source: openapi/cloudbees-unify-openapi.yml fields: 1 - name: api.flag.GetFlagFlagsUsagePerEnvironmentResponse source: openapi/cloudbees-unify-openapi.yml fields: 1 - name: api.flag.GetFlagResponse source: openapi/cloudbees-unify-openapi.yml fields: 1 - name: api.flag.ListFlagConfigurationsResponse source: openapi/cloudbees-unify-openapi.yml fields: 1 - name: api.flag.ListFlagsResponse source: openapi/cloudbees-unify-openapi.yml fields: 1 - name: api.flag.ListLabelsResponse source: openapi/cloudbees-unify-openapi.yml fields: 1 - name: api.flag.UpdateFlagResponse source: openapi/cloudbees-unify-openapi.yml fields: 1 - name: api.fmimpressions.AllFlagImpressions source: openapi/cloudbees-unify-openapi.yml fields: 1 - name: api.fmimpressions.FlagImpression source: openapi/cloudbees-unify-openapi.yml fields: 2 - name: api.fmimpressions.FlagStatus source: openapi/cloudbees-unify-openapi.yml fields: 2 - name: api.fmimpressions.GetFlagsStatusResponse source: openapi/cloudbees-unify-openapi.yml fields: 1 - name: api.fmimpressions.GetImpressionsResponse source: openapi/cloudbees-unify-openapi.yml fields: 1 - name: api.fmimpressions.ImpressionParams source: openapi/cloudbees-unify-openapi.yml fields: 4 - name: api.fmimpressions.SdkKeyImpressions source: openapi/cloudbees-unify-openapi.yml fields: 1 - name: api.fmimpressions.ValuesAndCounters source: openapi/cloudbees-unify-openapi.yml fields: 2 - name: api.service.ListServicesResponse source: openapi/cloudbees-unify-openapi.yml fields: 1 - name: api.service.Service source: openapi/cloudbees-unify-openapi.yml fields: 14 - name: api.v4.ArtifactInfo source: openapi/cloudbees-unify-beta-openapi.yml fields: 14 - name: api.v4.ArtifactSummary source: openapi/cloudbees-unify-beta-openapi.yml fields: 11 - name: api.v4.CommitSummary source: openapi/cloudbees-unify-beta-openapi.yml fields: 5 - name: api.v4.Component source: openapi/cloudbees-unify-beta-openapi.yml fields: 11 - name: api.v4.CreateArtifactsBody source: openapi/cloudbees-unify-beta-openapi.yml fields: 1 - name: api.v4.CreateArtifactsResponse source: openapi/cloudbees-unify-beta-openapi.yml fields: 1 - name: api.v4.CreateDeploymentArtifactsBody source: openapi/cloudbees-unify-beta-openapi.yml fields: 2 - name: api.v4.CreateDeploymentArtifactsResponse source: openapi/cloudbees-unify-beta-openapi.yml fields: 1 - name: api.v4.CreateEvidencesBody source: openapi/cloudbees-unify-beta-openapi.yml fields: 1 - name: api.v4.CreateEvidencesResponse source: openapi/cloudbees-unify-beta-openapi.yml fields: 0 - name: api.v4.CreateRunResponse source: openapi/cloudbees-unify-beta-openapi.yml fields: 2 - name: api.v4.CreateSecurityResultsBodyForCreate source: openapi/cloudbees-unify-beta-openapi.yml fields: 1 - name: api.v4.CreateSecurityResultsResponse source: openapi/cloudbees-unify-beta-openapi.yml fields: 0 - name: api.v4.CreateTeamMembershipRequest source: openapi/cloudbees-unify-beta-openapi.yml fields: 2 - name: api.v4.CreateTestResultsResponse source: openapi/cloudbees-unify-beta-openapi.yml fields: 0 - name: api.v4.CreatedArtifact source: openapi/cloudbees-unify-beta-openapi.yml fields: 5 - name: api.v4.DeleteComponentResponse source: openapi/cloudbees-unify-beta-openapi.yml fields: 2 - name: api.v4.DeleteTeamMembershipResponse source: openapi/cloudbees-unify-beta-openapi.yml fields: 2 - name: api.v4.DeploymentSummary source: openapi/cloudbees-unify-beta-openapi.yml fields: 4 - name: api.v4.Evidence source: openapi/cloudbees-unify-beta-openapi.yml fields: 4 - name: api.v4.ListArtifactsResponse source: openapi/cloudbees-unify-beta-openapi.yml fields: 1 - name: api.v4.ListComponentsResponse source: openapi/cloudbees-unify-beta-openapi.yml fields: 3 - name: api.v4.ListDeploymentsResponse source: openapi/cloudbees-unify-beta-openapi.yml fields: 1 - name: api.v4.ListEvidencesResponse source: openapi/cloudbees-unify-beta-openapi.yml fields: 1 - name: api.v4.ListSecurityResultsResponse source: openapi/cloudbees-unify-beta-openapi.yml fields: 1 - name: api.v4.ListTeamMembershipsResponse source: openapi/cloudbees-unify-beta-openapi.yml fields: 2 - name: api.v4.ListTeamsResponse source: openapi/cloudbees-unify-beta-openapi.yml fields: 3 - name: api.v4.ListTestResultsResponse source: openapi/cloudbees-unify-beta-openapi.yml fields: 1 - name: api.v4.ListUsersResponse source: openapi/cloudbees-unify-beta-openapi.yml fields: 3 - name: api.v4.Run source: openapi/cloudbees-unify-beta-openapi.yml fields: 21 - name: api.v4.RunForCreate source: openapi/cloudbees-unify-beta-openapi.yml fields: 19 - name: api.v4.RunForUpdate source: openapi/cloudbees-unify-beta-openapi.yml fields: 8 - name: api.v4.SecurityFinding source: openapi/cloudbees-unify-beta-openapi.yml fields: 10 - name: api.v4.SecurityScanResultForCreate source: openapi/cloudbees-unify-beta-openapi.yml fields: 4 - name: api.v4.TeamMember source: openapi/cloudbees-unify-beta-openapi.yml fields: 2 - name: api.v4.TeamMember_UserProjection source: openapi/cloudbees-unify-beta-openapi.yml fields: 3 - name: api.v4.TeamWithExpansions source: openapi/cloudbees-unify-beta-openapi.yml fields: 8 - name: api.v4.TestResultsFile source: openapi/cloudbees-unify-beta-openapi.yml fields: 4 - name: api.v4.User source: openapi/cloudbees-unify-beta-openapi.yml fields: 6 - name: api.v4.ValidationWarning source: openapi/cloudbees-unify-beta-openapi.yml fields: 3 - name: api.vsm.report.Environment source: openapi/cloudbees-unify-openapi.yml fields: 4 - name: api.vsm.report.EnvironmentResponse source: openapi/cloudbees-unify-openapi.yml fields: 1 - name: google.protobuf.Any source: openapi/cloudbees-unify-beta-openapi.yml fields: 1 - name: google.protobuf.ListValue source: openapi/cloudbees-unify-openapi.yml fields: 0 - name: google.protobuf.Value source: openapi/cloudbees-unify-openapi.yml fields: 0 - name: google.rpc.Status source: openapi/cloudbees-unify-beta-openapi.yml fields: 3 relationships: - from: google.rpc.Status to: google.protobuf.Any type: has_many via: details source: openapi/cloudbees-unify-openapi.yml - from: api.fmimpressions.AllFlagImpressions to: api.fmimpressions.FlagImpression type: has_many via: impressions source: openapi/cloudbees-unify-openapi.yml - from: api.fmimpressions.FlagImpression to: api.fmimpressions.ValuesAndCounters type: has_many via: aggregatedValues source: openapi/cloudbees-unify-openapi.yml - from: api.auth.GetOrganizationsResponse to: api.auth.Organization type: has_many via: organizations source: openapi/cloudbees-unify-openapi.yml - from: api.auth.Organization to: api.auth.Organization type: has_many via: childOrganizations source: openapi/cloudbees-unify-openapi.yml - from: api.auth.Organization to: api.auth.Team type: has_many via: teams source: openapi/cloudbees-unify-openapi.yml - from: api.auth.Organization to: api.auth.Role type: has_many via: roles source: openapi/cloudbees-unify-openapi.yml - from: api.auth.Organization to: api.auth.permission.Permission type: has_many via: permissions source: openapi/cloudbees-unify-openapi.yml - from: api.auth.Organization to: api.auth.EmailDomain type: has_many via: emailDomains source: openapi/cloudbees-unify-openapi.yml - from: api.auth.Organization to: api.auth.Connection type: has_many via: connections source: openapi/cloudbees-unify-openapi.yml - from: api.auth.Team to: api.auth.User type: has_many via: users source: openapi/cloudbees-unify-openapi.yml - from: api.auth.Team to: api.auth.Invite type: has_many via: invites source: openapi/cloudbees-unify-openapi.yml - from: api.auth.Team to: api.auth.Role type: has_many via: roles source: openapi/cloudbees-unify-openapi.yml - from: api.auth.User to: api.Audit type: has_one via: audit source: openapi/cloudbees-unify-openapi.yml - from: api.auth.User to: api.auth.Login type: has_many via: logins source: openapi/cloudbees-unify-openapi.yml - from: api.auth.Login to: api.Audit type: has_one via: audit source: openapi/cloudbees-unify-openapi.yml - from: api.auth.Org to: api.auth.Org type: has_many via: childOrganizations source: openapi/cloudbees-unify-openapi.yml - from: api.auth.Org to: api.Audit type: has_one via: audit source: openapi/cloudbees-unify-openapi.yml - from: api.auth.Org to: api.auth.Team type: has_many via: teams source: openapi/cloudbees-unify-openapi.yml - from: api.auth.Org to: api.auth.Role type: has_many via: roles source: openapi/cloudbees-unify-openapi.yml - from: api.auth.Org to: api.auth.permission.Permission type: has_many via: permissions source: openapi/cloudbees-unify-openapi.yml - from: api.auth.Org to: api.auth.EmailDomain type: has_many via: emailDomains source: openapi/cloudbees-unify-openapi.yml - from: api.auth.Org to: api.auth.Connection type: has_many via: connections source: openapi/cloudbees-unify-openapi.yml - from: api.auth.Role to: api.auth.permission.Permission type: has_many via: permissions source: openapi/cloudbees-unify-openapi.yml - from: api.auth.Invite to: api.Audit type: has_one via: audit source: openapi/cloudbees-unify-openapi.yml - from: api.service.ListServicesResponse to: api.service.Service type: has_many via: service source: openapi/cloudbees-unify-openapi.yml - from: api.auth.GetTeamsResponse to: api.auth.Team type: has_many via: teams source: openapi/cloudbees-unify-openapi.yml - from: api.CustomProperty.ListCustomPropertiesResponse to: api.CustomProperty.CustomProperty type: has_many via: customProperties source: openapi/cloudbees-unify-openapi.yml - from: api.CustomProperty.GetCustomPropertyFlagsUsagePerEnvironmentResponse to: api.TargetGroup.EnvironmentUsage type: has_many via: environments source: openapi/cloudbees-unify-openapi.yml - from: api.TargetGroup.EnvironmentUsage to: api.TargetGroup.FlagUsageInEnvironment type: has_many via: flagUsage source: openapi/cloudbees-unify-openapi.yml - from: api.CustomProperty.GetCustomPropertyTargetGroupUsageResponse to: api.TargetGroup.TargetGroupUsage type: has_many via: targetGroupUsage source: openapi/cloudbees-unify-openapi.yml - from: api.flag.ListFlagConfigurationsResponse to: api.flag.FlagConfigurationEnvironment type: has_many via: configurations source: openapi/cloudbees-unify-openapi.yml - from: api.flag.ListFlagsResponse to: api.flag.Flag type: has_many via: flags source: openapi/cloudbees-unify-openapi.yml - from: api.flag.Flag to: api.flag.FlagConfigurationState type: has_many via: configStates source: openapi/cloudbees-unify-openapi.yml - from: api.flag.GetFlagConfigurationStateResponse to: api.flag.FlagConfigurationState type: has_many via: configurationStates source: openapi/cloudbees-unify-openapi.yml - from: api.flag.GetFlagFlagsUsagePerEnvironmentResponse to: api.TargetGroup.EnvironmentUsage type: has_many via: environments source: openapi/cloudbees-unify-openapi.yml - from: api.TargetGroup.ListTargetGroupsResponse to: api.TargetGroup.TargetGroup type: has_many via: targetGroups source: openapi/cloudbees-unify-openapi.yml - from: api.TargetGroup.ListTargetGroupsWithFlagsUsageResponse to: api.TargetGroup.TargetGroupWithFlagsUsage type: has_many via: targetGroupsWithFlagUsage source: openapi/cloudbees-unify-openapi.yml - from: api.TargetGroup.TargetGroupWithFlagsUsage to: api.TargetGroup.FlagIdName type: has_many via: flagUsage source: openapi/cloudbees-unify-openapi.yml - from: api.TargetGroup.GetTargetGroupFlagsUsagePerEnvironmentResponse to: api.TargetGroup.EnvironmentUsage type: has_many via: environments source: openapi/cloudbees-unify-openapi.yml - from: api.vsm.report.EnvironmentResponse to: api.vsm.report.Environment type: has_many via: environments source: openapi/cloudbees-unify-openapi.yml - from: api.auth.CreateInvitesV3Response to: api.auth.InviteV3 type: has_many via: sentInvites source: openapi/cloudbees-unify-openapi.yml - from: api.v4.CreateRunResponse to: api.v4.ValidationWarning type: has_many via: warnings source: openapi/cloudbees-unify-beta-openapi.yml - from: google.rpc.Status to: google.protobuf.Any type: has_many via: details source: openapi/cloudbees-unify-beta-openapi.yml - from: api.v4.ListArtifactsResponse to: api.v4.ArtifactInfo type: has_many via: artifacts source: openapi/cloudbees-unify-beta-openapi.yml - from: api.v4.CreateArtifactsBody to: api.v4.ArtifactInfo type: has_many via: artifacts source: openapi/cloudbees-unify-beta-openapi.yml - from: api.v4.CreateArtifactsResponse to: api.v4.CreatedArtifact type: has_many via: artifacts source: openapi/cloudbees-unify-beta-openapi.yml - from: api.v4.ListDeploymentsResponse to: api.v4.DeploymentSummary type: has_many via: deployments source: openapi/cloudbees-unify-beta-openapi.yml - from: api.v4.CreateDeploymentArtifactsBody to: api.v4.ArtifactInfo type: has_many via: artifactReferences source: openapi/cloudbees-unify-beta-openapi.yml - from: api.v4.CreateDeploymentArtifactsResponse to: api.v4.ArtifactInfo type: has_many via: artifactReferences source: openapi/cloudbees-unify-beta-openapi.yml - from: api.v4.ListEvidencesResponse to: api.v4.Evidence type: has_many via: evidences source: openapi/cloudbees-unify-beta-openapi.yml - from: api.v4.CreateEvidencesBody to: api.v4.Evidence type: has_many via: evidences source: openapi/cloudbees-unify-beta-openapi.yml - from: api.v4.ListSecurityResultsResponse to: api.v4.SecurityFinding type: has_many via: findings source: openapi/cloudbees-unify-beta-openapi.yml - from: api.v4.CreateSecurityResultsBodyForCreate to: api.v4.SecurityScanResultForCreate type: has_many via: securityResults source: openapi/cloudbees-unify-beta-openapi.yml - from: api.v4.ListTestResultsResponse to: api.v4.TestResultsFile type: has_many via: files source: openapi/cloudbees-unify-beta-openapi.yml - from: api.v4.ListComponentsResponse to: api.v4.Component type: has_many via: components source: openapi/cloudbees-unify-beta-openapi.yml - from: api.v4.ListTeamsResponse to: api.v4.TeamWithExpansions type: has_many via: teams source: openapi/cloudbees-unify-beta-openapi.yml - from: api.v4.TeamWithExpansions to: api.v4.User type: has_many via: users source: openapi/cloudbees-unify-beta-openapi.yml - from: api.v4.ListTeamMembershipsResponse to: api.v4.TeamMember type: has_many via: teamMemberships source: openapi/cloudbees-unify-beta-openapi.yml - from: api.v4.ListUsersResponse to: api.v4.User type: has_many via: users source: openapi/cloudbees-unify-beta-openapi.yml id_reference_fields: - field: resourceId occurrences: 9 - field: organizationId occurrences: 7 - field: userId occurrences: 3 - field: teamId occurrences: 3 - field: parentId occurrences: 2 - field: environmentId occurrences: 2 - field: artifactId occurrences: 2 - field: userIds occurrences: 1 - field: loginIds occurrences: 1 - field: connectionId occurrences: 1 - field: entityId occurrences: 1 - field: endpointId occurrences: 1 - field: linkedComponentIds occurrences: 1 - field: linkedEnvironmentIds occurrences: 1 - field: serviceEndpointId occurrences: 1 - field: flagId occurrences: 1 - field: teamIds occurrences: 1 - field: orgId occurrences: 1 - field: runId occurrences: 1 - field: stageId occurrences: 1 - field: commitId occurrences: 1 - field: jobId occurrences: 1 - field: integrationId occurrences: 1 - field: tenantId occurrences: 1 key_paths: - path: /v2/applications/{applicationId}/flags/{flagId}/configuration/environments/{environmentId} reads: A flag's behaviour is never global — it is always (application x flag x environment). Three ids are required to say anything about what a user will actually be served. - path: /v4/components/{componentId}/runs/{runId}/{artifacts|evidences|test-results|security-results|deployments} reads: 'A run is the join point of the delivery record: everything a pipeline produces hangs off one run id.'