SimpleDock API
API by SimpleDock · rest
Read availability and create or manage dock appointments programmatically. Authenticate with an API key as a Bearer token (Authorization: Bearer sd_live_…), created in Settings → API on any plan. Endpoints under /public and POST /agent/signup need no key: an agent with no account can create one (see /auth.md). Every non-2xx response is { "error": { "code", "message", "details"? } }. Codes are stable — branch on error.code, never on the message text. Typical flow: listLocations → listAppointmentTypes → listAvailability → createAppointment. The same operations are exposed as MCP tools at /api/v1/mcp. Pacing. Every response carries RateLimit-Policy and RateLimit (draft-ietf-httpapi-ratelimit-headers structured fields); a 429 adds Retry-After. Authenticated: 120 requests per 60s per key. Unauthenticated: 60 per 60s per IP. Stability. The version is in the URL path. 180 days' notice before a version is retired, signalled by Deprecation (RFC 9745)…
Endpoint: https://simpledock.ai/api/v1
Verification: observed. Source: crawl.
Capabilities (39)
- Whether the owner has confirmed their email
- Send the owner a new confirmation email
- Confirm the owner's email with the six-digit code (REST)
- Create an account for the person an agent works for
- Per-location appointment summary
- List appointments
- Create an appointment
- Get an appointment
- Reschedule and/or edit details
- Approve a pending appointment
- Mark a truck arrived or clear the mark
- Cancel an appointment
- Record driver check-in
- Reject a pending appointment
- Transition status (CONFIRMED / COMPLETED / NO_SHOW)
- List bookable slots
- List locations
- Create a location
- Get a location
- Update a location
- List appointment types
- Create an appointment type
- Update an appointment type
- List upcoming closures
- Replace upcoming closures