> ## Documentation Index
> Fetch the complete documentation index at: https://docs.getkato.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Identify your workspace

> Check the workspace and scopes associated with a developer access key.

Requires a valid developer access key. No additional resource scope is needed.
The workspace comes from the key; this endpoint does not switch workspaces.

<ResponseField name="data.workspace" type="object | null">
  The workspace's `id`, `name`, and `slug`, or `null` if it cannot be found.
</ResponseField>

<ResponseField name="data.scopes" type="string[]">
  Scopes granted to the key.
</ResponseField>

<ResponseField name="data.keyId" type="string">
  The key identifier, not its secret token.
</ResponseField>

<RequestExample>
  ```bash Request theme={null}
  curl --fail-with-body --silent --show-error \
    https://api.getkato.io/v1/whoami \
    -H "Authorization: Bearer $KATO_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json Example response theme={null}
  {
    "data": {
      "workspace": {
        "id": "workspace_example",
        "name": "Northstar Studio",
        "slug": "northstar"
      },
      "scopes": ["objects:read"],
      "keyId": "key_example"
    }
  }
  ```
</ResponseExample>

See [Authentication](/api-reference/authentication) for key creation and errors.


## Related topics

- [Create your workspace](/documentation/create-your-workspace.md)
- [Shape your workspace data](/documentation/data/overview.md)
- [Raycast](/integrations/raycast.md)
- [Developer quickstart](/api-reference/quickstart.md)
- [Use Ask Kato](/documentation/use-ask-kato.md)