Dispatch Team

POST /v1/teams/dispatch

Requires dispatch:assign permission. Dispatching a team creates a mission, sets the team status to on_mission, fires the team.dispatched webhook, and records a billable operation.

Request Body

Field	Type	Required	Description
`event_id`	string	Yes	ID of the event to assign
`team_id`	string	Yes	ID of the team to dispatch
`notes`	string	No	Optional dispatch notes visible to the team
`event_lat`	number	No	Event latitude (improves route display)
`event_lng`	number	No	Event longitude (improves route display)

Example

curl -X POST https://api.wede.pt/v1/teams/dispatch \
  -H "x-wede-api-key: wede_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "event_id": "fbea1e0d-8f6b-42f5-bf9b-58fe77430f53",
    "team_id": "259edc6e-95f3-42ba-bac5-263cfe51ebc0",
    "notes": "Patient is conscious, use south entrance",
    "event_lat": 38.7169,
    "event_lng": -9.1395
  }'

Response

{
  "id": "7d154b16-c8ae-4da7-a949-5a97793c667e",
  "tenant_id": "9c145f7e-83be-4039-8e9c-650796acd3ee",
  "event_id": "fbea1e0d-8f6b-42f5-bf9b-58fe77430f53",
  "team_id": "259edc6e-95f3-42ba-bac5-263cfe51ebc0",
  "dispatched_by": "327739d2-79b6-4e10-8699-a1393e70dbb8",
  "dispatched_at": "2026-06-09T18:42:45.823Z",
  "notes": "Patient is conscious, use south entrance"
}

Dispatching a team automatically sets its status to on_mission and creates a mission record. The mission is closed (and the team returned to available) when the mission status reaches COMPLETED or FAILED.

Auto-Dispatch

When auto-dispatch is enabled for a tenant, the system automatically dispatches the highest-scored available team when an event arrives — without manual intervention.

Configure Auto-Dispatch

PATCH /v1/tenant/dispatch-settings

{
  "dispatch_mode": true,
  "dispatch_threshold": 0.20,
  "reinforcement_timeout_min": 10
}

Field	Type	Description
`dispatch_mode`	boolean	Enable or disable auto-dispatch
`dispatch_threshold`	number (0–1)	Minimum score required for auto-dispatch
`reinforcement_timeout_min`	integer	Minutes before auto-reinforcement (0 = disabled)

Threshold Values

Threshold	Value	Behaviour
Low	`0.10`	Dispatch any available team
Medium	`0.20`	Team must be well positioned
High	`0.40`	Only the best-matched team

When no team meets the threshold, the response includes requires_manual: true and the supervisor is alerted.

Auto-Reinforcement

If a dispatched team does not acknowledge (ACK) a mission within reinforcement_timeout_min minutes, the system automatically dispatches the next best available team. Set to 0 to disable.

Manual Override

Supervisors can always override auto-dispatch and manually select any available team from the Dispatch Console, regardless of score.

SDK

// Direct dispatch
await client.dispatch({
  event_id: 'uuid',
  team_id: 'uuid',
  event_lat: 38.7169,
  event_lng: -9.1395,
  notes: 'Optional notes'
})

// Update dispatch settings
await client.updateDispatchSettings({
  dispatch_mode: true,
  dispatch_threshold: 0.20,
  reinforcement_timeout_min: 10
})

// Request backup for active mission
await client.requestBackup({
  mission_id: 'uuid',
  event_id: 'uuid',
  event_lat: 38.7169,
  event_lng: -9.1395
})

Overview

Authentication

Events

Teams & Dispatch

Missions

Zones

Billing

Tenant

Webhooks

Sync

Connectivity

Parsers

Onboarding

POST /v1/teams/dispatch

Request Body

Example

Response

Auto-Dispatch

Configure Auto-Dispatch

Threshold Values

Auto-Reinforcement

Manual Override

SDK

​POST /v1/teams/dispatch

​Request Body

​Example

​Response

​Auto-Dispatch

​Configure Auto-Dispatch

​Threshold Values

​Auto-Reinforcement

​Manual Override

​SDK

POST /v1/teams/dispatch

Request Body

Example

Response

Auto-Dispatch

Configure Auto-Dispatch

Threshold Values

Auto-Reinforcement

Manual Override

SDK