Create a dock

`POST /api/docks`

Gate: session
Read-only: false
Destructive: false
Idempotent: false

Request body

Property	Type	Required	Constraints	Description
`name`	`string`	yes	maxLength: 200
`address`	`string`	yes	maxLength: 300
`latitude`	`number`	yes	minimum: -90; maximum: 90
`longitude`	`number`	yes	minimum: -180; maximum: 180
`pricePerMinute`	`number`	yes	minimum: 0; maximum: 100000
`accessMode`	`string`	no	enum: private, shared, open; default: “open”	Closed set; unrecognized values are rejected. Governs which network the dock lands on.

Example

{
  "name": "Rooftop Alpha",
  "address": "123 Main St",
  "latitude": 37.7749,
  "longitude": -122.4194,
  "pricePerMinute": 2.5,
  "accessMode": "open"
}

Responses

`201` — The created dock.

Property	Type	Required	Constraints	Description
`id`	`string`	no	—
`callsign`	`string`	no	—	Two-word callsign: the stored slug for real docks, derived from the id for synthetic rows.
`name`	`string`	no	—
`rooftop`	`object`	no	—	The dock’s Site (legacy name retained).
`latitude`	`number`	no	—
`longitude`	`number`	no	—
`status`	`string`	no	—	Open set; stored status only, not derived from live occupancy.
`pricePerMinute`	`number`	no	—
`createdAt`	`string`	no	format: date-time
`earningsToDate`	`number`	no	—	Always 0 until the v2 booking backend lands.

`rooftop`

Property	Type	Required	Constraints	Description
`id`	`string`	no	—
`address`	`string`	no	—

`400` — name/address/latitude/longitude/pricePerMinute/accessMode failed validation.

Property	Type	Required	Constraints	Description
`type`	`string`	yes	format: uri-reference
`status`	`integer`	yes	—
`title`	`string`	yes	—
`detail`	`string`	no	—
`instance`	`string`	no	—
`code`	`string`	yes	—
`field`	`string`	no	—
`error`	`string`	no	—	Legacy-compat mirror of `detail` (or `title` when no `detail` is given), added by apiProblemResponse (lib/problem.ts) so pre-C2 consumers reading `.error` off a live route’s error body keep working unmodified.
`documentation_url`	`string`	no	—
`request_id`	`string`	no	—

`401` — Not signed in.

Property	Type	Required	Constraints	Description
`type`	`string`	yes	format: uri-reference
`status`	`integer`	yes	—
`title`	`string`	yes	—
`detail`	`string`	no	—
`instance`	`string`	no	—
`code`	`string`	yes	—
`field`	`string`	no	—
`error`	`string`	no	—	Legacy-compat mirror of `detail` (or `title` when no `detail` is given), added by apiProblemResponse (lib/problem.ts) so pre-C2 consumers reading `.error` off a live route’s error body keep working unmodified.
`documentation_url`	`string`	no	—
`request_id`	`string`	no	—

`403` — Demo mode is read-only, or the caller is not an admin of any org.

Property	Type	Required	Constraints	Description
`type`	`string`	yes	format: uri-reference
`status`	`integer`	yes	—
`title`	`string`	yes	—
`detail`	`string`	no	—
`instance`	`string`	no	—
`code`	`string`	yes	—
`field`	`string`	no	—
`error`	`string`	no	—	Legacy-compat mirror of `detail` (or `title` when no `detail` is given), added by apiProblemResponse (lib/problem.ts) so pre-C2 consumers reading `.error` off a live route’s error body keep working unmodified.
`documentation_url`	`string`	no	—
`request_id`	`string`	no	—

`429` — Too many requests from this IP.

Property	Type	Required	Constraints	Description
`error`	`string`	no	—

Get started

API Reference

Errors

`POST /api/docks`

Request body

Example

Responses

`201` — The created dock.

`rooftop`

`400` — name/address/latitude/longitude/pricePerMinute/accessMode failed validation.

`401` — Not signed in.

`403` — Demo mode is read-only, or the caller is not an admin of any org.

`429` — Too many requests from this IP.

Errors

​POST /api/docks

​Request body

​Example

​Responses

​201 — The created dock.

​rooftop

​400 — name/address/latitude/longitude/pricePerMinute/accessMode failed validation.

​401 — Not signed in.

​403 — Demo mode is read-only, or the caller is not an admin of any org.

​429 — Too many requests from this IP.

​Errors

`POST /api/docks`

Request body

Example

Responses

`201` — The created dock.

`rooftop`

`400` — name/address/latitude/longitude/pricePerMinute/accessMode failed validation.

`401` — Not signed in.

`403` — Demo mode is read-only, or the caller is not an admin of any org.

`429` — Too many requests from this IP.

Errors