---
title: "Introspect Endpoint"
method: POST
path: "/oauth/introspect"
tags: ["OAuth 2.0"]
---

# Introspect Endpoint

`POST /oauth/introspect`

Check whether an access token is valid, and if so, what scopes and identity it grants

## Response `200`

Success

- union
  - object
    - `active` false, required
  - object
    - `active` boolean, required — Whether the token is currently active and usable.
    - `scope` string, required — A space-separated list of scopes associated with this token
    - `client_id` string, required — The app ID of the OAuth application that requested this token
    - `token_type` 'Bearer', required — The type of token, always Bearer for tokens acquired via the OAuth 2.0 flow.
    - `exp` number, nullable, required — The time at which this token will expire, if set, as a number of seconds since January 1 1970 UTC.
    - `iat` number, required — The time at which this token was issued, as a number of seconds since January 1 1970 UTC.
    - `sub` string, uuid, required — Since Bearer tokens grant Workspace-level permissions, this property contains the workspace_id.
    - `aud` string, required — The intended audience for this token, for Bearer tokens this is the same as the client_id.
    - `iss` 'attio.com', required — The issuer of the token. Always attio.com
    - `authorized_by_workspace_member_id` string, uuid, nullable, required — The ID of the workspace member who authorised this token initially, if known
    - `workspace_id` string, uuid, required — The ID of the workspace the token is scoped to.
    - `workspace_name` string, required — The name of the workspace the token is scoped to.
    - `workspace_slug` string, required — The slug of the workspace the token is scoped to.
    - `workspace_logo_url` string, uri, nullable, required — The logo URL of the workspace the token is scoped to.

---

[API](https://skmtc.dev/attio/apis/attio-oauth-flow.md) · [All operations](https://skmtc.dev/attio/apis/attio-oauth-flow/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/attio/attio-oauth-flow/revisions/6441a1d546a3/schema)