API Reference

List visible docks

Lists Dock resources visible to the caller: with ?mine=true (or always, for a demo session) the caller’s own org-owned docks at any access mode; otherwise every globally-open dock plus shared docks in networks the caller has joined (private docks of other orgs are never returned). Use ?mine=true for an owner’s fleet management view and omit it for the marketplace/browse view. Supply is presently ~6.3K leftover synthetic rows plus any real docks created via docks_create — there is no live occupancy (?at= is not implemented; status is a stored value).

`GET /api/docks`

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

Parameters

Name	In	Required	Type	Description
`mine`	query	no	`string`	’true’ to scope to the caller’s own org-owned docks at any access mode.

Responses

`200` — Visible docks.

Array of:

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	—

`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	—

`500` — Session/auth resolution error, or unhandled server error.

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	—

Errors

⌘I

​GET /api/docks

​Parameters

​Responses

​200 — Visible docks.

​rooftop

​401 — Not signed in.

​500 — Session/auth resolution error, or unhandled server error.

​Errors