Docs
Add Surface
POST /surfaces
POST
/surfacesRequired Tokens
| Field | Type | Required | Description |
|---|---|---|---|
| Bearer | Authorization: Bearer <api-key> | Optional | Your API key. Pass it as the Bearer token on every request. |
Creates a new surface. Optionally links it to a raster map and/or scopes it to a specific area.
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
| name | string | Required | Display name for the surface. |
| description | string | Optional | Description of the surface. |
| rasterMapId | Guid? | Optional | ID of a raster map to link this surface to. Pass `null` for none. |
| areaId | Guid? | Optional | Area to scope this surface to. Pass `null` for event-wide. |
| exactLocation | string | Optional | Free-text description of the physical location. |
Response
Returns 201 Created with an empty body on success.