---
title: "API versioning and deprecation policy"
method: GET
path: "/api/v1"
tags: ["meta"]
---

# API versioning and deprecation policy

`GET /api/v1`

## Request

- Base URL: `https://skillselion.com`
- URL: `https://skillselion.com/api/v1`
- Auth: none declared

Current version is 1. Path prefix /api/v1 (also /v1/). Header API-Version: 1. Deprecated operations send Deprecation and Sunset headers. None are deprecated today.

## Headers

- `API-Version` '1'

## Response `200`

Versioning policy.

- VersioningPolicy
  - `apiVersion` '1', required
  - `current` '1', required
  - `header` 'API-Version', required
  - `pathPrefix` '/api/v1', required
  - `alias` string
  - `documentation` string, uri
  - `openapi` string, uri
  - `deprecation` object, required
    - `headers` string[], required
    - `linkRel` string
    - `note` string, required
  - `rateLimit` object

## Other responses

- `400`: Invalid query or body.
- `401`: Authentication required (staff routes only).
- `404`: No listing or route matches.
- `405`: Method not allowed.
- `429`: Rate limited. Retry-After and RateLimit headers are set.
- `500`: Upstream or server error.

---

[API](https://skmtc.dev/skillselion/apis/skillselion-public-api.md) · [All operations](https://skmtc.dev/skillselion/apis/skillselion-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/skillselion/apis/skillselion-public-api/revisions/e6e0c4d3d116?raw)