# Check slug availability `GET /api/v1/sports/slug-available` Checks whether a public URL slug is available in the workspace associated with your API key. ## Permissions Send your API key in `X-API-Key`. Required permissions are **Sports → Write**. ## Query parameters - `slug` (string, required) — The proposed slug. The API lowercases it, replaces spaces with hyphens, and removes characters outside letters, digits, hyphens, and underscores. - `exclude_id` (integer) — The ID of the sport being edited. The availability check ignores that sport. ## Request Set ASDINCLOUD_API_KEY before running. ```sh curl --get \ --url "https://api.asdincloud.com/api/v1/sports/slug-available" \ --header "X-API-Key: $ASDINCLOUD_API_KEY" \ --data-urlencode "slug=youth-basketball" ``` ## Response **200 OK** Returns `available: true` if no matching sport uses the slug, or `available: false` if it is taken. If normalization leaves an empty slug, the response includes `available: false` and `reason: invalid_format`. The check does not reserve the slug. The update still validates it. Example with fictional data and selected fields. ```json { "available": true } ``` ## Errors - `401` — The API key is missing or invalid. - `403` — The API key lacks Sports write access. - `400` — The slug was missing, empty, or not a string.