API ReferenceOrganization

Get organization

Required scope: `organization:read`.

Authorization

bearerAuth

AuthorizationBearer <token>

OAuth access token, e.g. Authorization: Bearer swot_….

In: header

Response Body

`application/json`

`application/json`

`application/json`

curl -X GET "https://example.com/api/oauth/v1/organization"

{
  "data": {
    "id": "string",
    "name": "string",
    "display_name": "string",
    "domain": "string",
    "created_at": "2019-08-24T14:15:22Z"
  }
}

{
  "error": "insufficient_scope",
  "error_description": "The token is missing a required scope."
}

{
  "error": "insufficient_scope",
  "error_description": "The token is missing a required scope."
}

Current token

Describe the current access token — its app, organization, actor and granted scopes.

Update organization

Update the display name. Requires `organization:write`, an `actor=self` token held by the org owner.