All agent, UI, CLI, MCP, and Terraform clients should converge on this control-plane contract.
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.
The repo now keeps an OpenAPI skeleton aligned with these paths before backend, SDK, and provider work grows from it.
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 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
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 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
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
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
services
Catalog of LinkRidge Cloud services and lifecycle state.
- Path
- /v1/services
- Terraform
- linkridgecloud_service
Read-only discovery endpoint for agent service selection.
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.
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.
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_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_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_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_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_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_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_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_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_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_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_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_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_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_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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.
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.