Team members

Members are the people of a team. Their status and reported location feed the dispatch score.

Authentication

All member endpoints need a session token (Authorization: Bearer <token>).

Operation	Permission	Tenant roles with it
Add, remove, change status, link a user	`teams:manage`	`company_admin`, `company_tech`
Update member location	`teams:view` or `missions:receive`	`company_admin`, `company_tech`, `operational_supervisor`, `corporate_client`; `field_operator` for their own member only

The integration API key (x-wede-api-key) has no teams:* permission. Calls with an API key return 403 forbidden.

Add a member

POST /v1/teams/{id}/members

string

required

Team UUID.

string

required

2 to 100 characters.

string

required

Your own role label, 2 to 50 characters, for example PARAMEDIC.

string

default:"available"

available, on_mission or offline.

number

Initial latitude.

number

Initial longitude.

string

UUID of a wede user of your tenant to link to this member.

If you send no coordinates and the team has a home zone, the member starts at the centre of that zone.

curl -X POST https://api.wede.pt/v1/teams/259edc6e-95f3-42ba-bac5-263cfe51ebc0/members \
  -H "Authorization: Bearer YOUR_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Ana Costa", "role": "PHYSICIAN" }'

Response 201

{
  "id": "0b7e5d1c-3a2f-4e8b-9c6d-1f2e3a4b5c6d",
  "team_id": "259edc6e-95f3-42ba-bac5-263cfe51ebc0",
  "tenant_id": "9c145f7e-83be-4039-8e9c-650796acd3ee",
  "name": "Ana Costa",
  "role": "PHYSICIAN",
  "status": "available",
  "lat": 38.7169,
  "lng": -9.1399,
  "last_seen": "2026-06-09T18:00:00.000Z",
  "user_id": null,
  "created_at": "2026-06-09T18:00:00.000Z",
  "updated_at": "2026-06-09T18:00:00.000Z"
}

Status	`error`	When
`400`	`validation_error`	The body does not match the schema, or `user_id` does not exist.
`403`	`forbidden`	Your role lacks `teams:manage`, or the `user_id` belongs to another tenant.

Remove a member

DELETE /v1/teams/{id}/members/{memberId}

Returns 204 with no body.

curl -X DELETE https://api.wede.pt/v1/teams/259edc6e-95f3-42ba-bac5-263cfe51ebc0/members/0b7e5d1c-3a2f-4e8b-9c6d-1f2e3a4b5c6d \
  -H "Authorization: Bearer YOUR_SESSION_TOKEN"

Change member status

PATCH /v1/teams/{id}/members/{memberId}/status

string

required

available, on_mission or offline.

Also sets the member’s last_seen to now.

curl -X PATCH https://api.wede.pt/v1/teams/259edc6e-95f3-42ba-bac5-263cfe51ebc0/members/0b7e5d1c-3a2f-4e8b-9c6d-1f2e3a4b5c6d/status \
  -H "Authorization: Bearer YOUR_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "status": "offline" }'

Response 200

{ "id": "0b7e5d1c-3a2f-4e8b-9c6d-1f2e3a4b5c6d", "status": "offline" }

Status	`error`	When
`400`	`validation_error`	`status` is not one of the allowed values.

Link a user to a member

PATCH /v1/teams/{id}/members/{memberId}/user

Links a wede user account of your tenant to the member. Sending a new user_id replaces the previous link.

string

required

UUID of the user.

curl -X PATCH https://api.wede.pt/v1/teams/259edc6e-95f3-42ba-bac5-263cfe51ebc0/members/0b7e5d1c-3a2f-4e8b-9c6d-1f2e3a4b5c6d/user \
  -H "Authorization: Bearer YOUR_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "user_id": "327739d2-79b6-4e10-8699-a1393e70dbb8" }'

Response 200

{ "id": "0b7e5d1c-3a2f-4e8b-9c6d-1f2e3a4b5c6d", "user_id": "327739d2-79b6-4e10-8699-a1393e70dbb8" }

Status	`error`	When
`400`	`validation_error`	`user_id` is missing.
`404`	`not_found`	No such member in this team of your tenant.

Update member location

PATCH /v1/teams/{id}/members/{memberId}/location

Reports the current position of a member. Sets lat, lng and last_seen. A field_operator (no teams:view) can update only the member linked to their own user account; any other member returns 403 forbidden. Use the intervals from Location config to decide how often to send it.

number

required

Latitude, from -90 to 90.

number

required

Longitude, from -180 to 180.

curl -X PATCH https://api.wede.pt/v1/teams/259edc6e-95f3-42ba-bac5-263cfe51ebc0/members/0b7e5d1c-3a2f-4e8b-9c6d-1f2e3a4b5c6d/location \
  -H "Authorization: Bearer YOUR_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "lat": 38.7302, "lng": -9.1511 }'

Response 200

{
  "id": "0b7e5d1c-3a2f-4e8b-9c6d-1f2e3a4b5c6d",
  "lat": 38.7302,
  "lng": -9.1511,
  "last_seen": "2026-06-09T18:40:00.000Z"
}

Status	`error`	When
`400`	`validation_error`	`lat` or `lng` is missing, not a number or out of range.
`403`	`forbidden`	A `field_operator` tried to update a member that is not linked to their own user.

Errors on every member endpoint

Status	`error`	When
`401`	`unauthorized`	Missing, invalid or expired credentials.
`403`	`forbidden`	Your role lacks the permission, or you used an API key.
`404`	`not_found`	The team is not a team of your tenant.
`500`	`internal_error`	Unexpected server error.

SDKs

updateMemberLocation in JavaScript, update_member_location in Python.

Overview

Authentication

Events

Teams & Dispatch

Missions

Zones

Billing

Tenant

Webhooks

Sync

Policies

Connectivity

Sandbox

Parsers

Onboarding

Authentication

Add a member

Remove a member

Change member status

Link a user to a member

Update member location

Errors on every member endpoint

SDKs

​Authentication

​Add a member

​Remove a member

​Change member status

​Link a user to a member

​Update member location

​Errors on every member endpoint

​SDKs

Authentication

Add a member

Remove a member

Change member status

Link a user to a member

Update member location

Errors on every member endpoint

SDKs