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

spaces

List the root of a space

GET /api/v1/spaces/{key}

The binders and flows at the root of a space, each with the role of the account on it.

Required scope: read

Path parameters

  • key string · required

    A space key, as GET /spaces lists them: me, org:<id>, user:<id> or favorites.

Response

200 Children

  • binders array of Binder

    The binders.

    13 fields
    • id integer

      Id, unique among the objects of its type.

    • type string

      Always binder.

    • name string

      Its name.

    • role string or null

      Role of the account on it: owner, editor or reader; null when it holds none of its own.

    • online_status string

      online: open to its readers. offline: closed. pending_online / pending_offline: inside a binder that is not online, hence closed; the setting is recorded and applies when the parent goes online.

    • parent_id integer or null

      Id of the binder that holds it; null at the root of a space.

    • organisation_id integer or null

      Id of the organisation whose space it lives in; null in a personal space.

    • owner Owner

      The account that owns it.

      2 fields
      • id integer

        Id of the account.

      • name string

        Its name, or its address when it has none.

    • created_at date-time

      When it was created.

    • updated_at date-time

      When it was last changed.

    • description string

      Free text; may be empty.

    • flows_count integer or null

      Number of flows directly inside. Given in listings, null elsewhere.

    • sub_binders_count integer or null

      Number of binders directly inside. Given in listings, null elsewhere.

  • flows array of Flow

    The flows.

    13 fields
    • id integer

      Id, unique among the objects of its type.

    • type string

      Always flow.

    • name string

      Its name.

    • role string or null

      Role of the account on it: owner, editor or reader; null when it holds none of its own.

    • online_status string

      online: open to its readers. offline: closed. pending_online / pending_offline: inside a binder that is not online, hence closed; the setting is recorded and applies when the parent goes online.

    • parent_id integer or null

      Id of the binder that holds it; null at the root of a space.

    • organisation_id integer or null

      Id of the organisation whose space it lives in; null in a personal space.

    • owner Owner

      The account that owns it.

      2 fields
      • id integer

        Id of the account.

      • name string

        Its name, or its address when it has none.

    • created_at date-time

      When it was created.

    • updated_at date-time

      When it was last changed.

    • is_published boolean

      Whether a published version exists.

    • published_at date-time or null

      When it was last published; null when it never was.

    • has_unpublished_changes boolean or null

      Whether the draft differs from the published version. null for who may not edit the flow.

Errors

  • 401

    No valid credential.

  • 403

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

  • 404

    Nothing with that id, or nothing the account may open.

  • 429

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

planner_banner_ad_pt