Grid Production

Apply the exact confirmed participant preview with unchanged people, preview_time, expected_revision and stable request_id. Requires grid:write. Revalidates source, project access, referenced members and complete participant snapshot under locks; expired or stale plans reject atomically. Identical retries return the durable receipt. Contact and position-only participants remain unchanged. Project members retain saved position metadata. No provider calls, Zoom, email or calendar sync; invitations require a separate reviewed workflow. Existing Google-linked events use grid.preview_linked_calendar_participants then grid.apply_linked_calendar_participants.

grid.apply_calendar_participants

Atomically save the reviewed commitment and receipt. Requires grid:write, explicit confirmation, identical values, expected_revision from preview and a request UUID. Changed state or intent requires a new preview. Retry identical request_id for the original result. No attachment, signing, share or payment changes.

grid.apply_commitment_create

Atomically save the exact confirmed commitment-item preview, type-specific amounts and durable receipt. Requires grid:write, identical changes/link UUIDs, expected_revision, stable request_id and confirm_preview=true. Changed sources, memberships, fees or project access require another preview. Identical retries return the saved receipt. Preserves bid membership, Estimate baseline, source/coding/phase/classification and lifecycle; no sending, client approval, signing, invoicing or payment.

grid.apply_commitment_items

Apply exactly the reviewed number-correction step. Requires grid:write, explicit confirmation, expected_revision, decision_at from preview and identical request_id/intent. Stale decisions require another preview. Records an auditable approved suffix or corrected-document reference; never silently changes an issued number or sends a document.

grid.apply_commitment_number_correction

Atomically save exactly the reviewed changes to an existing commitment header. Requires grid:write, explicit confirmation, identical values, expected_revision and request_id. Stale intent or state requires a new preview. Identical retries return the original receipt. Preserves type, currency and number; no attachment, signing, share or payment changes.

grid.apply_commitment_update

Apply only the exact user-confirmed stored preview with grid:write and confirm_preview=true. Atomically rechecks authority, revision and expiry and updates subject/body only. Reuse BOTH preview_id and request_id after a timeout or uncertain response; a durable receipt replays without repeating the edit or overwriting later changes. Never generate a replacement request to resolve uncertainty. Different previews cannot reuse a request ID. No sending, bookings, invitations or permission changes.

grid.apply_message_template_update

Apply only the exact confirmed stored availability preview using grid:write and confirm_preview=true. Rechecks current project/contact and correction authority and state atomically; stale, expired or conflicting previews do not write. Reuse request_id after timeouts: durable receipts replay saved row identities without overwriting subsequent edits. Verify using get_entity_availability with entity_type=contact. Preserves other dates and all booking/calendar overlays. No outreach, invitations, requests, bookings or provider synchronization.

grid.apply_contact_availability_update

Apply only the confirmed stored contact edit, including legacy notes-only previews. Requires grid:write and current note authorization. Pass confirm_preview=true, preview_id and a fresh request_id UUID; retain request_id for retries. Rejects stale/expired previews; preview and confirm again. Exact retries return the original durable receipt without overwriting subsequent edits. The receipt includes saved contact details; notes-only edits can be verified with grid.get_contact_notes. Network-only MCP; the Crew/Talent Notes UI continues to save locally offline.

grid.apply_contact_update

Apply only the stored preview from grid.preview_create_contact after explicit confirmation. Requires grid:write, preview_id, request_id and confirm_preview=true. Rechecks access and revision and applies atomically. Preserve request_id on retries; exact retries return the original receipt.

grid.apply_create_contact

Create new project cost details, optionally with initial budget memberships and explicit line allocations. Never edits an existing detail. Spreadsheet rows preserve provenance, duplicate decisions and source-total reconciliation. Apply only the unchanged input confirmed from grid.preview_create_details. Requires grid:write, expected_revision, request_id and confirm_preview=true. Writes atomically, rejects changed intent or stale state and returns the original receipt for exact retries.

grid.apply_create_details

Apply only after explicit user confirmation of the complete preview. Supply its preview_id, the same project_id, confirm_preview=true and a fresh request_id UUID. The server applies the stored exact plan atomically and rejects stale state. Identical retries return a receipt. Network-only MCP action; normal UI editing remains local-first. If declined or cancelled, do not apply.

grid.apply_deliverable_edits

Atomically append the exact confirmed project deliverables preview. Requires grid:write, confirm_preview=true, expected_revision from preview and a fresh request_id UUID. Identical retries return the receipt without duplicates. Changed project state or changed proposed content requires a new preview and confirmation. Network-only import; saved project deliverables and linked category-count globals sync to Grid for normal offline editing. Category counts update automatically in the same transaction; no separate globals creation call is needed.

grid.apply_deliverables_import

Apply the exact reviewed public location merge preview. Requires grid:write, confirm_preview=true, and a fresh request_id UUID. The server rechecks admin authority, the location revision and all normal directory merge guards. Expired or changed previews must be reviewed again. Exact request retries return the saved receipt. The merge moves children and non-conflicting linked records; overlapping stage specifications remain on the retired duplicate for audit. The merge cannot be undone from the merge screen.

grid.apply_location_merge

Apply the exact stored preview after explicit user confirmation. Requires grid:write. Keep request_id for retries; changed source or reviewed work requires a fresh preview. The complete batch and receipt commit atomically. Returns durable review links. Saving drafts never confirms requirements, links assets, or invokes Grid-hosted inference.

grid.apply_document_breakdown_drafts

Apply the exact stored preview after explicit user confirmation. Requires grid:write. Keep request_id for retries; changed source or reviewed work requires a fresh preview. The complete batch and receipt commit atomically. Returns durable review links. Saving drafts never confirms requirements, links assets, or invokes Grid-hosted inference.

grid.apply_document_breakdown_workspaces

Attach the exact user-confirmed image/PDF batch to one existing authorized entity. Requires grid:write, preview_id, confirm_preview=true and an unchanged idempotency_key. Copies approved files into Grid-owned storage, then atomically records their media/document attachments; duplicate decisions and ordering are bound to the reviewed preview. Local files require the identical retained bytes. Returns attachment IDs, file-copy outcomes, pending-review status and retry/cleanup information. Does not create, edit or delete photo sets or group photos. Exact retries reuse the committed receipt.

grid.apply_entity_attachments

Atomically apply the exact confirmed Estimate-to-Running preview, including copied pricing/details, immutable baseline, Estimate lock and primary-bid selection. Requires grid:write, confirm_preview=true, identical intent, expected_revision and request_id UUID. Stale dependencies or changed intent require a new preview and confirmation. Identical request_id retries return the original receipt without another copy. Read results with grid.get_budget_overview and grid.get_bid_settings. Does not publish a share.

grid.apply_estimate_to_running

Apply the exact confirmed financial document preview in one transaction. Requires grid:write, unchanged proposal, completeness, preview_time, expected_revision, locally recomputed reviewed_output_digest and confirm_preview=true. Never apply from an incomplete preview page. Retain request_id for identical retries and durable receipts. Rechecks project/source/file/target access and revision under locks. Blocked previews cannot apply. Preserves prior evidence and reviewed payable status; never creates payments or bank matches. Explicit actualizations choices link imported Actuals to unreviewed Running costs through the shared lineage planner; omitted choices leave projections open. A reviewed forecast defers legacy matching with a visible preview warning while preserving cost capture and its existing decision; reconcile the saved Actual separately using forecast context/preview/apply.

grid.apply_financial_document_import

Apply the exact confirmed forecast preview atomically with grid:write. Requires unchanged selection/decision, preview_time, expected_revision, stable UUID request_id and confirm_preview=true. Rechecks current access, scope/source data and bid eligibility. Identical retries return the original receipt. Does not recreate Actuals, alter historical phases, approve invoices or execute payments.

grid.apply_forecast_reconciliation

Apply the exact user-confirmed stored Inbox ignore/restore preview. Requires grid:write, preview_id, revision, request_id and confirm_preview=true. Rechecks company/project access, source/routing state and expiry atomically; identical actor-bound retries return the original receipt. No receipt import, return matching, AP or payment changes.

grid.apply_document_inbox_disposition

Apply only the stored preview from grid.preview_link_company_contact after explicit confirmation. Requires grid:write, preview_id, request_id and confirm_preview=true. Rechecks access and revision and applies atomically. Preserve request_id on retries; exact retries return the original receipt.

grid.apply_link_company_contact

Apply only the stored preview from grid.preview_link_contact_representative after explicit confirmation. Requires grid:write, preview_id, request_id and confirm_preview=true. Rechecks access and revision and applies atomically. Preserve request_id on retries; exact retries return the original receipt.

grid.apply_link_contact_representative

Apply only the stored preview from grid.preview_link_project_contact after explicit confirmation. Requires grid:write, preview_id, request_id and confirm_preview=true. Rechecks access and revision and applies atomically. Preserve request_id on retries; exact retries return the original receipt.

grid.apply_link_project_contact

Start or resume one separately confirmed location batch using its unchanged apply_id and confirm_preview=true. Returns processing promptly while bounded background passes prepare approved media and checkpoint rows. Poll grid.get_location_import_batch_status; when resumable or a running lease_expires_at has passed, repeat this exact approved action. One final parent-first transaction commits all business rows and receipts together. Processing is not proof of commit. When receipts are applied, repeat the unchanged action to recover per-row IDs and media status with current resource access checks; exact retries never copy committed media again. The plan may create/update locations and technical details, create/reuse captured contacts and companies, link them to locations and optionally a project. Stale authority/evidence/capacity failures enter fenced checkpointed cleanup and require fresh review; retained rows preserve facts and parent links. Legacy signed rows resolve to one stable handle without extending approval expiry. Transport errors never prove rollback. Requires grid:write and current authority. Does not import PDFs; preview/confirm those separately with grid.preview_entity_attachments after recovering the Location IDs.

grid.apply_location_import_batch

Create the exact confirmed manual expense and optional budget allocations atomically with grid:write. No document or transaction is required. Retain expense_id and request_id after timeouts; exact retries return the original durable receipt, including after preview expiry. Rechecks current project, vendor, currency, source-budget and absence preconditions. Does not create payments, payables, documents or bank links.

grid.apply_manual_expense

Apply the exact confirmed manual timecard preview atomically. Requires grid:write, confirm_preview=true, unchanged input/preview_time/expected_revision and stable request_id. Reuse request_id for identical retries. Preserves restored identity. No AP, payments, payroll execution or sending.

grid.apply_manual_time_card

Apply the exact confirmed project contact export preview with confirm_preview=true and a stable request_id UUID. Rechecks account ownership, current project access, Google Contacts permission and unchanged settings. Stale or expired previews require a fresh preview and confirmation. Exact retries return the saved receipt. Saves the opt-in and lets normal scheduled reconciliation process eligible contacts; does not run a manual sync or assert delivery. Disable preserves provider contacts and uses normal managed-group cleanup.

grid.apply_project_contact_sync

Create the confirmed project and Main Unit atomically through the same guarded operation as POST /api/v1/projects. Pass identical company_id, name and code plus expected_revision from preview, confirm_preview=true and a fresh request_id UUID. Changed input requires another preview and confirmation. Keep request_id and input unchanged on retries; the durable receipt returns the original project without duplication. Rechecks the live OAuth grant and company administration. No bid, budget, deliverables or Credits workspace is created. Returns the project UUID for grid.get_project and grid.preview_project_update.

grid.apply_project_create

Apply only the exact confirmed stored crew-status preview with grid:write and confirm_preview=true. No changed intent is accepted. Rechecks current project/company access, active membership, Crew references and stale state, atomically updates assignments and returns saved membership/status labels with a durable receipt. Reuse the same request_id for retries, including after a timeout; replay returns the original receipt without overwriting later edits. Verify with list_project_contacts or get_project_contact. No outreach, rates or financial changes.

grid.apply_project_crew_status_update

Atomically create the new global from the exact confirmed create preview and save its dependent effects and durable receipt. Requires grid:write, confirm_preview=true, expected_revision and request_id UUID. Identical retries return the saved receipt; changed intent or dependencies require a fresh preview. Regenerate any pending budget-item/detail preview and obtain separate confirmation after this write.

grid.apply_create_project_global

Atomically update the existing global from the exact confirmed update preview and save its dependent effects and durable receipt. Requires grid:write, confirm_preview=true, expected_revision and request_id UUID. Identical retries return the saved receipt; changed intent or dependencies require a fresh preview. Regenerate any pending budget-item/detail preview and obtain separate confirmation after this write.

grid.apply_update_project_global

Apply only the confirmed saved preview. Requires grid:write and confirm_preview=true. Rechecks project access, location identity, linked-record availability and stale state; updates all requested fields atomically. Keep request_id unchanged for retries; exact retries return the receipt. No changes may be supplied at apply.

grid.apply_project_location_update

Apply the confirmed stored project update preview. Requires grid:write, confirm_preview=true, preview_id and request_id UUID. Keep request_id unchanged for retries. Rechecks project and linked-record permissions and rejects stale or expired previews. Rejects unsupported project-backed unit-name effects. Exact retries return the saved receipt. Unarchive requires a new preview and confirmation. Database failures roll back project metadata, client membership and receipt together. Client updates preserve invoice bill-to overrides and issued snapshots.

grid.apply_project_update

Atomically accept the exact confirmed receipt expense preview with grid:write. Preserve input, preview_time and expected_revision; retain request_id for durable retries. Rechecks source and project access under locks. Creates/reuses vendors and costs, links receipt evidence and completes Inbox items together. Never creates payments, AP or additional files; existing card matches remain unchanged.

grid.apply_receipt_expenses

Remove explicitly selected budget memberships or line allocations from existing project details. Preserves unselected links and detail values. automatic_running_review reports each source bid independently: skip_collapsed suppresses the automatic question; eligible still needs a new target and fresh scope/finality checks; unavailable must be resolved. No default Running decision. Supports existing Actuals without copying rows, moving phases or editing prices; derived composite impacts are included. Actual allocations total 100% across all budgets; Estimate/Running allocations total 100% per budget. Apply only the unchanged input confirmed from grid.preview_remove_detail_budget_links. Requires grid:write, expected_revision, request_id and confirm_preview=true. Writes atomically, rejects changed intent or stale state and returns the original receipt for exact retries.

grid.apply_remove_detail_budget_links

Apply only the stored preview from grid.preview_remove_contact_representative after explicit confirmation. Requires grid:write, preview_id, request_id and confirm_preview=true. Rechecks access and revision and applies atomically. Preserve request_id on retries; exact retries return the original receipt.

grid.apply_remove_contact_representative

Replace all budget memberships and line allocations of existing project details with the explicit selected links. An empty budgets list detaches all links. Preserves detail values. automatic_running_review reports each source bid independently: skip_collapsed suppresses the automatic question; eligible still needs a new target and fresh scope/finality checks; unavailable must be resolved. No default Running decision. Supports existing Actuals without copying rows, moving phases or editing prices; derived composite impacts are included. Actual allocations total 100% across all budgets; Estimate/Running allocations total 100% per budget. Apply only the unchanged input confirmed from grid.preview_replace_detail_budget_links. Requires grid:write, expected_revision, request_id and confirm_preview=true. Writes atomically, rejects changed intent or stale state and returns the original receipt for exact retries.

grid.apply_replace_detail_budget_links

After explicit confirmation of the stored recipient changes and notification effects, apply only preview_id plus its exact expected_revision with stable request_id and confirm_preview=true. Requires grid:read and grid:write. Atomically saves/rechecks Grid participants, then permits at most one conditional attendee/private-marker PATCH to the bound existing Google event with sendUpdates=all. Never creates/moves an event, adds conferencing or edits other fields. Notification request is not proof of email arrival. Lost/uncertain outcomes retry only readback of the same operation; retain the exact IDs and never bypass pending work with a new operation. Reports saved-local, pending/uncertain/failed/succeeded and fresh state separately from historical completion agreement. Access loss blocks private disclosure. Local undo does not retract notifications; a changed proposal requires a new reviewed preview.

grid.apply_linked_calendar_participants

Apply only the exact confirmed saved staffing preview with grid:write, preview_id, revision, a stable request_id and confirm_preview=true. Does not accept changed intent. Rechecks active project access and the complete board dependencies under canonical admission and database predicate locks, including empty sets; changed/expired previews require review again. All booking/exclusion/placement operations and the durable receipt commit atomically through the audited writer. Reuse the same request_id after timeouts: identical retries replay original saved readback without overwriting later edits. Busy state is retryable with unchanged IDs; uncertain outcomes must be reconciled before changing them. Returns original saved_board; get_staffing_board reads current state. No messages, provider events, roster creation, rates or financial commitments.

grid.apply_staffing_board_changes

Import up to 200 reviewed talent rows into an authorized project after confirm_preview=true and grid:write. Requires the original text and unchanged fingerprinted contact create/reuse decisions; rechecks matches and permissions. One atomic transaction creates or reuses contacts, adds talent project memberships and saves supplied contact channels and production profile fields (stage name, biography, sex, age range, height, weight and clothing measurements), updating existing detail fields when applicable. Returns contact and membership IDs, exclusions and counts. Does not rank people or make casting decisions.

grid.apply_talent_import