> ## Documentation Index
> Fetch the complete documentation index at: https://docs.spacemedia.uk/llms.txt
> Use this file to discover all available pages before exploring further.

# SpaceMedia public API overview and scope

> Understand the SpaceMedia public API scope, supported endpoint families, authentication model, response envelopes, and excluded system routes.

# API Introduction

The SpaceMedia public API is for external organization automation. It is authenticated, organization scoped, and governed by the same Laravel policies used by the dashboard.

## Base URL

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
https://enterprise.spacemedia.uk
```

## Public endpoint families

| Family                    | Scope                                                                                                                                        |
| ------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------- |
| Auth                      | Exchange organization API key and secret for a bearer token, then validate token expiry.                                                     |
| Account                   | Current user and organization context plus custom label creation.                                                                            |
| Artists, releases, tracks | Content workflows available to permitted organization users.                                                                                 |
| Splits                    | Revenue split listing, creation, updates, and confirmations.                                                                                 |
| Users                     | Organization user listing, invitation, detail, role updates, suspension, and related user records where policies allow.                      |
| Packages and payments     | Membership packages, Pay-Per-Release plans, upgrade options, subscriptions, checkouts, credit purchases, and payment verification callbacks. |
| Add-ons                   | Organization-level add-on checkout and lifecycle actions.                                                                                    |
| Copyright                 | Organization copyright summary, statistics, wallet reads, wallet top-ups, release reads, and top-up status.                                  |
| Quality Control           | Submitted release queue where the organization admin has dashboard access.                                                                   |
| Reference                 | Countries and release territories.                                                                                                           |

## Excluded capabilities

The public spec does not include platform-only organization directory endpoints, system add-on administration, provider-balance reads, manual copyright wallet adjustments, copyright reruns, document approval/rejection actions, internal document downloads, or destructive user deletion.

## Response model

Most controller responses use the `ApiResponse` helper with `success`, optional `message`, `data`, optional `meta`, and optional `errors`. Resource collection endpoints may return a Laravel resource collection envelope with `data` only. Each endpoint example shows the actual style used by that route.