---
title: "Directory of published spaces"
method: GET
path: "/api/public/discover"
tags: ["public"]
---

# Directory of published spaces

`GET /api/public/discover`

## Request

- Base URL: `https://telawiki.com`
- URL: `https://telawiki.com/api/public/discover`
- Auth: none required

Every space on this instance whose visibility is `public`, across all accounts.

## Query parameters

- `sort` 'recent' | 'popular'
- `limit` integer
- `offset` integer

## Response `200`

Published spaces.

- object
  - `spaces` DiscoverSpace[], required
    - `id` integer, required
    - `name` string, required
    - `slug` string, required
    - `description` string, required
    - `owner_handle` string
    - `public_path` string: `/{handle}/{slug}`.
    - `page_count` integer, required
    - `updated_at` string, required: Most recent page update. Empty string when the space has no pages.
  - `limit` integer, required
  - `offset` integer, required

## Other responses

- `500`: `internal` — server error.

---

[API](https://skmtc.dev/telawiki/apis/tela-rest-api.md) · [All operations](https://skmtc.dev/telawiki/apis/tela-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/telawiki/apis/tela-rest-api/revisions/f316f31f6fcb?raw)