Skip to content
Maglev docs

Action reference

The published API exposes 23 action kinds. Request an action on a saved project through POST /projects/{id}/actions or maglev actions request. Start with the workflow guide.

Read availability first

Section titled “Read availability first”
  • Available: the action is registered and can produce its supported output. Check any provider-specific availability in the result.
  • Coordinated: the action opens work for a person or partner; it does not mean the physical work is done.
  • Planned: the required execution path is not available. Lifecycle stages may be planned even when nearby actions exist.

Document outputs remain drafts. Delivery drafts need separate approval before dispatch, and sandbox keys cannot send. No action here signs an agreement, approves a physical sample or places a manufacturing order.

Discovery and agreements

Section titled “Discovery and agreements”
Action Availability What it returns
NDA draft available Draft agreement text, entity blanks and review notes.
Strategy session brief available Session agenda, cost decisions and founder questions.
Engineering estimate available Draft work breakdown, hour ranges, assumptions and risks.
Statement of work draft available Scope, deliverables, acceptance criteria and project gates.

Engineering and readiness

Section titled “Engineering and readiness”
Action Availability What it returns
PRD draft available Requirements, acceptance criteria and unresolved details.
Architecture review available Subsystem/process map and technical risk flags.
DFM review available Part-level manufacturability findings and cited process constraints.
Test plan available EVT, DVT and PVT test plans and fixture requirements.
NPI plan available Tooling, supply-chain and line-setup workstreams.
Quality plan available Inspection points, sample gates and pack-out checks.
Production readiness review available Evidence-backed pass, gap or unknown checklist.
Production cost estimate available Cost drivers and known quoted ranges; missing prices remain unknown.

Quotes and factory coordination

Section titled “Quotes and factory coordination”
Action Availability What it returns
Request quotes available Factory shortlist and bilingual RFQ delivery drafts.
Record a quote available Structured price breaks and terms from a supplied factory reply.
Negotiate a quote available Negotiation strategy and bilingual message drafts.
Ask for priority available A draft request for schedule priority.
Check progress available A draft progress request and evidence checklist.

Shipping and compliance

Section titled “Shipping and compliance”
Action Availability What it returns
Shipping estimate available Chargeable weight, freight ranges and source references.
Landed cost available A planning range for freight, duties and fees with exclusions and unknowns.
Customs profile available Tariff candidates, a document checklist and a draft summary.
Compliance path available A product-specific planning table and draft explanation.
Shipment tracking available Provider events when available, otherwise an explicit availability status.
Freight booking coordinated A coordinated freight-booking task and planning estimate.

Current schemas

Section titled “Current schemas”

GET /actions/kinds returns the runtime registry with inputSchema and outputSchema. The OpenAPI download also includes action schemas under x-action-kinds. Read the current registry when choosing a kind, and keep its schema with your integration.