DEdefaulr
OAuthClients

Rotate the secret for an OAuth client

Changed on

Generate a new client secret for an OAuth client. The old secret will be invalidated immediately, so ensure your application is updated to use the new secret.

post/oauthClients.rotate_secret

Request

  • Base URL
    https://app.getoutline.com/api
  • URL
    https://app.getoutline.com/api/oauthClients.rotate_secret
  • Auth
    • HTTP bearer
    • or OAuth 2
      Authorization code: https://app.getoutline.com/oauth/authorize
      Token URL: https://app.getoutline.com/oauth/token scopes: read, write

Request body

idstring uuid required

Unique identifier for the OAuth client.

Response

OK

Example response

{
  "data": {
    "name": "Acme Inc",
    "description": "Integrate Acme Inc's services into Outline.",
    "developerName": "Acme Inc",
    "developerUrl": "https://example.com",
    "clientId": "2bquf8avrpdv31par42a",
    "clientSecret": "ol_sk_rapdv31...",
    "redirectUris": [
      "https://example.com/callback"
    ],
    "published": true
  },
  "policies": [
    {
      "abilities": {
        "read": true,
        "update": true,
        "delete": false
      }
    }
  ]
}

Changes

  • 304cd065561bRevision changes
    • breaking

      the response property / became nullable for the status

    • breaking

      the response property / became nullable for the status

    • breaking

      the response property / became nullable for the status

    • breaking

      the response property / became nullable for the status

    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

  • 2b998aa571f9Revision changes
    • info

      endpoint added