---
title: "Add sites to mission"
method: POST
path: "/missions/{missionId}/sites"
tags: ["Missions"]
---

# Add sites to mission

`POST /missions/{missionId}/sites`

Adds sites to an existing mission. The server expands cluster IDs into individual sites, creates SiteVisit rows for each new site, and creates or updates ClusterVisit records. Sites already in the mission are ignored.

## Headers

- `Idempotency-Key` string, uuid

## Request body

- MissionSitesRequest
  - `siteIds` string[]
  - `clusterIds` string[]

## Response `200`

Success

- object
  - `data` Mission, required
    - `id` string, uuid, required
    - `organizationId` string, uuid, required
    - `name` string, required
    - `description` string, required
    - `status` 'scheduled' | 'canceled' | 'in-progress' | 'recurring' | 'complete', required
    - `detailLevel` 'low' | 'medium' | 'high', required
    - `sensors` SensorRequirements, required
      - `camera` 'hi-def' | 'any' | 'no', required
      - `lidar` 'yes' | 'no' | 'any', required
      - `thermal` '640x480' | 'any' | 'no', required
    - `createdAt` number, required
    - `scheduledFor` number, required
    - `estimatedCompletionTime` number, required
    - `dueDate` number
    - `recurrence` 'daily' | 'weekly' | 'monthly' | 'yearly'
    - `estimatedCost` number, required
    - `siteGeometries` string[]
    - `siteCount` integer, required — Total number of active site visits in this mission
    - `bounds` number[], nullable — Bounding box of all active site geometries in this mission, as [minLng, minLat, maxLng, maxLat]. Null when the mission has no active site visits.
    - `deletedAt` number, nullable, required
    - `updatedAt` number, required
  - `transactionId` string, uuid, required

## Other responses

- `400` — Bad request or validation error
- `401` — Authentication required
- `403` — Insufficient permissions
- `404` — Resource not found
- `429` — Rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.net/voltairlabs/apis/voltair-api.md) · [All operations](https://skmtc.net/voltairlabs/apis/voltair-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/voltairlabs/voltair-api/revisions/be08f4f706f5/schema)