planning v1

AI-friendly cloud control plane.

AI-first neocloud control plane for agents, Terraform, CLIs, and UI clients building on LinkRidge Cloud.

The checked OpenAPI 3.1 skeleton lives in docs/api/linkridge-cloud-control-plane.openapi.json and is validated against this resource model.

API version v1

All agent, UI, CLI, MCP, and Terraform clients should converge on this control-plane contract.

Base path /v1

The repo now keeps an OpenAPI skeleton aligned with these paths before backend, SDK, and provider work grows from it.

Beta footprint mfsoho

Limited hardware capacity means beta services must be quota-aware, approval-gated, and biased toward control-plane proof before heavy data-plane workloads.

Neocloud thesis

Use AWS control-plane discipline without inheriting AWS scale complexity.

  • OpenAPI is the source of truth for every public control-plane resource.
  • Agents and Terraform call the same API as the UI instead of using separate backdoors.
  • Every write is idempotent, auditable, tenant-scoped, and able to run in dry-run mode before external effects.
  • Small-cluster beta limits are explicit until the larger 155/Dell footprint is available.
  • AWS-style separation of control plane and data plane guides the architecture without copying AWS complexity.

API conventions

Agents need predictable contracts more than clever endpoints.

Stable resource IDs
Every resource exposes an immutable id and a type-specific import path for agents, Terraform, and audit logs.
Idempotency keys
Mutating POST requests accept Idempotency-Key and return the original result for safe agent retries.
Dry-run planning
Risky writes support dry_run=true or a plan endpoint that returns intended effects without executing them.
Explicit states
Long-running and approval-gated resources expose status, blockers, and next_allowed_actions.
Pagination
List endpoints use cursor pagination with deterministic ordering and predictable page limits.
Problem errors
Errors follow application/problem+json with code, message, request_id, and remediation fields.
Audit events
Every state-changing request emits or references an audit event with actor, account, service, target, and action context.
Account-scoped writes
Account-scoped internal/dev tokens may prepare only resources for allowed accounts; draft account creation requires wildcard operator scope.
Webhooks
Async state changes can emit signed webhook events after the platform webhook primitive exists.
identity

Identity and tenancy

Accounts, users, memberships, invites, roles, and service tokens.

auth_diagnostics
/v1/auth/diagnostics
auth_token_policy
/v1/auth/token-policy
account_auth_token_policy
/v1/accounts/{account_id}/auth/token-policy
accounts
/v1/accounts
account_memberships
/v1/accounts/{account_id}/memberships
account_invites
/v1/accounts/{account_id}/invites
invite_acceptance_requirements
/v1/accounts/{account_id}/invites/{invite_id}/acceptance-requirements
invite_acceptance_session_preview
/v1/accounts/{account_id}/invites/{invite_id}/acceptance-session-preview
invite_onboarding_readiness
/v1/accounts/{account_id}/invites/{invite_id}/onboarding-readiness
invite_onboarding_handoff
/v1/accounts/{account_id}/invites/{invite_id}/onboarding-handoff
invite_workspace_activation_preview
/v1/accounts/{account_id}/invites/{invite_id}/workspace-activation-preview
invite_customer_access_preview
/v1/accounts/{account_id}/invites/{invite_id}/customer-access-preview
invite_membership_activation_preview
/v1/accounts/{account_id}/invites/{invite_id}/membership-activation-preview
invite_first_login_workspace_preview
/v1/accounts/{account_id}/invites/{invite_id}/first-login-workspace-preview
invite_dashboard_session_preview
/v1/accounts/{account_id}/invites/{invite_id}/dashboard-session-preview
invite_dashboard_workspace_data_preview
/v1/accounts/{account_id}/invites/{invite_id}/dashboard-workspace-data-preview
invite_dashboard_action_requirements
/v1/accounts/{account_id}/invites/{invite_id}/dashboard-action-requirements
invite_local_acceptance
/v1/accounts/{account_id}/invites/{invite_id}/local-acceptance
invite_onboarding_block
/v1/accounts/{account_id}/invites/{invite_id}/onboarding-block
invite_membership_handoff_block
/v1/accounts/{account_id}/invites/{invite_id}/membership-handoff-block
invite_customer_access_closeout
/v1/accounts/{account_id}/invites/{invite_id}/customer-access-closeout
invite_session_revocation_block
/v1/accounts/{account_id}/invites/{invite_id}/session-revocation-block
invite_session_expiry_block
/v1/accounts/{account_id}/invites/{invite_id}/session-expiry-block
invite_session_audit_closeout
/v1/accounts/{account_id}/invites/{invite_id}/session-audit-closeout
invite_workspace_access_block
/v1/accounts/{account_id}/invites/{invite_id}/workspace-access-block
invite_dashboard_workspace_data_block
/v1/accounts/{account_id}/invites/{invite_id}/dashboard-workspace-data-block
invite_dashboard_notification_block
/v1/accounts/{account_id}/invites/{invite_id}/dashboard-notification-block
invite_dashboard_publish_block
/v1/accounts/{account_id}/invites/{invite_id}/dashboard-publish-block
invite_dashboard_access_audit_closeout
/v1/accounts/{account_id}/invites/{invite_id}/dashboard-access-audit-closeout
invite_final_closeout
/v1/accounts/{account_id}/invites/{invite_id}/final-closeout
invite_evidence_export_block
/v1/accounts/{account_id}/invites/{invite_id}/evidence-export-block
invite_dashboard_qr_draft_submissions
/v1/accounts/{account_id}/invites/{invite_id}/dashboard-qr-draft-submissions
dev_session_intents
/v1/accounts/{account_id}/dev-session-intents
dev_session_operator_auth_check
/v1/accounts/{account_id}/dev-session-intents/{intent_id}/operator-auth-check
dev_session_customer_session_rehearsal
/v1/accounts/{account_id}/dev-session-intents/{intent_id}/customer-session-rehearsal
dev_session_first_login_handoff
/v1/accounts/{account_id}/dev-session-intents/{intent_id}/first-login-handoff
dev_session_dashboard_access_gate
/v1/accounts/{account_id}/dev-session-intents/{intent_id}/dashboard-access-gate
dev_session_browser_token_block
/v1/accounts/{account_id}/dev-session-intents/{intent_id}/browser-token-block
dev_session_auth_provider_grant_block
/v1/accounts/{account_id}/dev-session-intents/{intent_id}/auth-provider-grant-block
dev_session_membership_activation_block
/v1/accounts/{account_id}/dev-session-intents/{intent_id}/membership-activation-block
dev_session_customer_access_closeout
/v1/accounts/{account_id}/dev-session-intents/{intent_id}/customer-access-closeout
dev_session_revocation_block
/v1/accounts/{account_id}/dev-session-intents/{intent_id}/revocation-block
dev_session_expiry_block
/v1/accounts/{account_id}/dev-session-intents/{intent_id}/expiry-block
dev_session_audit_closeout
/v1/accounts/{account_id}/dev-session-intents/{intent_id}/audit-closeout
dev_session_support_handoff_block
/v1/accounts/{account_id}/dev-session-intents/{intent_id}/support-handoff-block
dev_session_final_closeout
/v1/accounts/{account_id}/dev-session-intents/{intent_id}/final-closeout
dev_session_evidence_export_block
/v1/accounts/{account_id}/dev-session-intents/{intent_id}/evidence-export-block
dev_session_evidence_handoff_block
/v1/accounts/{account_id}/dev-session-intents/{intent_id}/evidence-handoff-block
service_tokens
/v1/accounts/{account_id}/service-tokens
service_token_issuance_block
/v1/accounts/{account_id}/service-tokens/{token_id}/issuance-block
service_token_access_closeout
/v1/accounts/{account_id}/service-tokens/{token_id}/access-closeout
service_token_rotation_block
/v1/accounts/{account_id}/service-tokens/{token_id}/rotation-block
service_token_revocation_block
/v1/accounts/{account_id}/service-tokens/{token_id}/revocation-block
service_token_audit_closeout
/v1/accounts/{account_id}/service-tokens/{token_id}/audit-closeout
service_token_terraform_handoff_block
/v1/accounts/{account_id}/service-tokens/{token_id}/terraform-handoff-block
service_token_final_closeout
/v1/accounts/{account_id}/service-tokens/{token_id}/final-closeout
service_catalog

Service catalog

Available services, plans, entitlements, account services, and usage limits.

services
/v1/services
account_services
/v1/accounts/{account_id}/services
entitlements
/v1/accounts/{account_id}/services/{account_service_id}/entitlements
qr_service

QR service

QR workspaces, campaigns, codes, mutation requests, route resolution, scan events, and audit evidence.

qr_workspaces
/v1/qr/workspaces
qr_campaigns
/v1/qr/workspaces/{workspace_id}/campaigns
qr_codes
/v1/qr/workspaces/{workspace_id}/codes
qr_mutation_requests
/v1/qr/workspaces/{workspace_id}/mutation-requests
qr_mutation_request_readback
/v1/qr/workspaces/{workspace_id}/mutation-requests/{mutation_request_id}
qr_mutation_execution_rehearsal_requirements
/v1/qr/workspaces/{workspace_id}/mutation-requests/{mutation_request_id}/execution-rehearsal-requirements
qr_mutation_execution_hold
/v1/qr/workspaces/{workspace_id}/mutation-requests/{mutation_request_id}/execution-hold
qr_mutation_execution_gate
/v1/qr/workspaces/{workspace_id}/mutation-requests/{mutation_request_id}/execution-gate
qr_mutation_execution_publish_block
/v1/qr/workspaces/{workspace_id}/mutation-requests/{mutation_request_id}/execution-publish-block
qr_mutation_execution_abort
/v1/qr/workspaces/{workspace_id}/mutation-requests/{mutation_request_id}/execution-abort
qr_mutation_execution_closeout
/v1/qr/workspaces/{workspace_id}/mutation-requests/{mutation_request_id}/execution-closeout
qr_route_resolutions
/v1/qr/workspaces/{workspace_id}/route-resolutions
qr_import_jobs
/v1/qr/workspaces/{workspace_id}/import-jobs
qr_scan_events
/v1/qr/workspaces/{workspace_id}/scan-events
operations

Operations

Provisioning runs, operator approvals, billing export requests, audit records, and status checks.

activation_packets
/v1/accounts/{account_id}/services/{account_service_id}/activation-packets
billing_export_requests
/v1/accounts/{account_id}/services/{account_service_id}/billing-export-requests
support_cases
/v1/accounts/{account_id}/services/{account_service_id}/support-cases
provisioning_runs
/v1/provisioning-runs
review_packets
/v1/review-packets
review_packet_decisions
/v1/review-packets/{review_packet_id}/decision
review_packet_decision_requirements
/v1/review-packets/{review_packet_id}/decision-requirements
operator_approvals
/v1/operator-approvals
operator_account_billing
/v1/operator/accounts/{account_id}/billing
operator_open_qr_service_activation
/v1/operator/accounts/{account_id}/open-qr-service
operator_account_cleanup
/v1/operator/accounts/{account_id}/cleanup
audit_events
/v1/audit-events
future_primitives

Future primitives

Workflow runs, function deployments, app deployments, object buckets, domains, queues, and schedules.

workflow_runs
/v1/workflows/runs
function_deployments
/v1/functions
app_deployments
/v1/deployments
object_buckets
/v1/storage/buckets

Provider design rules

Terraform should plan first and execute only through reviewed API writes.

  • Provider resources map one-to-one to durable control-plane resources.
  • Data sources expose catalog, entitlement, approval, provisioning, and audit state.
  • Create and update operations send Idempotency-Key and preserve request_id/audit_event_id in diagnostics.
  • Plan-time validation calls dry-run endpoints when a change could trigger billing, invites, DNS, deploys, or external redirects.
  • Import IDs follow stable API resource IDs rather than display names.

Control-plane resources

One API model for agents, Terraform, MCP, CLI, and UI.

identity GET

auth_diagnostics

Authenticated internal/dev token diagnostics for accepted actor, scope, account-scope allowlist, actor-binding fingerprint, configured-token state, scope-config validity, and guardrail evidence.

Path
/v1/auth/diagnostics
Terraform
linkridgecloud_auth_diagnostics

Returns only non-secret actor, scope, account-scope allowlist, actor-binding fingerprint, configured-token/default-dev-fallback evidence, scope-config validity, account-scope config validity, and guardrail metadata for the accepted bearer token; it must never return token values, token hashes, token-material fingerprints, customer credentials, service-token secret material, or external auth-provider state. Unsupported configured scopes and unsafe wildcard-plus-account allowlists fail closed before authenticated API access.

identity GET

auth_token_policy

Read-only internal/dev contract for planned operator API keys, customer service-token credentials, and actor-binding evidence.

Path
/v1/auth/token-policy
Terraform
linkridgecloud_auth_token_policy

Documents account binding, actor-binding fingerprints, allowed internal/dev scopes, hashing, rotation, revocation, Terraform usage, configured-token/default-dev-fallback runtime evidence, scope-config validity, account-scope config validity, approval requirements, and disabled credential issuance without returning token values, token hashes, token-material fingerprints, service-token secret material, external API access, or auth-provider state.

identity GET

account_auth_token_policy

Account-scoped read-only token policy evidence for tenant-bound operator and customer automation credentials.

Path
/v1/accounts/{account_id}/auth/token-policy
Terraform
linkridgecloud_auth_token_policy

Verifies account existence and actor account scope before returning planned token policy metadata and non-secret actor-binding evidence; it denies cross-account reads and never issues credentials, stores token hashes, returns token material, or enables external API access.

identity GET, POST

accounts

Tenant and billing boundary for one customer or builder workspace.

Path
/v1/accounts
Terraform
linkridgecloud_account

Agents may list and prepare draft accounts, but activation remains approval-gated. Account-scoped internal/dev tokens can list allowed accounts only; draft account creation requires wildcard operator scope.

identity GET, POST

account_memberships

Account-scoped role assignment for users or approved agent operators.

Path
/v1/accounts/{account_id}/memberships
Terraform
linkridgecloud_account_membership

Account-scoped internal/dev tokens may only read memberships for their allowed accounts. Invite delivery is separate from local membership planning.

identity GET, POST

account_invites

Draft account invite packets with role, service scope, expiry, and delivery state.

Path
/v1/accounts/{account_id}/invites
Terraform
linkridgecloud_account_invite

Account-scoped internal/dev tokens may only read or prepare invite metadata for their allowed accounts. Invite records may be prepared for review, but outbound delivery and external access require explicit approval.

identity GET

invite_acceptance_requirements

Read-only checklist for a prepared invite acceptance handoff while delivery, acceptance links, auth-provider grants, sessions, and membership activation remain blocked.

Path
/v1/accounts/{account_id}/invites/{invite_id}/acceptance-requirements
Terraform
linkridgecloud_account_invite

Account-scoped internal/dev tokens may inspect whether a local invite has enough metadata for a future acceptance flow, but the endpoint always returns acceptance_allowed=false in this phase. It provides non-secret blocked actions, membership handoff evidence, disabled external-effect guardrails, and a sanitized acceptance_requirements_fingerprint without sending invites, creating acceptance links, granting external access, activating memberships, creating sessions, issuing secrets, or creating customer-visible effects.

identity GET

invite_acceptance_session_preview

Read-only customer-like session and onboarding preview for an invite acceptance handoff while real sessions, browser tokens, auth-provider grants, and membership activation remain blocked.

Path
/v1/accounts/{account_id}/invites/{invite_id}/acceptance-session-preview
Terraform
linkridgecloud_account_invite

Account-scoped internal/dev tokens may inspect the tenant, invite role, service scope, workspace count, and membership handoff that a future invite accepter would see. The endpoint always returns session_allowed=false and sanitized guardrails without sending invites, creating acceptance links, issuing browser tokens, granting external access, activating memberships, issuing secrets, or creating customer-visible effects.

identity GET

invite_onboarding_readiness

Read-only onboarding readiness handoff for an approved local invite and activation packet while customer onboarding remains blocked.

Path
/v1/accounts/{account_id}/invites/{invite_id}/onboarding-readiness
Terraform
linkridgecloud_account_invite

Account-scoped internal/dev tokens may inspect the customer-like onboarding state after local-only invite and activation approvals. The endpoint always returns onboarding_allowed=false and sanitized guardrails without sending invites, creating acceptance links, issuing browser tokens, granting auth-provider access, activating memberships, executing activation jobs, creating billing customers, enabling hosted redirects, issuing secrets, or creating customer-visible effects.

identity GET

invite_onboarding_handoff

Read-only customer-like onboarding handoff for an invite after local-only approvals while customer access remains blocked.

Path
/v1/accounts/{account_id}/invites/{invite_id}/onboarding-handoff
Terraform
linkridgecloud_account_invite

Account-scoped internal/dev tokens may inspect the account, service, workspace, invite, membership, and readiness state a future invited customer would see. The endpoint always returns handoff_allowed=false and sanitized guardrails without sending invites, creating acceptance links, issuing browser tokens, granting auth-provider access, activating memberships, executing activation jobs, creating billing customers, enabling hosted redirects, issuing secrets, or creating customer-visible effects.

identity GET

invite_workspace_activation_preview

Read-only service and workspace activation preview for an invite after local-only approvals while customer activation remains blocked.

Path
/v1/accounts/{account_id}/invites/{invite_id}/workspace-activation-preview
Terraform
linkridgecloud_account_invite

Account-scoped internal/dev tokens may inspect the service and workspace state that a future customer activation would enable. The endpoint always returns activation_preview_allowed=false and sanitized guardrails without running activation jobs, enabling workspaces, publishing hosted redirects, creating billing customers, issuing sessions or secrets, deploying production, or creating customer-visible effects.

identity GET

invite_customer_access_preview

Read-only customer access preview for an invite after local-only approvals while customer dashboard access remains blocked.

Path
/v1/accounts/{account_id}/invites/{invite_id}/customer-access-preview
Terraform
linkridgecloud_account_invite

Account-scoped internal/dev tokens may inspect the account, service, workspace, membership, and session context a future customer dashboard would need. The endpoint always returns customer_access_allowed=false and sanitized guardrails without sending invites, creating acceptance links, issuing browser tokens, granting auth-provider access, activating memberships, enabling workspaces, creating billing customers, issuing secrets, publishing redirects, or creating customer-visible effects.

identity GET

invite_membership_activation_preview

Read-only membership activation preview for an invite after local-only approvals while membership activation and customer sessions remain blocked.

Path
/v1/accounts/{account_id}/invites/{invite_id}/membership-activation-preview
Terraform
linkridgecloud_account_invite

Account-scoped internal/dev tokens may inspect the membership handoff that a future accepted invite would activate. The endpoint always returns membership_activation_allowed=false and sanitized guardrails without sending invites, creating acceptance links, granting auth-provider access, activating memberships, issuing browser tokens, creating customer sessions, issuing secrets, enabling customer access, or creating customer-visible effects.

identity GET

invite_first_login_workspace_preview

Read-only first login workspace preview for an invite after local-only approvals while customer login, sessions, dashboard access, and workspace enablement remain blocked.

Path
/v1/accounts/{account_id}/invites/{invite_id}/first-login-workspace-preview
Terraform
linkridgecloud_account_invite

Account-scoped internal/dev tokens may inspect the account, service, and workspace context a future invited customer would see after acceptance. The endpoint always returns first_login_allowed=false and sanitized guardrails without opening customer login, creating browser tokens, granting auth-provider access, activating memberships, enabling workspaces, publishing hosted redirects, issuing secrets, or creating customer-visible effects.

identity GET

invite_dashboard_session_preview

Read-only dashboard session preview for an invite after local-only approvals while customer dashboard sessions remain blocked.

Path
/v1/accounts/{account_id}/invites/{invite_id}/dashboard-session-preview
Terraform
linkridgecloud_account_invite

Account-scoped internal/dev tokens may inspect the dashboard route and workspace context a future invited customer would use after first login. The endpoint always returns dashboard_session_allowed=false and sanitized guardrails without opening customer dashboard access, creating browser tokens, granting auth-provider access, activating memberships, enabling workspaces, issuing secrets, or creating customer-visible effects.

identity GET

invite_dashboard_workspace_data_preview

Read-only dashboard workspace data preview for an invite after local-only approvals while customer dashboard data and sessions remain blocked.

Path
/v1/accounts/{account_id}/invites/{invite_id}/dashboard-workspace-data-preview
Terraform
linkridgecloud_account_invite

Account-scoped internal/dev tokens may inspect the service and planned workspace rows a future customer dashboard would need after first login. The endpoint always returns dashboard_workspace_data_allowed=false and sanitized guardrails without opening dashboard access, loading customer-visible dashboard data, creating sessions, issuing browser tokens, granting auth-provider access, activating memberships, enabling workspaces, publishing hosted redirects, issuing secrets, or creating customer-visible effects.

identity GET

invite_dashboard_action_requirements

Read-only dashboard action requirements for an invite after local-only approvals while customer dashboard writes remain blocked.

Path
/v1/accounts/{account_id}/invites/{invite_id}/dashboard-action-requirements
Terraform
linkridgecloud_account_invite

Account-scoped internal/dev tokens may inspect the disabled create/edit QR controls a future customer dashboard would show after first login. The endpoint always returns dashboard_action_allowed=false and sanitized guardrails without creating QR codes, changing destinations, opening dashboard access, creating sessions, issuing browser tokens, enabling workspaces, publishing hosted redirects, issuing secrets, or creating customer-visible effects.

identity POST

invite_local_acceptance

Dev-only local invite acceptance handoff without sending invite delivery or granting customer access.

Path
/v1/accounts/{account_id}/invites/{invite_id}/local-acceptance
Terraform
linkridgecloud_account_invite

Account-scoped internal/dev tokens may persist a local-only accepted handoff after invite review approval. The POST records sanitized membership/workspace handoff, audit evidence, idempotent replay, and conflict behavior while keeping invite delivery, acceptance links, auth-provider users/grants, browser/customer sessions, membership activation, service-token secrets, and customer-visible effects disabled.

identity POST

invite_onboarding_block

Dev-only local invite onboarding block after local acceptance without opening customer access.

Path
/v1/accounts/{account_id}/invites/{invite_id}/onboarding-block
Terraform
linkridgecloud_account_invite

Account-scoped internal/dev tokens may persist a local-only onboarding block after invite review approval and local acceptance. The POST records sanitized membership/workspace handoff, audit evidence, idempotent replay, and conflict behavior while keeping invite delivery, acceptance links, auth-provider users/grants, browser/customer sessions, membership activation, customer dashboard/workspace access, service-token secrets, and customer-visible effects disabled.

identity POST

invite_membership_handoff_block

Dev-only local invite membership handoff block after onboarding is blocked without granting membership or customer access.

Path
/v1/accounts/{account_id}/invites/{invite_id}/membership-handoff-block
Terraform
linkridgecloud_account_invite

Account-scoped internal/dev tokens may persist a local-only membership handoff block after invite review approval, local acceptance, and onboarding block. The POST records sanitized membership/workspace handoff, audit evidence, idempotent replay, and conflict behavior while keeping account membership grants, membership activation, first login, dashboard/workspace access, invite delivery, acceptance links, auth-provider users/grants, browser/customer sessions, service-token secrets, and customer-visible effects disabled.

identity POST

invite_customer_access_closeout

Dev-only local invite customer access closeout after membership handoff is blocked without enabling customer access.

Path
/v1/accounts/{account_id}/invites/{invite_id}/customer-access-closeout
Terraform
linkridgecloud_account_invite

Account-scoped internal/dev tokens may persist a local-only customer access closeout after invite review approval, local acceptance, onboarding block, and membership handoff block. The POST records sanitized membership/workspace handoff, audit evidence, idempotent replay, and conflict behavior while keeping customer access, dashboard/workspace access, account membership grants, membership activation, first login, invite delivery, acceptance links, auth-provider users/grants, browser/customer sessions, service-token secrets, customer notifications, and customer-visible effects disabled.

identity POST

invite_session_revocation_block

Dev-only local invite session revocation block after customer access is closed out without revoking real sessions or tokens.

Path
/v1/accounts/{account_id}/invites/{invite_id}/session-revocation-block
Terraform
linkridgecloud_account_invite

Account-scoped internal/dev tokens may persist a local-only session revocation block after invite review approval, local acceptance, onboarding block, membership handoff block, and customer access closeout. The POST records sanitized membership/workspace handoff, audit evidence, idempotent replay, and conflict behavior while keeping customer sessions, browser tokens, auth-provider sessions, dashboard sessions, customer access, memberships, notifications, and customer-visible effects unchanged.

identity POST

invite_session_expiry_block

Dev-only local invite session expiry block after session revocation is blocked without expiring real sessions or tokens.

Path
/v1/accounts/{account_id}/invites/{invite_id}/session-expiry-block
Terraform
linkridgecloud_account_invite

Account-scoped internal/dev tokens may persist a local-only session expiry block after invite review approval, local acceptance, onboarding block, membership handoff block, customer access closeout, and session revocation block. The POST records sanitized membership/workspace handoff, audit evidence, idempotent replay, and conflict behavior while keeping customer sessions, browser tokens, auth-provider sessions, dashboard sessions, customer access, memberships, notifications, and customer-visible effects unchanged.

identity POST

invite_session_audit_closeout

Dev-only local invite session audit closeout after session expiry is blocked without changing customer sessions, tokens, memberships, or access.

Path
/v1/accounts/{account_id}/invites/{invite_id}/session-audit-closeout
Terraform
linkridgecloud_account_invite

Account-scoped internal/dev tokens may persist a local-only session audit closeout after invite review approval, local acceptance, onboarding block, membership handoff block, customer access closeout, session revocation block, and session expiry block. The POST records sanitized membership/workspace handoff, audit evidence, idempotent replay, and conflict behavior while keeping customer sessions, browser tokens, auth-provider sessions, dashboard sessions, customer access, memberships, notifications, and customer-visible effects unchanged.

identity POST

invite_workspace_access_block

Dev-only local invite workspace access block after session audit closeout without opening workspace or dashboard access.

Path
/v1/accounts/{account_id}/invites/{invite_id}/workspace-access-block
Terraform
linkridgecloud_account_invite

Account-scoped internal/dev tokens may persist a local-only workspace access block after invite review approval, local acceptance, onboarding block, membership handoff block, customer access closeout, session revocation block, session expiry block, and session audit closeout. The POST records sanitized membership/workspace handoff readback, audit evidence, idempotent replay, and conflict behavior while keeping workspace access, dashboard sessions, customer access, memberships, notifications, hosted redirects, and customer-visible effects disabled.

identity POST

invite_dashboard_workspace_data_block

Dev-only local invite dashboard workspace data block after workspace access remains blocked without loading customer dashboard data.

Path
/v1/accounts/{account_id}/invites/{invite_id}/dashboard-workspace-data-block
Terraform
linkridgecloud_account_invite

Account-scoped internal/dev tokens may persist a local-only dashboard workspace data block after invite review approval, local acceptance, onboarding block, membership handoff block, customer access closeout, session revocation block, session expiry block, session audit closeout, and workspace access block. The POST records sanitized workspace data readback, dashboard workspace data preview fingerprint, audit evidence, idempotent replay, and conflict behavior while keeping customer dashboard data loading, workspace access, dashboard sessions, browser tokens, hosted redirects, customer access, memberships, notifications, and customer-visible effects disabled.

identity POST

invite_dashboard_notification_block

Dev-only local invite dashboard notification block after dashboard workspace data remains blocked without emailing customers or publishing dashboard access.

Path
/v1/accounts/{account_id}/invites/{invite_id}/dashboard-notification-block
Terraform
linkridgecloud_account_invite

Account-scoped internal/dev tokens may persist a local-only dashboard notification block after invite review approval, local acceptance, onboarding block, membership handoff block, customer access closeout, session revocation block, session expiry block, session audit closeout, workspace access block, and dashboard workspace data block. The POST records sanitized notification readback, audit evidence, idempotent replay, and conflict behavior while keeping customer notifications, dashboard access, customer sessions, browser tokens, auth-provider grants, membership changes, workspace access, hosted redirects, and customer-visible effects disabled.

identity POST

invite_dashboard_publish_block

Dev-only local invite dashboard publish block after dashboard notification remains blocked without enabling customer dashboard access.

Path
/v1/accounts/{account_id}/invites/{invite_id}/dashboard-publish-block
Terraform
linkridgecloud_account_invite

Account-scoped internal/dev tokens may persist a local-only dashboard publish block after invite review approval, local acceptance, onboarding block, membership handoff block, customer access closeout, session revocation block, session expiry block, session audit closeout, workspace access block, dashboard workspace data block, and dashboard notification block. The POST records sanitized dashboard publish readback, audit evidence, idempotent replay, and conflict behavior while keeping customer dashboard access, dashboard sessions, browser tokens, auth-provider grants, membership changes, workspace access, hosted redirects, notifications, and customer-visible effects disabled.

identity POST

invite_dashboard_access_audit_closeout

Dev-only local invite dashboard access audit closeout after dashboard publish remains blocked without customer-visible reports or notifications.

Path
/v1/accounts/{account_id}/invites/{invite_id}/dashboard-access-audit-closeout
Terraform
linkridgecloud_account_invite

Account-scoped internal/dev tokens may persist a local-only dashboard access audit closeout after invite review approval, local acceptance, onboarding block, membership handoff block, customer access closeout, session revocation/expiry/audit blocks, workspace access block, dashboard workspace data block, dashboard notification block, and dashboard publish block. The POST records sanitized dashboard access audit readback, audit evidence, idempotent replay, and conflict behavior while keeping customer dashboard access, dashboard sessions, browser tokens, auth-provider grants, membership changes, workspace access, hosted redirects, customer notifications, customer-visible reports, and customer-visible effects disabled.

identity POST

invite_final_closeout

Dev-only local invite final closeout after dashboard access audit closeout without granting customer access or publishing reports.

Path
/v1/accounts/{account_id}/invites/{invite_id}/final-closeout
Terraform
linkridgecloud_account_invite

Account-scoped internal/dev tokens may persist a local-only invite final closeout after invite review approval, local acceptance, onboarding block, membership handoff block, customer access closeout, session revocation/expiry/audit blocks, workspace access block, dashboard workspace data block, dashboard notification block, dashboard publish block, and dashboard access audit closeout. The POST records sanitized final evidence/readback, audit evidence, idempotent replay, and conflict behavior while keeping customer dashboard access, sessions, browser tokens, auth-provider grants, membership changes, workspace access, hosted redirects, service-token secrets, customer reports, customer notifications, production execution, and customer-visible effects disabled.

identity POST

invite_evidence_export_block

Dev-only local invite evidence export block after final closeout without creating customer reports or publishing evidence.

Path
/v1/accounts/{account_id}/invites/{invite_id}/evidence-export-block
Terraform
linkridgecloud_account_invite

Account-scoped internal/dev tokens may persist a local-only invite evidence export block after invite review approval, local acceptance, onboarding block, membership handoff block, customer access closeout, session revocation/expiry/audit blocks, workspace access block, dashboard workspace data block, dashboard notification block, dashboard publish block, dashboard access audit closeout, and final closeout. The POST records sanitized local evidence export packaging, audit evidence, idempotent replay, and conflict behavior while keeping customer reports, evidence exports, notifications, customer dashboard access, sessions, browser tokens, auth-provider grants, membership changes, hosted redirects, service-token secrets, production execution, and customer-visible effects disabled.

identity POST

invite_dashboard_qr_draft_submissions

Dev-only local dashboard QR draft submission for an invite without creating or changing customer QR records.

Path
/v1/accounts/{account_id}/invites/{invite_id}/dashboard-qr-draft-submissions
Terraform
linkridgecloud_account_invite

Account-scoped internal/dev tokens may persist a local-only dashboard QR draft submission after local invite/activation approvals and the dev dashboard access gate. The POST records a planned QR mutation request, review packet, audit evidence, idempotent replay, and conflict behavior while keeping customer dashboard access, sessions, browser tokens, auth-provider grants, hosted redirects, tenant QR writes, destination changes, billing, service-token secrets, and customer-visible effects disabled.

identity GET, POST

dev_session_intents

Dev-only local session intent records for exercising operator/customer login handoff without creating real sessions.

Path
/v1/accounts/{account_id}/dev-session-intents
Terraform
linkridgecloud_account

Account-scoped internal/dev tokens may read or prepare local-only session intents for their allowed accounts. The POST persists sanitized intent and audit evidence with idempotency readback, but always returns session_allowed=false and keeps browser tokens, customer sessions, auth-provider grants, membership activation, acceptance links, service-token secrets, dashboard access, and customer-visible effects disabled.

identity POST

dev_session_operator_auth_check

Dev-only local operator-auth check for a persisted session intent without issuing customer/browser tokens.

Path
/v1/accounts/{account_id}/dev-session-intents/{intent_id}/operator-auth-check
Terraform
linkridgecloud_account

Account-scoped internal/dev tokens may advance a local-only dev session intent through an operator-auth check. The POST persists sanitized check state and audit/idempotency evidence while keeping customer sessions, browser tokens, auth-provider grants, membership activation, acceptance links, service-token secrets, dashboard access, and customer-visible effects disabled.

identity POST

dev_session_customer_session_rehearsal

Dev-only local customer-session rehearsal for a checked operator-auth intent without issuing browser/customer tokens.

Path
/v1/accounts/{account_id}/dev-session-intents/{intent_id}/customer-session-rehearsal
Terraform
linkridgecloud_account

Account-scoped internal/dev tokens may advance a local-only dev session intent through customer-session rehearsal after operator auth is checked. The POST persists sanitized rehearsal state and audit/idempotency evidence while keeping real customer sessions, browser tokens, auth-provider grants, membership activation, acceptance links, service-token secrets, dashboard access, and customer-visible effects disabled.

identity POST

dev_session_first_login_handoff

Dev-only local first-login handoff for a rehearsed session intent without issuing browser/customer tokens.

Path
/v1/accounts/{account_id}/dev-session-intents/{intent_id}/first-login-handoff
Terraform
linkridgecloud_account

Account-scoped internal/dev tokens may advance a local-only dev session intent through first-login handoff after customer-session rehearsal. The POST persists sanitized handoff state and audit/idempotency evidence while keeping real customer sessions, browser tokens, auth-provider grants, membership activation, acceptance links, service-token secrets, dashboard access, and customer-visible effects disabled.

identity POST

dev_session_dashboard_access_gate

Dev-only local dashboard access gate for a first-login handoff without opening customer dashboard access.

Path
/v1/accounts/{account_id}/dev-session-intents/{intent_id}/dashboard-access-gate
Terraform
linkridgecloud_account

Account-scoped internal/dev tokens may advance a local-only dev session intent through dashboard access gating after first-login handoff. The POST persists sanitized gate state and audit/idempotency evidence while keeping real customer sessions, browser tokens, dashboard access, auth-provider grants, membership activation, acceptance links, service-token secrets, and customer-visible effects disabled.

identity POST

dev_session_browser_token_block

Dev-only local browser-token block for a dashboard-gated session intent without issuing browser or customer tokens.

Path
/v1/accounts/{account_id}/dev-session-intents/{intent_id}/browser-token-block
Terraform
linkridgecloud_account

Account-scoped internal/dev tokens may advance a local-only dev session intent through browser-token blocking after dashboard access gating. The POST persists sanitized token-block state and audit/idempotency evidence while keeping real customer sessions, browser tokens, dashboard access, auth-provider grants, membership activation, acceptance links, service-token secrets, and customer-visible effects disabled.

identity POST

dev_session_auth_provider_grant_block

Dev-only local auth-provider grant block for a browser-token-blocked session intent without creating auth users or grants.

Path
/v1/accounts/{account_id}/dev-session-intents/{intent_id}/auth-provider-grant-block
Terraform
linkridgecloud_account

Account-scoped internal/dev tokens may advance a local-only dev session intent through auth-provider grant blocking after browser-token blocking. The POST persists sanitized grant-block state and audit/idempotency evidence while keeping real customer sessions, browser tokens, dashboard access, auth-provider users/grants, membership activation, acceptance links, service-token secrets, and customer-visible effects disabled.

identity POST

dev_session_membership_activation_block

Dev-only local membership activation block for an auth-provider-blocked session intent without activating account membership.

Path
/v1/accounts/{account_id}/dev-session-intents/{intent_id}/membership-activation-block
Terraform
linkridgecloud_account

Account-scoped internal/dev tokens may advance a local-only dev session intent through membership activation blocking after auth-provider grant blocking. The POST persists sanitized membership-block state and audit/idempotency evidence while keeping real customer sessions, browser tokens, dashboard access, auth-provider users/grants, membership activation, acceptance links, service-token secrets, and customer-visible effects disabled.

identity POST

dev_session_customer_access_closeout

Dev-only local customer access closeout for a membership-blocked session intent without enabling customer access.

Path
/v1/accounts/{account_id}/dev-session-intents/{intent_id}/customer-access-closeout
Terraform
linkridgecloud_account

Account-scoped internal/dev tokens may close out a local-only dev session intent after membership activation blocking. The POST persists sanitized customer-access closeout state and audit/idempotency evidence while keeping real customer sessions, browser tokens, dashboard access, auth-provider users/grants, membership activation, service-token secrets, acceptance links, and customer-visible effects disabled.

identity POST

dev_session_revocation_block

Dev-only local customer session revocation block after customer-access closeout without revoking real sessions or tokens.

Path
/v1/accounts/{account_id}/dev-session-intents/{intent_id}/revocation-block
Terraform
linkridgecloud_account

Account-scoped internal/dev tokens may advance a local-only dev session intent through revocation blocking after customer-access closeout. The POST persists sanitized revocation-block state and audit/idempotency evidence while keeping real customer session revocation, browser-token revocation, auth-provider session revocation, dashboard access changes, membership activation, service-token secrets, and customer-visible effects disabled.

identity POST

dev_session_expiry_block

Dev-only local customer session expiry block after revocation blocking without expiring real sessions or tokens.

Path
/v1/accounts/{account_id}/dev-session-intents/{intent_id}/expiry-block
Terraform
linkridgecloud_account

Account-scoped internal/dev tokens may advance a local-only dev session intent through expiry blocking after session revocation blocking. The POST persists sanitized expiry-block state and audit/idempotency evidence while keeping real customer session expiry, browser-token expiry, auth-provider session expiry, dashboard session expiry, membership activation, service-token secrets, and customer-visible effects disabled.

identity POST

dev_session_audit_closeout

Dev-only local session audit closeout after expiry blocking without changing real sessions or tokens.

Path
/v1/accounts/{account_id}/dev-session-intents/{intent_id}/audit-closeout
Terraform
linkridgecloud_account

Account-scoped internal/dev tokens may advance a local-only dev session intent through audit closeout after session expiry blocking. The POST persists sanitized audit-closeout state and audit/idempotency evidence while keeping real customer session changes, browser-token changes, auth-provider session changes, dashboard session changes, membership changes, service-token secrets, and customer-visible effects disabled.

identity POST

dev_session_support_handoff_block

Dev-only local support handoff block after session audit closeout without creating support cases or notifying customers.

Path
/v1/accounts/{account_id}/dev-session-intents/{intent_id}/support-handoff-block
Terraform
linkridgecloud_account

Account-scoped internal/dev tokens may advance a local-only dev session intent through support handoff blocking after session audit closeout. The POST persists sanitized support handoff state and audit/idempotency evidence while keeping support cases, customer notifications, customer timeline publication, real customer sessions, browser tokens, auth-provider grants, membership changes, dashboard access, and customer-visible effects disabled.

identity POST

dev_session_final_closeout

Dev-only local final closeout after support handoff blocking without customer-visible session, support, or timeline effects.

Path
/v1/accounts/{account_id}/dev-session-intents/{intent_id}/final-closeout
Terraform
linkridgecloud_account

Account-scoped internal/dev tokens may advance a local-only dev session intent through final closeout after support handoff blocking. The POST persists sanitized final closeout state, local evidence archive readback, audit/idempotency evidence, and conflict behavior while keeping support cases, customer notifications, customer timeline publication, real customer sessions, browser tokens, auth-provider grants, membership changes, dashboard access, and customer-visible effects disabled.

identity POST

dev_session_evidence_export_block

Dev-only local evidence export block after final closeout without creating customer reports, support cases, notifications, timelines, or session effects.

Path
/v1/accounts/{account_id}/dev-session-intents/{intent_id}/evidence-export-block
Terraform
linkridgecloud_account

Account-scoped internal/dev tokens may advance a local-only dev session intent through evidence export blocking after final closeout. The POST persists sanitized local export packaging readback, audit/idempotency evidence, and conflict behavior while keeping customer reports, support cases, customer notifications, customer timeline publication, real customer sessions, browser tokens, auth-provider grants, membership changes, dashboard access, and customer-visible effects disabled.

identity POST

dev_session_evidence_handoff_block

Dev-only local redacted evidence handoff block after evidence export blocking without creating customer reports, support cases, notifications, timelines, or session effects.

Path
/v1/accounts/{account_id}/dev-session-intents/{intent_id}/evidence-handoff-block
Terraform
linkridgecloud_account

Account-scoped internal/dev tokens may advance a local-only dev session intent through redacted evidence handoff blocking after evidence export blocking. The POST persists sanitized handoff readiness readback, audit/idempotency evidence, and conflict behavior while keeping customer reports, support cases, customer notifications, customer timeline publication, real customer sessions, browser tokens, auth-provider grants, membership changes, dashboard access, and customer-visible effects disabled.

identity GET, POST

service_tokens

Scoped API credentials for approved automation clients.

Path
/v1/accounts/{account_id}/service-tokens
Terraform
linkridgecloud_service_token

Account-scoped internal/dev tokens may only read or prepare service-token metadata for their allowed accounts. The local/dev runtime can prepare service-token metadata requests and review packets, but secret issuance, token-hash storage, external API access, invites, and billing exports stay approval-gated.

identity POST

service_token_issuance_block

Dev-only local service-token issuance block after metadata approval without issuing secrets or enabling API access.

Path
/v1/accounts/{account_id}/service-tokens/{token_id}/issuance-block
Terraform
linkridgecloud_service_token

Account-scoped internal/dev tokens may persist a local-only service-token issuance block after local-only service-token review approval. The POST records sanitized issuance-block state, audit evidence, idempotent replay, and conflict behavior while keeping secret material issuance, token-hash storage, external API access, invites, billing exports, and customer-visible effects disabled.

identity POST

service_token_access_closeout

Dev-only local service-token access closeout after issuance remains blocked without issuing secrets or enabling API access.

Path
/v1/accounts/{account_id}/service-tokens/{token_id}/access-closeout
Terraform
linkridgecloud_service_token

Account-scoped internal/dev tokens may persist a local-only service-token access closeout after local-only issuance blocking. The POST records sanitized closeout state, audit evidence, idempotent replay, and conflict behavior while keeping secret material issuance, token-hash storage, external API access, invites, billing exports, and customer-visible effects disabled.

identity POST

service_token_rotation_block

Dev-only local service-token rotation block after access closeout without issuing or revoking secrets.

Path
/v1/accounts/{account_id}/service-tokens/{token_id}/rotation-block
Terraform
linkridgecloud_service_token

Account-scoped internal/dev tokens may persist a local-only service-token rotation block after local-only access closeout. The POST records sanitized rotation-block state, audit evidence, idempotent replay, and conflict behavior while keeping new secret material issuance, previous secret revocation, token-hash rotation/storage, external API access, billing exports, and customer-visible effects disabled.

identity POST

service_token_revocation_block

Dev-only local service-token revocation block after rotation remains blocked without revoking secrets or disabling real API credentials.

Path
/v1/accounts/{account_id}/service-tokens/{token_id}/revocation-block
Terraform
linkridgecloud_service_token

Account-scoped internal/dev tokens may persist a local-only service-token revocation block after local-only rotation blocking. The POST records sanitized revocation-block state, audit evidence, idempotent replay, and conflict behavior while keeping secret revocation, token-hash revocation, external API credential changes, billing exports, production execution, and customer-visible effects disabled.

identity POST

service_token_audit_closeout

Dev-only local service-token audit closeout after revocation remains blocked without issuing, revoking, or enabling real credentials.

Path
/v1/accounts/{account_id}/service-tokens/{token_id}/audit-closeout
Terraform
linkridgecloud_service_token

Account-scoped internal/dev tokens may persist a local-only service-token audit closeout after local-only revocation blocking. The POST records sanitized closeout state, audit evidence, idempotent replay, and conflict behavior while keeping secret material issuance/revocation, token-hash storage/revocation, external API credential changes, billing exports, production execution, and customer-visible effects disabled.

identity POST

service_token_terraform_handoff_block

Dev-only local Terraform service-token handoff block after audit closeout without issuing credentials or enabling provider writes.

Path
/v1/accounts/{account_id}/service-tokens/{token_id}/terraform-handoff-block
Terraform
linkridgecloud_service_token

Account-scoped internal/dev tokens may persist a local-only Terraform handoff block after service-token audit closeout. The POST records sanitized Terraform credential/write blocking, audit evidence, idempotent replay, and conflict behavior while keeping provider writes, service-token secret material, token hashes, external API access, billing exports, production execution, and customer-visible effects disabled.

identity POST

service_token_final_closeout

Dev-only local service-token final closeout after Terraform handoff remains blocked without issuing credentials or enabling provider writes.

Path
/v1/accounts/{account_id}/service-tokens/{token_id}/final-closeout
Terraform
linkridgecloud_service_token

Account-scoped internal/dev tokens may persist a local-only service-token final closeout after the Terraform handoff block. The POST records sanitized final-closeout evidence, audit evidence, idempotent replay, and conflict behavior while keeping credential issuance/revocation, provider writes, service-token secret material, token hashes, external API access, billing exports, production execution, and customer-visible effects disabled.

service_catalog GET

services

Catalog of LinkRidge Cloud services and lifecycle state.

Path
/v1/services
Terraform
linkridgecloud_service

Read-only discovery endpoint for agent service selection.

service_catalog GET, POST

account_services

Requested or enabled service subscriptions for an account.

Path
/v1/accounts/{account_id}/services
Terraform
linkridgecloud_account_service

Account-scoped internal/dev tokens may only read or prepare account-service records for their allowed accounts. The local/dev runtime can prepare draft service activation requests, but activation, billing, workspace creation, token secrets, customer access, and hosted QR redirects stay approval-gated.

service_catalog GET

entitlements

Effective feature and limit values for one account service.

Path
/v1/accounts/{account_id}/services/{account_service_id}/entitlements
Terraform
linkridgecloud_entitlements

Account-scoped internal/dev tokens may only read entitlement records for their allowed accounts. Agents should read entitlements before performing tenant work.

operations GET, POST

activation_packets

Operator review packet that ties account identity, membership, entitlements, service workspace, billing boundary, skipped external actions, and audit evidence together before activation.

Path
/v1/accounts/{account_id}/services/{account_service_id}/activation-packets
Terraform
linkridgecloud_activation_packets

Account-scoped internal/dev tokens may only read or prepare activation packets for their allowed accounts. The local/dev runtime can prepare activation packets for review, but agents must not activate accounts, send invites, issue credentials, bill, expose redirects, or deploy production changes.

qr_service GET, POST

qr_workspaces

Tenant-scoped QR service workspace resolved before QR records load.

Path
/v1/qr/workspaces
Terraform
linkridgecloud_qr_workspace

Account-scoped internal/dev tokens only list or prepare QR workspaces for their allowed accounts. The local/dev runtime can prepare planned QR workspaces for an existing QR account service, but redirects, imports, dashboards, mutations, and billable usage stay approval-gated.

qr_service GET, POST

qr_campaigns

Campaign grouping for QR codes and scan evidence.

Path
/v1/qr/workspaces/{workspace_id}/campaigns
Terraform
linkridgecloud_qr_campaign

Campaign IDs must remain workspace-scoped.

qr_service GET, POST

qr_codes

Managed QR code records with destination, slug, label, style, and status.

Path
/v1/qr/workspaces/{workspace_id}/codes
Terraform
linkridgecloud_qr_code

Destination changes should use mutation requests when external redirects are gated.

qr_service GET, POST

qr_mutation_requests

Planned QR changes that require entitlement checks and operator approval before external effects.

Path
/v1/qr/workspaces/{workspace_id}/mutation-requests
Terraform
linkridgecloud_qr_mutation_request

Account-scoped internal/dev tokens may only read mutation requests for workspaces bound to their allowed accounts. Agent writes should prefer mutation requests for reviewable changes.

qr_service GET

qr_mutation_request_readback

Exact account-scoped readback for a planned QR mutation request and its sanitized readiness evidence.

Path
/v1/qr/workspaces/{workspace_id}/mutation-requests/{mutation_request_id}
Terraform
linkridgecloud_qr_mutation_requests

Operators can use this after draft POST to prove the persisted request, review status, draft idempotency evidence, and no-effect guardrails without relying on list filtering. This route never exposes idempotency keys, request hashes, token values, hosted redirects, billing usage, or customer-visible write effects.

qr_service GET

qr_mutation_execution_rehearsal_requirements

Read-only checklist and safe request template for the dev-only QR mutation execution rehearsal.

Path
/v1/qr/workspaces/{workspace_id}/mutation-requests/{mutation_request_id}/execution-rehearsal-requirements
Terraform
linkridgecloud_qr_mutation_requests

Operators and Terraform can inspect whether a QR mutation has the required approved_local_only review decision, the exact blocked-action acknowledgement set, the actor binding fingerprint, a rehearsal_requirements_fingerprint that must be echoed by the POST body, non-secret idempotency requirements, and any existing rehearsal evidence before posting execution-rehearsal. This endpoint never writes tenant QR records, enables redirects, checks entitlement, records billing usage, or creates customer-visible effects.

qr_service POST

qr_mutation_execution_hold

Dev-only local operator hold for an approved and rehearsed QR mutation without publishing customer-visible QR changes.

Path
/v1/qr/workspaces/{workspace_id}/mutation-requests/{mutation_request_id}/execution-hold
Terraform
linkridgecloud_qr_mutation_requests

Operators can persist a local-only execution hold after execution rehearsal. The POST records audit and idempotency evidence while tenant QR writes, hosted redirects, destination changes, dashboard publishing, billing usage, and customer-visible execution stay disabled until Matthew explicitly approves external effects.

qr_service POST

qr_mutation_execution_gate

Dev-only local execution gate for a held QR mutation without publishing customer-visible QR changes.

Path
/v1/qr/workspaces/{workspace_id}/mutation-requests/{mutation_request_id}/execution-gate
Terraform
linkridgecloud_qr_mutation_requests

Operators can persist a local-only execution gate after execution hold. The POST records audit and idempotency evidence while tenant QR writes, hosted redirects, destination changes, dashboard publishing, billing usage, execution markers, and customer-visible effects stay disabled until Matthew explicitly approves external effects.

qr_service POST

qr_mutation_execution_publish_block

Dev-only local publish block for a gated QR mutation without publishing customer-visible QR changes.

Path
/v1/qr/workspaces/{workspace_id}/mutation-requests/{mutation_request_id}/execution-publish-block
Terraform
linkridgecloud_qr_mutation_requests

Operators can persist a local-only publish block after execution gate. The POST records audit and idempotency evidence while tenant QR writes, hosted redirects, destination changes, dashboard publishing/execution markers, billing usage, and customer-visible effects stay disabled until Matthew explicitly approves external effects.

qr_service POST

qr_mutation_execution_abort

Dev-only local abort for a publish-blocked QR mutation without cancelling customer-visible QR changes.

Path
/v1/qr/workspaces/{workspace_id}/mutation-requests/{mutation_request_id}/execution-abort
Terraform
linkridgecloud_qr_mutation_requests

Operators can persist a local-only execution abort after the publish block. The POST records audit and idempotency evidence while tenant QR writes, hosted redirects, destination changes, dashboard publishing/execution markers, customer-system cancellations, billing usage, and customer-visible effects stay disabled; any real execution or cancellation still requires Matthew approval.

qr_service POST

qr_mutation_execution_closeout

Dev-only local closeout for an aborted QR mutation without notifying customers or closing customer-visible requests.

Path
/v1/qr/workspaces/{workspace_id}/mutation-requests/{mutation_request_id}/execution-closeout
Terraform
linkridgecloud_qr_mutation_requests

Operators can persist a local-only execution closeout after the abort. The POST records audit and idempotency evidence while tenant QR writes, hosted redirects, destination changes, dashboard publishing/execution markers, customer-system cancellations, customer notifications, billing usage, and customer-visible effects stay disabled; any real execution, cancellation, closeout, or notification still requires Matthew approval.

qr_service GET

qr_route_resolutions

Account-scoped redirect resolution evidence for QR slugs before hosted redirects are approved.

Path
/v1/qr/workspaces/{workspace_id}/route-resolutions
Terraform
linkridgecloud_qr_route_resolutions

Agents should inspect route evidence before proposing hosted redirect or destination-change work.

qr_service GET, POST

qr_import_jobs

Reviewable import plans for Open QR browser libraries or links.json exports before tenant records are changed.

Path
/v1/qr/workspaces/{workspace_id}/import-jobs
Terraform
linkridgecloud_qr_import_job

Account-scoped internal/dev tokens may only read or prepare import jobs for workspaces bound to their allowed accounts. Import jobs must reconcile slugs, aliases, and destinations locally while customer data import, redirects, and external writes stay approval-gated.

qr_service GET

qr_scan_events

Local-only QR scan usage evidence resolved through account, account service, workspace, and code context.

Path
/v1/qr/workspaces/{workspace_id}/scan-events
Terraform
linkridgecloud_qr_scan_events

Fixture scan events stay non-billable and unexported until hosted redirects and billing export are approved.

operations GET, POST

billing_export_requests

Reviewable export requests that group service usage before any external billing-provider write occurs.

Path
/v1/accounts/{account_id}/services/{account_service_id}/billing-export-requests
Terraform
linkridgecloud_billing_export_request

Account-scoped internal/dev tokens may only read billing export requests for their allowed accounts. Writes stay approval-gated and must not create customers, subscriptions, invoices, or metered usage records without explicit approval.

operations GET, POST

support_cases

Reviewable support and operator-handoff cases tied to one account service before customer-visible support workflows exist.

Path
/v1/accounts/{account_id}/services/{account_service_id}/support-cases
Terraform
linkridgecloud_support_case

Account-scoped internal/dev tokens may only read support cases for their allowed accounts. Agents may prepare local support evidence, but outbound customer contact, ticket creation, and escalation actions require explicit approval.

operations GET, POST

provisioning_runs

Local rehearsal and future execution record for account-service provisioning.

Path
/v1/provisioning-runs
Terraform
linkridgecloud_provisioning_run

Supports dry-run planning and records skipped external actions.

operations GET

review_packets

Normalized internal review index for blocked service-token, import, activation, billing, and support packets.

Path
/v1/review-packets
Terraform
linkridgecloud_review_packets

Read-only operator evidence for approval-gated work. Account-scoped internal/dev tokens may only read packets for their allowed accounts; this endpoint must not approve, execute, notify, export, issue secrets, or enable customer-visible effects.

operations POST

review_packet_decisions

Internal-only approve/reject decision transition for one review packet.

Path
/v1/review-packets/{review_packet_id}/decision
Terraform
linkridgecloud_review_packets

Local approval requires the accepted internal/dev actor to be scoped to the review packet account, the linked local/dev resource to be present, external_effects_acknowledged=true, blocked_external_actions_acknowledged to list all and only the current skipped actions, and decision_requirements_fingerprint from the current requirements response/template before state is persisted. Missing, invalid, or stale fingerprints fail closed before idempotency, audit, or state writes. Decisions update evidence, retain the accepted/current decision_requirements_fingerprint, store normalized guardrail_evidence and non-secret operator_evidence with linked resource transition evidence on the review packet/operator approval/audit record, and may mark linked invite, service-token, QR import, QR mutation, activation, billing-export, or support metadata ready_for_review/open_local_only while delivery, secrets, import execution, redirects, billing export, support tickets, activation, customer access, and production deploys remain blocked; exact idempotent replays are allowed, but a fresh decision against an already approved/rejected packet fails closed; it does not create customer-visible effects.

operations GET

review_packet_decision_requirements

Read-only checklist and safe decision body templates for the local-only approve/reject body required by one review packet.

Path
/v1/review-packets/{review_packet_id}/decision-requirements
Terraform
linkridgecloud_review_packets

Operators and Terraform can inspect the exact blocked_external_actions acknowledgement set, required decision_requirements_fingerprint, ready-to-use approve_local_only/reject body templates, optional reviewer_user_id/operator_notes evidence fields that become normalized non-secret operator_evidence, linked-resource readiness, linked transition preview, actor binding fingerprint, non-secret idempotency requirements, and local-only guardrails before posting a decision. The transition preview names the linked local resource, approve/reject resulting statuses, next required operator action, and disabled external-effect flags without mutating state. Posted acknowledgements must match all and only the current blocked-action set, and posted fingerprints must match the current packet status, actor binding, linked-resource readiness, and blocked-action set. Already approved/rejected packets return decision_allowed=false, decision_blocked_reason=review_packet_already_decided, empty required_body_fields/optional_body_fields, and no decision_templates so operators cannot accidentally reuse a terminal packet checklist. Terminal packets also return terminal_decision with the accepted fingerprint, non-secret reviewer/note metadata, linked-resource transition evidence, idempotency evidence, and guardrails while external effects remain explicitly false. This endpoint is account-scoped and never approves, rejects, executes, notifies, exports, issues secrets, writes token hashes, enables redirects, or creates customer-visible effects.

operations GET

operator_approvals

Read-only approval decision records created by review-packet decisions.

Path
/v1/operator-approvals
Terraform
linkridgecloud_operator_approval

Operator approval records are evidence only. Local-only approve/reject writes must use /v1/review-packets/{review_packet_id}/decision with acknowledgement evidence. The read model includes the accepted decision_requirements_fingerprint, normalized non-secret operator_evidence with linked resource type, resulting status, next required operator action, and skipped-effect flags, guardrail_evidence, and trimmed operator notes from file and Postgres backing stores; direct operator-approval writes stay disabled, and external execution still requires explicit Matthew approval.

operations PATCH

operator_account_billing

Operator-only no-charge billing control for the narrow MVP path.

Path
/v1/operator/accounts/{account_id}/billing
Terraform
linkridgecloud_account

Customer sessions cannot set no-charge billing. Operators may mark synthetic/local MVP accounts no_charge only when the account is scoped to the actor, external effects are disabled, and an Idempotency-Key is supplied; Stripe and other external billing-provider writes remain approval-gated.

operations POST

operator_open_qr_service_activation

Operator-only Open QR service activation once account billing guardrails are satisfied.

Path
/v1/operator/accounts/{account_id}/open-qr-service
Terraform
linkridgecloud_account_service

Customer sessions can read service requirements but cannot activate Open QR. Operators may activate the local Open QR service for scoped accounts after no-charge billing is satisfied; hosted redirects, customer-visible effects, and production deploys remain separately approval-gated.

operations POST

operator_account_cleanup

Operator-only soft cleanup for synthetic test tenants and users during MVP flow proof.

Path
/v1/operator/accounts/{account_id}/cleanup
Terraform
linkridgecloud_account

Cleanup requires account-scoped operator authorization, an Idempotency-Key, confirm_account_id matching the path account, and external effects disabled. It archives the account/service/QR records, revokes local sessions/invites, removes memberships, and disables orphan local users while preserving audit history; hard deletes and customer-visible cleanup remain blocked.

operations GET

audit_events

Append-only platform and service history for support, review, and compliance.

Path
/v1/audit-events
Terraform
linkridgecloud_audit_events

Agents should preserve audit_event_id returned by mutating calls.

future_primitives GET, POST

workflow_runs

Step Functions-like workflow executions, initially backed by n8n or a small native runner.

Path
/v1/workflows/runs
Terraform
linkridgecloud_workflow

Future primitive; keep API shape AWS-inspired and implementation pluggable.

future_primitives GET, POST

function_deployments

Lambda-like function packages for event or HTTP execution.

Path
/v1/functions
Terraform
linkridgecloud_function

Future primitive; beta scope depends on cluster capacity and isolation model.

future_primitives GET, POST

app_deployments

Vercel-like site/app deployment records with preview and production promotion states.

Path
/v1/deployments
Terraform
linkridgecloud_deployment

Future primitive; should reuse existing static-site deploy knowledge.

future_primitives GET, POST

object_buckets

S3-compatible bucket provisioning and account-scoped storage policy.

Path
/v1/storage/buckets
Terraform
linkridgecloud_bucket

Future primitive; prefer S3 compatibility over a custom storage API.