---
title: API reference
description: REST endpoints for every Wiblo surface, generated from the same OpenAPI spec that powers the SDK.
canonical_url: https://wiblo.app/docs/developers/api
last_updated: 2026-07-28T17:12:38+02:00
md_url: https://wiblo.app/docs/developers/api.md
---

# API reference

The Wiblo API is a conventional REST API served from `https://api.wiblo.app`. Requests and responses are JSON, every error carries a stable machine-readable code, and the whole surface is described by the public [OpenAPI spec](https://api.wiblo.app/openapi.yaml) — the same document the TypeScript SDK is generated from.

> **Authentication required**
>
> Every non-public endpoint takes a bearer token — mint a personal token from Settings → Tokens or a workspace API key from Settings → API keys. See [Authentication](/docs/developers/api/authentication).

Start with the [Introduction](/docs/developers/api/introduction), then browse endpoints by module.

## Browse by module

### Platform

Service health, the signed-in identity, and the CLI credentials that sign requests.

- [Health](/docs/developers/api/meta) — Service health and status.
- [Me & identity](/docs/developers/api/identity) — The signed-in identity and its resolver state.
- [CLI auth](/docs/developers/api/cli) — The OAuth device flow behind wiblo login.
- [CLI tokens](/docs/developers/api/cli-tokens) — List, mint, and revoke personal CLI tokens.

### Workspace

The workspace itself — roster, invites, API keys, automations, and repos.

- [Workspaces](/docs/developers/api/workspaces) — Create and manage workspaces.
- [Members](/docs/developers/api/members) — The workspace roster — humans and machine members.
- [Invites](/docs/developers/api/invites) — Invite members and accept invitations.
- [API keys](/docs/developers/api/api-keys) — Workspace API keys for scripts and integrations.
- [Automations](/docs/developers/api/automations) — Machine members that act on the workspace.
- [Workspace repos](/docs/developers/api/repos) — The workspace's repository registry.

### Bookings

The booking engine, from the service catalogue to the public booking surface.

- [Services](/docs/developers/api/services) — The service catalogue clients book.
- [Hosts](/docs/developers/api/hosts) — Assign members to host services.
- [Service tags](/docs/developers/api/service-tags) — Organise the catalogue with tags.
- [Resources](/docs/developers/api/resources) — Rooms and equipment bookings can require.
- [Schedules](/docs/developers/api/schedules) — Working-hours schedules and overrides.
- [Availability](/docs/developers/api/availability) — Query bookable slots.
- [Out of office](/docs/developers/api/out-of-office) — Time-off entries that block availability.
- [Bookings](/docs/developers/api/bookings) — Create, list, cancel, and reschedule bookings.
- [Seats](/docs/developers/api/seats) — Multi-attendee seats on group bookings.
- [Series](/docs/developers/api/series) — Recurring booking series.
- [Holidays](/docs/developers/api/holidays) — Public-holiday calendars and settings.
- [Public booking](/docs/developers/api/public) — The unauthenticated booking-page lane.

### Agents

Agent runs and threads, the sandbox workbench, run git, and golden snapshots.

- [Agent runs](/docs/developers/api/agent-runs) — Provision and control agent sandbox runs.
- [Threads & turns](/docs/developers/api/agent-threads) — Converse with an agent run.
- [Workbench](/docs/developers/api/agent-workbench) — Files and terminal inside a run.
- [Run git](/docs/developers/api/agent-git) — Git status, diffs, and versions inside a run.
- [Run repos](/docs/developers/api/agent-run-repos) — Repositories checked out in a run.
- [Golden snapshots](/docs/developers/api/agent-golden) — The workspace's baked sandbox baseline.