> For the complete documentation index, see [llms.txt](https://docs.castmagic.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.castmagic.io/endpoints/spaces.md).

# Spaces

List the spaces your API key can access.

Spaces are Castmagic's top-level containers for recordings, prompts, and speakers. Space ids scope most other endpoints. Omitting `space_id` on write endpoints falls back to the key's default space — with one exception: `POST /v1/recordings` defaults to the space the upload was created in.

{% hint style="info" %}
**Tier:** `core`. Base URL `https://app.castmagic.io`.
{% endhint %}

## List spaces

<mark style="color:blue;">`GET`</mark> `https://app.castmagic.io/v1/spaces`

Returns every space the key's user belongs to.

#### Headers

| Name                                            | Type   | Description        |
| ----------------------------------------------- | ------ | ------------------ |
| Authorization<mark style="color:red;">\*</mark> | String | Bearer API\_SECRET |

{% tabs %}
{% tab title="200: OK" %}

```json
{
    "spaces": [
        {
            "id": "a1b2c3d4-0000-0000-0000-000000000001",
            "name": "Acme Podcast",
            "language": "en"
        }
    ],
    "count": 1
}
```

{% endtab %}
{% endtabs %}