Agent flow
Create intent, scan the market, hold, prepay, dispatch.
The right API story is procedural and reliable. The sequence should be clear in seconds.
Developers
Emergency capacity API built for agents that need to procure freight fast.
Built as part of the same premium system while staying precise enough for engineers and AI agents. It shows how Warp can be called programmatically when time and budget constraints are real.
1,500+
active lanes
50+
cross-docks
27%
lower freight costs
Use this API when an autonomous or human workflow needs to create an emergency intent, evaluate offers, and dispatch freight quickly.
Keep the developer story tied to the same Warp logic: speed, control, density, and lower operational friction.
Make the page machine-readable and human-readable without sacrificing clarity for either audience.
What to expect
Here's what changes.
Procurement control
Budget and time constraints stay explicit.
The system helps agents move quickly without losing control over budget caps, SLAs, and state transitions.
Platform signal
Warp is not only a website. It is an operating system.
A strong developer page helps buyers and partners see that Warp can be embedded directly into live workflows.
The Warp approach
How it works.
01
State machine clarity
Keep statuses, intent flow, and write operations explicit so automation can act with confidence.
02
Machine-readable assets
Expose JSON schemas, prompt packs, and LLM index files so AI systems can retrieve the right context fast.
03
Human review path
Make it easy for technical teams to escalate into a live API review when procurement logic gets more complex.
Agent quickstart
Execution loop
- Create an emergency intent with shipment and constraints.
- Poll until offers are available.
- Select and hold the best compliant offer.
- Prepay, then dispatch.
Status values
Agent state machine
CREATEDSCANNING_MARKETOFFERS_AVAILABLEHOLD_PLACEDPREPAY_PENDINGPREPAIDBOOKEDDISPATCHEDFAILEDEXPIRED
Machine files
AI-ready assets
Endpoint contract
POST
/v1/emergency-capacity/intents
Create emergency intent and start market scan.
GET
/v1/emergency-capacity/intents/{intent_id}
Get status and live offers.
POST
/v1/emergency-capacity/intents/{intent_id}/hold
Hold selected offer for a short window.
POST
/v1/emergency-capacity/intents/{intent_id}/prepay
Authorize or capture payment instantly.
POST
/v1/emergency-capacity/intents/{intent_id}/dispatch
Finalize booking and dispatch shipment.
Minimal create-intent JSON
{
"external_request_id": "agent-req-2026-03-02-0001",
"mode": "LTL",
"shipment": {
"pickup": {
"postal_code": "60601",
"country": "US",
"window_start": "2026-03-03T14:00:00Z",
"window_end": "2026-03-03T16:00:00Z"
},
"dropoff": {
"postal_code": "30301",
"country": "US"
},
"commodity": "Consumer packaged goods",
"weight_lbs": 1200,
"pallets": 2
},
"constraints": {
"must_pickup_by": "2026-03-03T17:00:00Z",
"max_total_usd": 850
},
"payment": {
"mode": "CAPTURE_FULL",
"payment_method_id": "pm_12345"
}
}System prompt
You are WarpEmergencyCapacityAgent.
Objective: procure emergency freight capacity with strict budget and time constraints.
Always follow this loop:
1) Create intent
2) Poll status until OFFERS_AVAILABLE
3) Select best offer that passes constraints
4) Hold offer
5) Prepay
6) Dispatch
Hard rules:
- Never exceed max_total_usd
- Never skip hold before prepay
- Always send Idempotency-Key on write operations
- Escalate to human if status is FAILED or EXPIREDTask template
Given shipment details and constraints:
1) Build create-intent payload
2) Choose best offer by (price, pickup SLA, risk_flags, confidence_score)
3) Execute hold -> prepay -> dispatch
4) Return a final JSON report:
{
"intent_id": "...",
"offer_id": "...",
"payment_id": "...",
"shipment_id": "...",
"total_charge_usd": 0,
"status": "DISPATCHED",
"notes": []
}Related
Keep exploring.
Next step
Ready to move freight?
Start shipping today or talk to our team about a custom solution.