Developers API reference Version 1 · generated from the code openapi.json
Routes

spaces

List spaces

GET /api/v1/spaces

The spaces the account can open: its own, those of its organisation, what other people share with it, and its favorites.

The key of a space is what the other routes take as space.

Required scope: read

Response

200 array of Space

  • key string

    What the other routes take as space: me, org:<id>, user:<id> or favorites.

  • kind string

    personal: your own. organisation: that of an organisation. shared: what one person shares with you. favorites: what you keep at hand, wherever it lives (its root lists the favorites that open).

  • name string

    Name of the organisation or of the person; empty for personal and favorites.

  • can_create boolean

    Whether the account may create at the root of it.

Errors

  • 401

    No valid credential.

  • 403

    The credential lacks the required scope, or the account may not do this.

  • 429

    Too many requests; Retry-After gives the seconds to wait.

planner_banner_ad_pt