Skip to content

API catalog

Generated from the architecture model

This page is rendered from model/**/*.yaml by tools/docs_model during mkdocs build. Edit the YAML, not this page; hand-written design lives on the linked service, platform and plane pages.

Control Plane

Service Method / gRPC Path / method Scope Side effects Gateway
AgentCardService GET /factory/agent-cards factory.agents.discover read GW-01
AgentCardService GET /factory/agent-cards/{agentId} factory.agents.discover read GW-01
AgentCardService POST /factory/agent-cards/{agentId}/tasks factory.agents.invoke shared-write GW-01
AgentCardService GET /factory/agent-cards/{agentId}/tasks/{taskId} factory.agents.invoke read GW-01
AgentRegistryService POST /factory/asset-releases/validate factory.assets.write sandbox GW-03
AgentRegistryService POST /factory/asset-releases factory.assets.write publication GW-03
AgentRegistryService POST /factory/asset-releases/{releaseId}/publish factory.assets.publish publication GW-03
AgentRegistryService POST /factory/asset-releases/{releaseId}/deprecate factory.assets.publish publication GW-03
AgentRegistryService GET /factory/asset-releases/{releaseId} factory.assets.read read GW-03
AgentRegistryService GET /factory/asset-releases factory.assets.read read GW-03
AgentRegistryService PUT /factory/assets/{assetKind}/{assetId}/aliases/{name} factory.assets.publish publication GW-03
AgentRegistryService gRPC AssetPublication ResolveRelease internal read —
AgentRegistryService gRPC AssetPublication LoadRelease internal read —
ControlPlaneApi GET /factory/health factory.health.read read GW-01
ControlPlaneApi GET /factory/meta/modules factory.meta.read read GW-03
CostUsageService GET /factory/projects/{projectId}/usage factory.usage.read read GW-03
CostUsageService GET /factory/runs/{runId}/usage factory.usage.read read GW-03
CostUsageService PUT /factory/projects/{projectId}/budget factory.usage.admin shared-write GW-03
CostUsageService gRPC Usage Reserve internal spend —
CostUsageService gRPC Usage RecordUsage internal shared-write —
EnvironmentService POST /factory/projects/{projectId}/environments factory.projects.admin shared-write GW-03
EnvironmentService GET /factory/projects/{projectId}/environments factory.projects.read read GW-03
EnvironmentService POST /factory/environments/{environmentId}/freeze factory.projects.admin production GW-03
EnvironmentService POST /factory/environments/{environmentId}/unfreeze factory.projects.admin production GW-03
EnvironmentService gRPC Environments GetPolicyClass internal read —
FactoryCommercialService GET /factory/subscription factory.commercial.read read GW-03
FactoryCommercialService PUT /factory/subscription factory.commercial.admin spend GW-03
FactoryCommercialService GET /factory/invoices factory.commercial.read read GW-03
FactoryCommercialService gRPC Commercial GetEntitlements internal read —
ProjectService POST /factory/projects factory.projects.write shared-write GW-03
ProjectService GET /factory/projects factory.projects.read read GW-03
ProjectService GET /factory/projects/{projectId} factory.projects.read read GW-03
ProjectService PUT /factory/projects/{projectId}/members/{subjectId} factory.projects.admin shared-write GW-03
ProjectService POST /factory/projects/{projectId}/delegations factory.projects.delegate shared-write GW-03
ProjectService DELETE /factory/projects/{projectId}/delegations/{delegationId} factory.projects.delegate shared-write GW-03
ProjectService PUT /factory/projects/{projectId}/source-scope factory.projects.admin shared-write GW-03
ProjectService POST /factory/projects/{projectId}/close factory.projects.admin production GW-03
ProjectService gRPC Projects ResolveScope internal read —
RunControlService POST /factory/runs factory.runs.write shared-write GW-03
RunControlService GET /factory/runs/{runId} factory.runs.read read GW-03
RunControlService GET /factory/runs factory.runs.read read GW-03
RunControlService POST /factory/runs/{runId}/cancel factory.runs.write shared-write GW-03
RunControlService POST /factory/approvals/{approvalId}/decision factory.approvals.decide shared-write GW-03
RunControlService GET /factory/approvals factory.approvals.read read GW-03
RunControlService gRPC RunControl AcquireLease internal shared-write —
RunControlService gRPC RunControl ReportAttemptOutcome internal shared-write —
RunControlService gRPC RunControl RequestApproval internal shared-write —
RunControlService gRPC RunControl WatchRun internal read —

Agent Mesh

Service Method / gRPC Path / method Scope Side effects Gateway
AgentRuntimeService GET /runtime/attempts/{attemptId} factory.runs.read read GW-03
AgentRuntimeService GET /runtime/attempts/{attemptId}/checkpoints factory.runs.read read GW-03
AgentRuntimeService GET /runtime/releases/{releaseId} factory.assets.read read GW-03
AgentRuntimeService gRPC Runtime Interrupt internal shared-write —
AgentRuntimeService gRPC Runtime AnswerDecision internal shared-write —
AgentRuntimeService gRPC Runtime WatchAttempt internal read —
AgentRuntimeWorker GET /runtime/health factory.health.read read GW-01
AgentRuntimeWorker GET /runtime/meta/modules factory.meta.read read GW-03
WorkflowEngineService POST /runtime/workflow-definitions/validate factory.assets.write sandbox GW-03
WorkflowEngineService GET /runtime/workflow-runs/{runId} factory.runs.read read GW-03
WorkflowEngineService GET /runtime/workflow-definitions/{definitionId}/versions factory.assets.read read GW-03
WorkflowEngineService gRPC WorkflowEngine PlanNextSteps internal read —
WorkflowEngineService gRPC WorkflowEngine GetRunGraph internal read —

Model & Compute Platform

Service Method / gRPC Path / method Scope Side effects Gateway
ComputePoolService GET /factory/compute-pools factory.compute.read read GW-03
ComputePoolService POST /factory/compute-pools factory.compute.admin shared-write GW-03
ComputePoolService POST /factory/compute-pools/{poolId}/drain factory.compute.admin production GW-03
ComputePoolService POST /factory/compute-pools/{poolId}/warm factory.compute.admin shared-write GW-03
ComputePoolService GET /factory/compute-pools/placements/{placementId} factory.compute.read read GW-03
ComputePoolService gRPC ComputePools Place internal shared-write —
ComputePoolService gRPC ComputePools ReportUtilization internal shared-write —
ModelGatewayHost GET /model-gateway/health factory.health.read read GW-01
ModelGatewayHost GET /model-gateway/meta/adapters factory.meta.read read GW-03
ModelRouterService GET /factory/model-profiles factory.models.read read GW-03
ModelRouterService GET /factory/model-profiles/{profileId} factory.models.read read GW-03
ModelRouterService GET /factory/model-deployments factory.models.admin read GW-03
ModelRouterService POST /factory/model-deployments factory.models.admin shared-write GW-03
ModelRouterService POST /factory/model-deployments/{deploymentId}/evaluate factory.models.admin sandbox GW-03
ModelRouterService POST /factory/model-deployments/{deploymentId}/approve factory.models.admin publication GW-03
ModelRouterService POST /factory/model-profiles/{profileId}/route-plan/preview factory.models.read read GW-03
ModelRouterService GET /factory/runs/{runId}/model-receipts factory.runs.read read GW-03
ModelRouterService gRPC ModelGateway ResolveRoutePlan internal shared-write —
ModelRouterService gRPC ModelGateway Invoke internal spend —
ModelRouterService gRPC ModelGateway Embed internal spend —
ModelRouterService gRPC ModelGateway Rerank internal spend —

Knowledge Platform

Service Method / gRPC Path / method Scope Side effects Gateway
ArtifactService GET /factory/artifacts/{artifactId} factory.artifacts.read read GW-03
ArtifactService GET /factory/artifacts/{artifactId}/preview factory.artifacts.read read GW-03
ArtifactService GET /factory/artifacts/{artifactId}/versions factory.artifacts.read read GW-03
ArtifactService GET /factory/runs/{runId}/artifacts factory.runs.read read GW-03
ArtifactService POST /factory/projects/{projectId}/artifacts/export factory.artifacts.admin external GW-03
ArtifactService gRPC Artifacts Store internal shared-write —
ArtifactService gRPC Artifacts Fetch internal read —
ArtifactService gRPC Artifacts RecordValidation internal shared-write —
ContextBuilderService GET /factory/runs/{runId}/context-snapshots factory.runs.read read GW-03
ContextBuilderService GET /factory/context-snapshots/{contextSnapshotId} factory.runs.read read GW-03
ContextBuilderService gRPC ContextAssembly Assemble internal read —
MemoryPromotionService GET /factory/memory factory.memory.read read GW-03
MemoryPromotionService GET /factory/memory/{memoryId} factory.memory.read read GW-03
MemoryPromotionService POST /factory/memory/{memoryId}/promote factory.memory.review publication GW-03
MemoryPromotionService POST /factory/memory/{memoryId}/archive factory.memory.review shared-write GW-03
MemoryPromotionService PUT /factory/memory/consent factory.memory.admin production GW-03
MemoryPromotionService gRPC Memory RetrieveMemory internal read —
MemoryPromotionService gRPC Memory Observe internal shared-write —
KnowledgeHost GET /knowledge/health factory.health.read read GW-01
KnowledgeHost GET /knowledge/meta/modules factory.meta.read read GW-03
KnowledgeIngestionService POST /factory/knowledge/sources factory.knowledge.admin shared-write GW-03
KnowledgeIngestionService GET /factory/knowledge/sources factory.knowledge.read read GW-03
KnowledgeIngestionService POST /factory/knowledge/sources/{sourceId}/sync factory.knowledge.admin shared-write GW-03
KnowledgeIngestionService DELETE /factory/knowledge/sources/{sourceId} factory.knowledge.admin production GW-03
KnowledgeIngestionService GET /factory/knowledge/snapshots/{snapshotId} factory.knowledge.read read GW-03
KnowledgeIngestionService PUT /factory/projects/{projectId}/knowledge/collections/{name} factory.knowledge.admin shared-write GW-03
KnowledgeIngestionService gRPC Ingestion GetSourceScope internal read —
RepositoryIntelligenceService GET /factory/repositories/{sourceId}/indexes factory.knowledge.read read GW-03
RepositoryIntelligenceService POST /factory/repositories/{sourceId}/indexes/rebuild factory.knowledge.admin shared-write GW-03
RepositoryIntelligenceService gRPC RepositoryIntelligence ListFiles internal read —
RepositoryIntelligenceService gRPC RepositoryIntelligence SearchText internal read —
RepositoryIntelligenceService gRPC RepositoryIntelligence SearchSymbols internal read —
RepositoryIntelligenceService gRPC RepositoryIntelligence FindReferences internal read —
RepositoryIntelligenceService gRPC RepositoryIntelligence ReadRange internal read —
RepositoryIntelligenceService gRPC RepositoryIntelligence GetDependencies internal read —
RepositoryIntelligenceService gRPC RepositoryIntelligence GetHistory internal read —
VectorMemoryService POST /factory/knowledge/search factory.knowledge.read read GW-03
VectorMemoryService POST /factory/knowledge/graph/query factory.knowledge.read read GW-03
VectorMemoryService GET /factory/knowledge/collections/{collectionId}/indexes factory.knowledge.read read GW-03
VectorMemoryService POST /factory/knowledge/collections/{collectionId}/indexes/rebuild factory.knowledge.admin shared-write GW-03
VectorMemoryService gRPC Retrieval Retrieve internal read —
VectorMemoryService gRPC Retrieval ExpandGraph internal read —

Tools & MCP Platform

Service Method / gRPC Path / method Scope Side effects Gateway
McpServerRegistryService GET /factory/mcp-servers factory.tools.read read GW-03
McpServerRegistryService POST /factory/mcp-servers factory.tools.admin shared-write GW-03
McpServerRegistryService POST /factory/mcp-servers/{serverId}/discover factory.tools.admin sandbox GW-03
McpServerRegistryService POST /factory/mcp-servers/{serverId}/activate factory.tools.admin publication GW-03
McpServerRegistryService GET /factory/mcp-servers/{serverId}/capabilities factory.tools.read read GW-03
McpServerRegistryService POST /factory/mcp-servers/{serverId}/retire factory.tools.admin publication GW-03
McpServerRegistryService gRPC McpRegistry ResolveTool internal read —
McpServerRegistryService gRPC McpRegistry ListCapabilities internal read —
ToolAdapterService GET /factory/tools factory.tools.read read GW-03
ToolAdapterService GET /factory/tools/{toolId} factory.tools.read read GW-03
ToolAdapterService POST /factory/tools/{toolId}/dry-run factory.tools.read sandbox GW-03
ToolAdapterService GET /factory/runs/{runId}/tool-receipts factory.runs.read read GW-03
ToolAdapterService GET /factory/tool-invocations/{invocationId} factory.runs.read read GW-03
ToolAdapterService POST /factory/tool-invocations/{invocationId}/confirm-effect factory.tools.operate shared-write GW-03
ToolAdapterService gRPC ToolExecutor Invoke internal production —
ToolAdapterService gRPC ToolExecutor Validate internal read —
ToolAdapterService gRPC ToolExecutor Interrupt internal shared-write —
ToolExecutorHost GET /tools/health factory.health.read read GW-01
ToolExecutorHost GET /tools/meta/capabilities factory.meta.read read GW-03

Integration Platform

Service Method / gRPC Path / method Scope Side effects Gateway
ConnectorRegistryService GET /factory/connectors factory.connections.read read GW-03
ConnectorRegistryService POST /factory/connectors/{connectorId}/certify factory.connections.admin sandbox GW-03
ConnectorRegistryService POST /factory/subscriptions factory.connections.admin external GW-03
ConnectorRegistryService GET /factory/deliveries factory.connections.read read GW-03
ConnectorRegistryService POST /factory/deliveries/{deliveryId}/replay factory.connections.operate shared-write GW-03
ConnectorRegistryService gRPC Connectors Deliver internal external —
ConnectorRegistryService gRPC Connectors ResolveCapability internal read —
IntegrationHost GET /integration/health factory.health.read read GW-01
IntegrationHost GET /integration/meta/connectors factory.meta.read read GW-03
IntegrationService POST /factory/connections factory.connections.admin shared-write GW-03
IntegrationService GET /factory/connections factory.connections.read read GW-03
IntegrationService POST /factory/connections/{connectionId}/verify factory.connections.admin external GW-03
IntegrationService PUT /factory/connections/{connectionId}/grants/{subjectKind}/{subjectId} factory.connections.admin shared-write GW-03
IntegrationService POST /factory/connections/{connectionId}/rotate factory.connections.admin production GW-03
IntegrationService POST /factory/connections/{connectionId}/revoke factory.connections.admin production GW-03
IntegrationService gRPC Connections Resolve internal read —
WebhookGatewayService POST /webhooks/{ingressRef} factory.webhooks.receive shared-write GW-06
WebhookGatewayService GET /webhooks/health factory.health.read read GW-06

Marketplace

Service Method / gRPC Path / method Scope Side effects Gateway
LicenseService GET /factory/marketplace/listings/{listingId}/pricing factory.marketplace.read read GW-03
LicenseService PUT /factory/marketplace/listings/{listingId}/pricing factory.marketplace.publish shared-write GW-03
LicenseService POST /factory/marketplace/listings/{listingId}/acquire factory.marketplace.acquire spend GW-03
LicenseService GET /factory/marketplace/entitlements factory.marketplace.read read GW-03
LicenseService POST /factory/marketplace/publishers factory.marketplace.publish shared-write GW-03
LicenseService POST /factory/marketplace/publishers/{publisherId}/certify factory.marketplace.admin publication GW-03
LicenseService POST /factory/marketplace/listings/{listingId}/reviews factory.marketplace.read shared-write GW-03
LicenseService gRPC Licensing CheckEntitlement internal read —
MarketplaceCatalogService GET /factory/marketplace/listings factory.marketplace.read read GW-03
MarketplaceCatalogService GET /factory/marketplace/listings/{listingId} factory.marketplace.read read GW-03
MarketplaceCatalogService POST /factory/marketplace/listings factory.marketplace.publish shared-write GW-03
MarketplaceCatalogService POST /factory/marketplace/listings/{listingId}/submit factory.marketplace.publish publication GW-03
MarketplaceCatalogService POST /factory/marketplace/listings/{listingId}/install factory.marketplace.install shared-write GW-03
MarketplaceCatalogService GET /factory/marketplace/installations factory.marketplace.read read GW-03
MarketplaceCatalogService DELETE /factory/marketplace/installations/{installationId} factory.marketplace.install shared-write GW-03
MarketplaceCatalogService gRPC Catalog ResolveListing internal read —
MarketplaceHost GET /marketplace/health factory.health.read read GW-01

DevOps / GitOps

Service Method / gRPC Path / method Scope Side effects Gateway
DeliveryHost GET /delivery/health factory.health.read read GW-01
DeliveryHost GET /delivery/meta/systems factory.meta.read read GW-03
EnvironmentPromotionService GET /factory/delivery/promotions factory.delivery.read read GW-03
EnvironmentPromotionService GET /factory/delivery/promotions/{promotionId} factory.delivery.read read GW-03
EnvironmentPromotionService POST /factory/delivery/promotions factory.delivery.promote production GW-03
EnvironmentPromotionService POST /factory/delivery/promotions/{promotionId}/rollback factory.delivery.operate production GW-03
EnvironmentPromotionService GET /factory/environments/{environmentId}/current-release factory.delivery.read read GW-03
EnvironmentPromotionService gRPC Promotions Request internal production —
PipelineExecutionService GET /factory/delivery/proposals factory.delivery.read read GW-03
PipelineExecutionService GET /factory/delivery/proposals/{proposalId} factory.delivery.read read GW-03
PipelineExecutionService POST /factory/delivery/proposals factory.delivery.propose shared-write GW-03
PipelineExecutionService GET /factory/delivery/pipeline-runs factory.delivery.read read GW-03
PipelineExecutionService GET /factory/delivery/pipeline-runs/{pipelineRunId} factory.delivery.read read GW-03
PipelineExecutionService POST /factory/delivery/pipeline-runs/{pipelineRunId}/reconcile factory.delivery.operate shared-write GW-03
PipelineExecutionService gRPC Pipelines RecordProposal internal shared-write —
ReleaseService GET /factory/delivery/releases factory.delivery.read read GW-03
ReleaseService GET /factory/delivery/releases/{releaseId} factory.delivery.read read GW-03
ReleaseService POST /factory/delivery/releases factory.delivery.release shared-write GW-03
ReleaseService POST /factory/delivery/releases/{releaseId}/withdraw factory.delivery.release shared-write GW-03
ReleaseService gRPC Releases GetRelease internal read —

Runtime Cloud

Service Method / gRPC Path / method Scope Side effects Gateway
IaCProvisioningService GET /factory/provisioning/specifications factory.provisioning.read read GW-03
IaCProvisioningService GET /factory/provisioning/runs factory.provisioning.read read GW-03
IaCProvisioningService GET /factory/provisioning/runs/{provisioningRunId} factory.provisioning.read read GW-03
IaCProvisioningService POST /factory/provisioning/runs factory.provisioning.apply production GW-03
IaCProvisioningService POST /factory/provisioning/runs/{provisioningRunId}/cancel factory.provisioning.apply shared-write GW-03
IaCProvisioningService gRPC Provisioning GetCurrentSpecification internal read —
RuntimeCloudHost GET /runtime-cloud/health factory.health.read read GW-01
RuntimeCloudHost GET /runtime-cloud/meta/targets factory.meta.read read GW-03
ExecutionCapacityService GET /factory/capacity/pools factory.capacity.read read GW-03
ExecutionCapacityService PUT /factory/capacity/pools/{poolId} factory.capacity.admin production GW-03
ExecutionCapacityService GET /factory/capacity/quotas factory.capacity.read read GW-03
ExecutionCapacityService PUT /factory/capacity/quotas/{scope} factory.capacity.admin shared-write GW-03
ExecutionCapacityService GET /factory/capacity/leases factory.capacity.read read GW-03
ExecutionCapacityService gRPC Capacity AcquireLease internal shared-write —
ExecutionCapacityService gRPC Capacity RenewLease internal shared-write —
ExecutionCapacityService gRPC Capacity ReleaseLease internal shared-write —
RuntimeEnvironmentService GET /factory/environments/{environmentId}/inventory factory.runtime.read read GW-03
RuntimeEnvironmentService GET /factory/environments/{environmentId}/drift factory.runtime.read read GW-03
RuntimeEnvironmentService POST /factory/environments/{environmentId}/observe factory.runtime.operate read GW-03
RuntimeEnvironmentService GET /factory/reconciliation/proposals factory.runtime.read read GW-03
RuntimeEnvironmentService POST /factory/reconciliation/proposals/{proposalId}/decide factory.runtime.operate production GW-03
RuntimeEnvironmentService gRPC Inventory GetObservedState internal read —

Product Fleet Operations

Service Method / gRPC Path / method Scope Side effects Gateway
FleetIncidentService GET /factory/fleet/incidents factory.fleet.read read GW-03
FleetIncidentService GET /factory/fleet/incidents/{incidentId} factory.fleet.read read GW-03
FleetIncidentService POST /factory/fleet/incidents factory.fleet.operate shared-write GW-03
FleetIncidentService POST /factory/fleet/incidents/{incidentId}/transition factory.fleet.operate shared-write GW-03
FleetIncidentService GET /factory/fleet/on-call factory.fleet.read read GW-03
FleetIncidentService PUT /factory/fleet/on-call/{recordId} factory.fleet.admin shared-write GW-03
FleetIncidentService POST /factory/fleet/offboardings factory.fleet.admin production GW-03
FleetIncidentService POST /factory/fleet/offboardings/{offboardingId}/acknowledge-handover factory.fleet.admin shared-write GW-03
FleetIncidentService GET /factory/fleet/offboardings/{offboardingId} factory.fleet.read read GW-03
FleetInventoryService GET /factory/fleet/products factory.fleet.read read GW-03
FleetInventoryService GET /factory/fleet/products/{productId} factory.fleet.read read GW-03
FleetInventoryService POST /factory/fleet/products factory.fleet.admin shared-write GW-03
FleetInventoryService GET /factory/fleet/products/{productId}/instances factory.fleet.read read GW-03
FleetInventoryService PUT /factory/fleet/products/{productId}/objectives/{kind} factory.fleet.admin shared-write GW-03
FleetInventoryService gRPC Fleet GetInstance internal read —
FleetOperationsHost GET /fleet/health factory.health.read read GW-01
FleetOperationsHost GET /fleet/meta/summary factory.meta.read read GW-03
FleetRolloutService GET /factory/fleet/rollouts factory.fleet.read read GW-03
FleetRolloutService GET /factory/fleet/rollouts/{rolloutId} factory.fleet.read read GW-03
FleetRolloutService POST /factory/fleet/rollouts factory.fleet.operate production GW-03
FleetRolloutService POST /factory/fleet/rollouts/{rolloutId}/resume factory.fleet.operate production GW-03
FleetRolloutService POST /factory/fleet/rollouts/{rolloutId}/rollback factory.fleet.operate production GW-03
FleetRolloutService POST /factory/fleet/rollouts/{rolloutId}/cancel factory.fleet.operate shared-write GW-03

Data & Event Platform

Service Method / gRPC Path / method Scope Side effects Gateway
DataEventFoundations GET /data-event/health factory.health.read read GW-01
DataEventFoundations GET /data-event/meta/profiles factory.meta.read read GW-03
EnvelopeRegistryService GET /factory/data/topics factory.data.read read GW-03
EnvelopeRegistryService GET /factory/data/topics/{topic} factory.data.read read GW-03
EnvelopeRegistryService PUT /factory/data/topics/{topic} factory.data.admin production GW-03
EnvelopeRegistryService POST /factory/data/topics/{topic}/schema-versions factory.data.admin production GW-03
EnvelopeRegistryService GET /factory/data/envelope-profiles factory.data.read read GW-03
EnvelopeRegistryService gRPC Envelopes ResolveTopic internal read —
EnvelopeRegistryService gRPC Envelopes ValidateEnvelope internal read —
StoreProfileService GET /factory/data/stores factory.data.read read GW-03
StoreProfileService GET /factory/data/store-profiles factory.data.read read GW-03
StoreProfileService PUT /factory/data/stores/{storeId} factory.data.admin production GW-03
StoreProfileService gRPC Stores ResolveBinding internal read —
RetentionResidencyService GET /factory/data/retention factory.data.read read GW-03
RetentionResidencyService PUT /factory/data/retention/{storeClass}/{classification} factory.data.admin shared-write GW-03
RetentionResidencyService GET /factory/data/residency factory.data.read read GW-03
RetentionResidencyService PUT /factory/data/residency factory.data.admin production GW-03
RetentionResidencyService POST /factory/data/orders factory.data.admin production GW-03
RetentionResidencyService GET /factory/data/orders/{orderId} factory.data.read read GW-03
RetentionResidencyService POST /factory/data/orders/{orderId}/acknowledge factory.data.acknowledge shared-write GW-03
RetentionResidencyService gRPC Retention EvaluateResidency internal read —

Governance

Service Method / gRPC Path / method Scope Side effects Gateway
ApprovalPolicyService GET /factory/approval-rules factory.policies.read read GW-03
ApprovalPolicyService POST /factory/projects/{projectId}/approval-rules/validate factory.policies.write sandbox GW-03
ApprovalPolicyService GET /factory/approvals/{approvalId}/routing factory.approvals.read read GW-03
ApprovalPolicyService gRPC ApprovalPolicy Route internal read —
ApprovalPolicyService gRPC ApprovalPolicy ValidateDecision internal read —
AuditService GET /factory/audit factory.audit.read read GW-03
AuditService POST /factory/projects/{projectId}/audit/export factory.audit.export external GW-03
AuditService GET /factory/classifications factory.audit.read read GW-03
AuditService PUT /factory/classifications/{resourceType} factory.audit.admin production GW-03
AuditService GET /factory/findings factory.audit.read read GW-03
AuditService POST /factory/findings/{findingId}/resolve factory.audit.admin shared-write GW-03
AuditService gRPC Audit Record internal shared-write —
AuditService gRPC Audit Classify internal read —
AuditService gRPC Audit Redact internal shared-write —
GovernanceHost GET /governance/health factory.health.read read GW-01
GovernanceHost GET /governance/meta/revisions factory.meta.read read GW-03
PolicyEngineService GET /factory/policies factory.policies.read read GW-03
PolicyEngineService GET /factory/policies/{revision} factory.policies.read read GW-03
PolicyEngineService POST /factory/projects/{projectId}/policy/validate factory.policies.write sandbox GW-03
PolicyEngineService POST /factory/policies/simulate factory.policies.write sandbox GW-03
PolicyEngineService GET /factory/runs/{runId}/policy-decisions factory.runs.read read GW-03
PolicyEngineService gRPC Policy Decide internal read —
PolicyEngineService gRPC Policy GetActiveRevision internal read —
PolicyEngineService gRPC Policy ValidateTightening internal read —
SecretBrokerService GET /factory/secret-references factory.secrets.admin read GW-03
SecretBrokerService POST /factory/secret-references factory.secrets.admin production GW-03
SecretBrokerService POST /factory/secret-references/{referenceId}/rotate factory.secrets.admin production GW-03
SecretBrokerService POST /factory/secret-references/{referenceId}/revoke factory.secrets.admin production GW-03
SecretBrokerService GET /factory/runs/{runId}/issuances factory.runs.read read GW-03
SecretBrokerService gRPC SecretBroker Issue internal shared-write —
SecretBrokerService gRPC SecretBroker Revoke internal shared-write —
SecretBrokerService gRPC SecretBroker Verify internal external —

Observability

Service Method / gRPC Path / method Scope Side effects Gateway
AlertRuleService GET /factory/alerts factory.operations.read read GW-03
AlertRuleService POST /factory/alerts/{alertId}/acknowledge factory.operations.operate shared-write GW-03
AlertRuleService POST /factory/alerts/{alertId}/resolve factory.operations.operate shared-write GW-03
AlertRuleService GET /factory/alert-rules factory.operations.read read GW-03
AlertRuleService PUT /factory/alert-rules/{name} factory.operations.admin shared-write GW-03
DashboardService GET /factory/operations/runs factory.runs.read read GW-03
DashboardService GET /factory/operations/runs/{runId} factory.runs.read read GW-03
DashboardService GET /factory/operations/overview factory.operations.read read GW-03
DashboardService GET /factory/operations/overview/{kind}/{subjectId} factory.operations.read read GW-03
DashboardService POST /factory/operations/runs/{runId}/rebuild factory.operations.admin shared-write GW-03
DashboardService gRPC Operations Subscribe internal read —
FeedbackService POST /factory/feedback factory.feedback.write shared-write GW-03
FeedbackService GET /factory/feedback factory.feedback.read read GW-03
FeedbackService GET /factory/evaluation/datasets factory.evaluation.read read GW-03
FeedbackService POST /factory/evaluation/datasets/{datasetId}/snapshot factory.evaluation.run shared-write GW-03
FeedbackService GET /factory/learning/proposals factory.evaluation.read read GW-03
FeedbackService POST /factory/learning/proposals/{proposalId}/decide factory.assets.write shared-write GW-03
FeedbackService gRPC Learning GetDatasetSnapshot internal read —
ObservabilityHost GET /observability/health factory.health.read read GW-01
ObservabilityHost GET /observability/meta/backends factory.meta.read read GW-03
QualityScoreService GET /factory/evaluation/suites factory.evaluation.read read GW-03
QualityScoreService POST /factory/evaluation/runs factory.evaluation.run sandbox GW-03
QualityScoreService GET /factory/evaluation/runs/{evaluationId} factory.evaluation.read read GW-03
QualityScoreService POST /factory/evaluation/runs/{evaluationId}/waive factory.evaluation.waive publication GW-03
QualityScoreService GET /factory/asset-releases/{releaseId}/evaluations factory.evaluation.read read GW-03
QualityScoreService gRPC Evaluation GetVerdict internal read —
QualityScoreService gRPC Evaluation RunSuite internal sandbox —
SloService GET /factory/slos factory.operations.read read GW-03
SloService PUT /factory/slos/{subjectKind}/{subjectId}/{kind} factory.operations.admin shared-write GW-03
SloService GET /factory/health/services factory.operations.read read GW-03

Factory Studio

Service Method / gRPC Path / method Scope Side effects Gateway
StudioBff GET /studio/session factory.studio.use read GW-02
StudioBff PUT /studio/session/scope factory.studio.use shared-write GW-02
StudioBff PUT /studio/session/preferences factory.studio.use shared-write GW-02
StudioBff GET /studio/screens/{screenId} factory.studio.use read GW-02
StudioBff POST /studio/commands/{commandId} factory.studio.use production GW-02
StudioBff GET /studio/views factory.studio.use read GW-02
StudioBff PUT /studio/views/{viewId} factory.studio.use shared-write GW-02
StudioBff GET /studio/search factory.studio.use read GW-02
StudioBff GET /studio/health factory.health.read read GW-01
StudioNotificationService GET /studio/notifications factory.studio.use read GW-02
StudioNotificationService POST /studio/notifications/{notificationId}/read factory.studio.use shared-write GW-02
StudioNotificationService PUT /studio/notifications/preferences factory.studio.use shared-write GW-02
StudioNotificationService gRPC Notifications Notify internal shared-write —
StudioRealtimeGateway GET /studio/realtime/health factory.health.read read GW-01
StudioRealtimeGateway gRPC Realtime Subscribe internal read —

Template & Library

Service Method / gRPC Path / method Scope Side effects Gateway
BlueprintService GET /factory/blueprints factory.blueprints.read read GW-03
BlueprintService GET /factory/blueprints/{blueprintId}/versions/{version} factory.blueprints.read read GW-03
BlueprintService POST /factory/blueprints factory.blueprints.write shared-write GW-03
BlueprintService POST /factory/blueprints/{blueprintId}/versions/{version}/validate factory.blueprints.write shared-write GW-03
BlueprintService POST /factory/blueprints/{blueprintId}/versions/{version}/submit factory.blueprints.publish publication GW-03
BlueprintService gRPC Blueprints GetDerivedModel internal read —
TemplateCatalogHost GET /templates/health factory.health.read read GW-01
TemplateCatalogHost GET /templates/meta/feeds factory.meta.read read GW-03
GenerationRecipeService GET /factory/recipes factory.recipes.read read GW-03
GenerationRecipeService GET /factory/recipes/{recipeId}/versions/{version} factory.recipes.read read GW-03
GenerationRecipeService POST /factory/recipes factory.recipes.write shared-write GW-03
GenerationRecipeService POST /factory/recipes/{recipeId}/versions/{version}/validate factory.recipes.write shared-write GW-03
GenerationRecipeService POST /factory/recipes/{recipeId}/versions/{version}/approve factory.recipes.approve shared-write GW-03
GenerationRecipeService GET /factory/projects/{projectId}/generated-outputs factory.recipes.read read GW-03
GenerationRecipeService gRPC Recipes GetApprovedRecipe internal read —
GenerationRecipeService gRPC Recipes RecordOutput internal shared-write —
TemplateRegistryService GET /factory/templates factory.catalog.read read GW-03
TemplateRegistryService GET /factory/templates/{templateId}/versions/{version} factory.catalog.read read GW-03
TemplateRegistryService GET /factory/libraries factory.catalog.read read GW-03
TemplateRegistryService GET /factory/compatibility factory.catalog.read read GW-03
TemplateRegistryService POST /factory/templates/discover factory.catalog.admin shared-write GW-03
TemplateRegistryService POST /factory/templates/{templateId}/versions/{version}/publish factory.catalog.admin publication GW-03
TemplateRegistryService gRPC Catalog ResolveManifest internal read —

Generated SaaS

Service Method / gRPC Path / method Scope Side effects Gateway
GeneratedSaasFoundations GET /product/tenants product.admin.read read GW-07
GeneratedSaasFoundations POST /product/tenants product.admin.write shared-write GW-07
GeneratedSaasFoundations GET /product/tenants/{productTenantId}/subscription product.admin.read read GW-07
GeneratedSaasFoundations PUT /product/tenants/{productTenantId}/subscription product.admin.write shared-write GW-07
GeneratedSaasFoundations gRPC Foundations ResolveTenant internal read —
GeneratedProductHost GET /product/descriptor product.admin.read read GW-07
GeneratedProductHost GET /product/health product.health.read read GW-07
GeneratedProductHost GET /product/operations/handover product.admin.read read GW-07
GeneratedProductHost POST /product/operations/handover/acknowledge product.admin.write shared-write GW-07
GeneratedProductHost POST /product/operations/export product.admin.write external GW-07
GeneratedProductHost POST /product/operations/delete-tenant product.admin.write production GW-07