---
title: "Retrieve your token's bot user"
method: GET
path: "/v1/users/me"
tags: ["Users"]
---

# Retrieve your token's bot user

`GET /v1/users/me`

## Headers

- `Notion-Version` '2026-03-11', required

## Response `200`

- union
  - object
    - `id` string, uuid, required
    - `object` 'user', required — The user object type name.
    - `name` string, nullable, required — The name of the user.
    - `avatar_url` string, nullable, required — The avatar URL of the user.
    - `type` 'person', required — Indicates this user is a person.
    - `person` object, required — Details about the person, when the `type` of the user is `person`.
      - `email` string — The email of the person.
      - `email_verified` boolean — Whether the person's email is verified.
  - object
    - `id` string, uuid, required
    - `object` 'user', required — The user object type name.
    - `name` string, nullable, required — The name of the user.
    - `avatar_url` string, nullable, required — The avatar URL of the user.
    - `type` 'bot', required — Indicates this user is a bot.
    - `bot` union, required — Details about the bot, when the `type` of the user is `bot`.
      - EmptyObject
      - BotInfoResponse
        - `owner` union, required — Details about the owner of the bot.
          - object
            - `type` 'user', required — Always `user`
            - `user` union, required — Details about the owner of the bot, when the `type` of the owner is `user`. This means the bot is for a integration.
              - …
          - object
            - `type` 'workspace', required — Always `workspace`
            - `workspace` true, required — Details about the owner of the bot, when the `type` of the owner is `workspace`. This means the bot is for an internal integration.
        - `workspace_id` string, required — The ID of the bot's workspace.
        - `workspace_limits` object, required — Limits and restrictions that apply to the bot's workspace
          - `max_file_upload_size_in_bytes` integer, required — The maximum allowable size of a file upload, in bytes
        - `workspace_name` string, nullable, required — The name of the bot's workspace.

## Other responses

- `400`
- `401`
- `403`
- `404`
- `406`
- `409`
- `429`
- `500`
- `503`
- `504`
- `529`

## Changes

> 17 revisions in range; 5 could not be searched.

- **2026-08-13** `ae20477af71b` — 1 breaking, 1 info
  - added `subschema #1, subschema #2, subschema #3` to the response body `oneOf` list for the response status `403`
  - removed `#/components/schemas/publicApiCommonErrorResponse, subschema #2` from the response body `allOf` list for the response status `403`
- **2026-08-12** `28d140865fc6` — 2 warning
  - added the new `agent_credit_limit_reached` enum value to the `allOf[subschema #2]/code` response property for the response status `403`
  - added the new `workspace_credits_exhausted` enum value to the `allOf[subschema #2]/code` response property for the response status `403`
- **2026-07-31** `301eea0116d9` — 2 warning
  - added the new `invalid_beta` enum value to the `allOf[subschema #2]/code` response property for the response status `400`
  - added the new `invalid_credit_limit` enum value to the `allOf[subschema #2]/code` response property for the response status `400`
- **2026-07-26** `681ee94f046c` — 3 warning
  - added the new `agent_deleted` enum value to the `allOf[subschema #2]/code` response property for the response status `409`
  - added the new `directory_not_found` enum value to the `allOf[subschema #2]/code` response property for the response status `404`
  - added the new `status_change_not_allowed` enum value to the `allOf[subschema #2]/code` response property for the response status `403`

[Change history](https://skmtc.dev/notion/apis/notion-api/changes/v1/users/me/get.md)

---

[API](https://skmtc.dev/notion/apis/notion-api.md) · [All operations](https://skmtc.dev/notion/apis/notion-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/notion/notion-api/revisions/d125dfa2cde5/schema)