commonscomputer/cal.diy
4
0
Fork 0
Code Issues Pull Requests Actions 2.2k Packages Projects Releases Wiki Activity

docs: fix grammar, redundant word, and simplify OAuth client docs (#25747)

Browse Source 
* docs: fix grammar and redundant word in managed organizations guide

Co-Authored-By: lauris@cal.com <lauris@cal.com>

* docs: simplify OAuth client fetching paragraphs per Pedro's feedback

Co-Authored-By: lauris@cal.com <lauris@cal.com>

---------

Co-authored-by: Devin AI <158243242+devin-ai-integration[bot]@users.noreply.github.com>
Co-authored-by: lauris@cal.com <lauris@cal.com>
This commit is contained in:
devin-ai-integration[bot]
2025-12-10 17:17:23 +05:30
committed by GitHub
co-authored by lauris@cal.com
parent b0bf0aaec2
commit f4223d1657
1 changed files with 5 additions and 8 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/platform/guides/managed-orgs.mdx
+5 -8
View File
@@ -3,7 +3,7 @@ title: Managed organizations
description: Find out how to create managed organizations and their OAuth clients via the api.
---
## **1. How to create a managed organizations**
## **1. How to create a managed organization**
First, manually create an OAuth client in [https://app.cal.com/settings/platform](https://app.cal.com/settings/platform).
@@ -43,7 +43,7 @@ Here is response:
}
```
Notably, you will only have access to the `apiKey` only now, so make sure to create a table in your database where you store managed organization's `id` and `apiKey` . The `apiKey` will be used to create an OAuth client that is used to create platform users.
Notably, you will only have access to the `apiKey` now, so make sure to create a table in your database where you store managed organization's `id` and `apiKey` . The `apiKey` will be used to create an OAuth client that is used to create platform users.
Using same `x-cal-client-id` and `x-cal-secret-key` headers you can make requests to:
@@ -86,13 +86,10 @@ Response:
}
```
To fetch all OAuth clients of a managed organization make a GET request to `https://api.cal.com/v2/oauth-clients` by:
Using the same `Authorization: Bearer <apiKey>` header, you can also:
1. Setting `Authorization: Bearer <apiKey>` header where `<apiKey>` is the api key returned when creating a managed organization.
To fetch a specific OAuth client of a managed organization make a GET request to `https://api.cal.com/v2/oauth-clients/:oAuthClientId` by:
1. Setting `Authorization: Bearer <apiKey>` header where `<apiKey>` is the api key returned when creating a managed organization.
- Fetch all OAuth clients: GET `https://api.cal.com/v2/oauth-clients`
- Fetch a specific OAuth client: GET `https://api.cal.com/v2/oauth-clients/:oAuthClientId`
## **3. How to refresh api key of a managed organization**