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.

Tier: core. Base URL https://app.castmagic.io.

List spaces

GET https://app.castmagic.io/v1/spaces

Returns every space the key's user belongs to.

Headers

Name	Type	Description
Authorization*	String	Bearer API_SECRET

200: OK

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