Dd dominic/update oauth doc #32317
Open
Dd dominic/update oauth doc #32317
+63
−129
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
…Dog/documentation into dd-dominic-update-oauth-doc
Preview links (active after the
|
eho1307
approved these changes
Oct 22, 2025
urseberry
reviewed
Oct 22, 2025
|
|
||
| Note: This functionality is only available for approved Technology Partners intending on building integrations. OAuth clients for other purposes are not supported. | ||
| 1. Determine the required [scopes][8] for your integration use case. | ||
| 2. Implement OAuth following [these steps][9]. |
There was a problem hiding this comment.
Suggested change
| 2. Implement OAuth following [these steps][9]. | |
| 2. [Implement OAuth][9]. |
| 5. Click **Generate OAuth Client Secret** to create credentials for testing. | ||
| 6. Record the client secret, as it is not displayed again. | ||
| 7. Select the minimum scopes required for your integration. | ||
| - **Note**: Enable the `api_keys_write` scope to submit data (metrics, logs, events, etc.) to Datadog. |
There was a problem hiding this comment.
Suggested change
| - **Note**: Enable the `api_keys_write` scope to submit data (metrics, logs, events, etc.) to Datadog. | |
| - **Note**: Enable the `api_keys_write` scope to submit data (such as metrics, logs, or events) to Datadog. |
evazorro
requested changes
Oct 24, 2025
Comment on lines
+30
to
+33
| - Your product must be generally available | ||
| - Your product must host the source code that interacts with the Datadog API | ||
| - Your integration must submit telemetry to Datadog | ||
| - Your integration must implement OAuth for authorization (see below for more details) |
There was a problem hiding this comment.
Suggested change
| - Your product must be generally available | |
| - Your product must host the source code that interacts with the Datadog API | |
| - Your integration must submit telemetry to Datadog | |
| - Your integration must implement OAuth for authorization (see below for more details) | |
| - Your product must be generally available. | |
| - Your product must host the source code that interacts with the Datadog API. | |
| - Your integration must submit telemetry to Datadog. | |
| - Your integration must implement OAuth for authorization (see below for more details). |
Comment on lines
+168
to
+172
| [2]: https://docs.datadoghq.com/api/latest/metrics/ | ||
| [3]: https://docs.datadoghq.com/logs/faq/partner_log_integration/ | ||
| [4]: https://docs.datadoghq.com/api/latest/events/ | ||
| [5]: https://docs.datadoghq.com/api/latest/incidents/ | ||
| [6]: https://docs.datadoghq.com/api/latest/users/ |
There was a problem hiding this comment.
Suggested change
| [2]: https://docs.datadoghq.com/api/latest/metrics/ | |
| [3]: https://docs.datadoghq.com/logs/faq/partner_log_integration/ | |
| [4]: https://docs.datadoghq.com/api/latest/events/ | |
| [5]: https://docs.datadoghq.com/api/latest/incidents/ | |
| [6]: https://docs.datadoghq.com/api/latest/users/ | |
| [2]: /api/latest/metrics/ | |
| [3]: /logs/faq/partner_log_integration/ | |
| [4]: /api/latest/events/ | |
| [5]: /api/latest/incidents/ | |
| [6]: /api/latest/users/ |
There was a problem hiding this comment.
(We use relative links to link to other pages published on the documentation site.)
|
|
||
| 2. Look for the API key named `OAuth Client API Key` and select it. | ||
| 3. Click **Revoke** to disable the API key. | ||
| 4. Follow the steps in [Create an API key](#create-an-api-key) to create a new key. |
There was a problem hiding this comment.
This isn't in the doc anymore and I'm not totally sure what to replace it with -- it looks like there's a call during the OAuth handshake that creates the key? (The old section is also linked from under the Troubleshooting heading, could you update it there too?)
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
4 participants
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
What does this PR do? What is the motivation?
Update documentation for technology partners to build API integrations with the new Developer Platform