Skip to content

Commit 9d39742

Browse files
Add API v1 deprecation banners (calcom#25065)
* Update docs/api-reference/v1/introduction.mdx * Update docs/api-reference/v1/authentication.mdx * Update docs/api-reference/v1/errors.mdx * Update docs/api-reference/v1/rate-limit.mdx * Update docs/mint.json --------- Co-authored-by: mintlify[bot] <109931778+mintlify[bot]@users.noreply.github.com>
1 parent 5267f8c commit 9d39742

5 files changed

Lines changed: 21 additions & 1 deletion

File tree

docs/api-reference/v1/authentication.mdx

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,10 @@
22
title: "Authentication"
33
---
44

5+
<Warning>
6+
**API v1 is deprecated and will be discontinued on February 15, 2026.** Please migrate to [API v2](/api-reference/v2/introduction) as soon as possible.
7+
</Warning>
8+
59
The Cal.com API uses API keys to authenticate requests. You can view and manage your API keys in your settings page under the security tab in Cal.com.
610

711
<img src="/images/i1600x899-DllqhV6w_3Vj_oxtjov.png" />

docs/api-reference/v1/errors.mdx

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,10 @@
22
title: "Errors"
33
---
44

5+
<Warning>
6+
**API v1 is deprecated and will be discontinued on February 15, 2026.** Please migrate to [API v2](/api-reference/v2/introduction) as soon as possible.
7+
</Warning>
8+
59
Cal.com uses conventional HTTP response codes to indicate the success or failure of an API request. In general: Codes in the 2xx range indicate success. Codes in the 4xx range indicate an error that failed given the information provided (e.g., a required parameter was omitted, or something else failed, etc.). Codes in the 5xx range indicate an error with Cal.com's servers (these are rare).
610

711
<table>

docs/api-reference/v1/introduction.mdx

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,10 @@
22
title: "Quick start"
33
---
44

5+
<Warning>
6+
**API v1 is deprecated and will be discontinued on February 15, 2026.** Please migrate to [API v2](/api-reference/v2/introduction) as soon as possible.
7+
</Warning>
8+
59
## Get your API keys
610

711
Your API requests are authenticated using API keys. Any request that doesn't include an API key will return an error.

docs/api-reference/v1/rate-limit.mdx

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,10 @@
22
title: "Rate limits"
33
---
44

5+
<Warning>
6+
**API v1 is deprecated and will be discontinued on February 15, 2026.** Please migrate to [API v2](/api-reference/v2/introduction) as soon as possible.
7+
</Warning>
8+
59
We limit the number of calls you can make over a certain period of time. Rate limits vary and are specified by the following header in all responses:
610

711
<table>

docs/mint.json

Lines changed: 5 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,11 @@
5252
{
5353
"name": "API v1 Reference",
5454
"openapi": "/api-reference/v1/openapi-v1.json",
55-
"url": "api-reference/v1"
55+
"url": "api-reference/v1",
56+
"banner": {
57+
"type": "warning",
58+
"content": "API v1 will be discontinued on February 15, 2026. Please migrate to [API v2](/api-reference/v2/introduction)."
59+
}
5660
}
5761
],
5862
"navigation": [

0 commit comments

Comments
 (0)