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

# Notion: Get Self

> Show which Notion integration bot and workspace the connected token belongs to. Includes SDK V2 examples, input constraints, response fields, and Deepline cost.

Show which Notion integration bot and workspace the connected token belongs to.

> [!NOTE]
>
> Tool ID: `notion_get_self`

## Run this action

Use the TypeScript SDK for one call. Use `ctx.tools.execute(...)` inside a Play for durable calls, scheduled calls, or CSV processing.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'notion_get_self',
  {},
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute notion_get_self --input '{}' --json
```

## Example response

The SDK returns this shape at `result.toolResponse.raw`. The example values illustrate the response.

```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
{
  "data": {
    "id": "123e4567-e89b-42d3-a456-426614174000",
    "object": "user",
    "name": "Example",
    "avatar_url": "https://example.com",
    "type": "person",
    "person": {
      "email": "jane.doe@example.com",
      "email_verified": true
    }
  }
}
```

Use `deepline describe notion_get_self --json` for the latest machine-readable contract.

## Input reference

Retrieve your token's bot user

This action requires no input fields.

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Retrieve your token's bot user",
    "properties": {},
    "required": [],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Provider response payload. |
| `result.data.id` | `string` | Yes | — | — |
| `result.data.object` | `"user"` | Yes | — | The user object type name. |
| `result.data.name` | `string \| null` | Yes | — | The name of the user. |
| `result.data.avatar_url` | `string \| null` | Yes | — | The avatar URL of the user. |
| `result.data.type` | `"person"` | Yes | — | Indicates this user is a person. |
| `result.data.person` | `object` | Yes | — | Details about the person, when the `type` of the user is `person`. |
| `result.data.person.email` | `string` | No | — | The email of the person. |
| `result.data.person.email_verified` | `boolean` | No | — | Whether the person's email is verified. |
| `result.data.bot` | `object` | Yes | — | Details about the bot, when the `type` of the user is `bot`. |
| `result.data.bot.owner` | `object` | Yes | — | Details about the owner of the bot. |
| `result.data.bot.owner.type` | `"user"` | Yes | — | Always `user` |
| `result.data.bot.owner.user` | `object` | Yes | — | Details about the owner of the bot, when the `type` of the owner is `user`. This means the bot is for a integration. |
| `result.data.bot.owner.user.id` | `string` | Yes | — | — |
| `result.data.bot.owner.user.object` | `"user"` | Yes | — | The user object type name. |
| `result.data.bot.owner.user.name` | `string \| null` | Yes | — | The name of the user. |
| `result.data.bot.owner.user.avatar_url` | `string \| null` | Yes | — | The avatar URL of the user. |
| `result.data.bot.owner.user.type` | `"person"` | Yes | — | The type of the user. |
| `result.data.bot.owner.user.person` | `object` | Yes | — | The person info of the user. |
| `result.data.bot.owner.workspace` | `true` | Yes | — | Details about the owner of the bot, when the `type` of the owner is `workspace`. This means the bot is for an internal integration. |
| `result.data.bot.workspace_id` | `string` | Yes | — | The ID of the bot's workspace. |
| `result.data.bot.workspace_limits` | `object` | Yes | — | Limits and restrictions that apply to the bot's workspace |
| `result.data.bot.workspace_limits.max_file_upload_size_in_bytes` | `integer` | Yes | — | The maximum allowable size of a file upload, in bytes |
| `result.data.bot.workspace_name` | `string \| null` | Yes | — | The name of the bot's workspace. |
| `result.meta` | `object` | No | — | Additional response metadata (status, paging). |

<details>
  <summary>Show raw output schema</summary>

  ### Output JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Standard tool result payload.",
    "properties": {
      "data": {
        "description": "Provider response payload.",
        "anyOf": [
          {
            "type": "object",
            "properties": {
              "id": {
                "$ref": "#/$defs/idResponse"
              },
              "object": {
                "type": "string",
                "description": "The user object type name.",
                "const": "user"
              },
              "name": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "The name of the user."
              },
              "avatar_url": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "The avatar URL of the user."
              },
              "type": {
                "type": "string",
                "description": "Indicates this user is a person.",
                "const": "person"
              },
              "person": {
                "type": "object",
                "description": "Details about the person, when the `type` of the user is `person`.",
                "properties": {
                  "email": {
                    "type": "string",
                    "description": "The email of the person."
                  },
                  "email_verified": {
                    "type": "boolean",
                    "description": "Whether the person's email is verified."
                  }
                },
                "additionalProperties": false
              }
            },
            "required": [
              "id",
              "object",
              "name",
              "avatar_url",
              "type",
              "person"
            ],
            "additionalProperties": false
          },
          {
            "type": "object",
            "properties": {
              "id": {
                "$ref": "#/$defs/idResponse"
              },
              "object": {
                "type": "string",
                "description": "The user object type name.",
                "const": "user"
              },
              "name": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "The name of the user."
              },
              "avatar_url": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "The avatar URL of the user."
              },
              "type": {
                "type": "string",
                "description": "Indicates this user is a bot.",
                "const": "bot"
              },
              "bot": {
                "description": "Details about the bot, when the `type` of the user is `bot`.",
                "anyOf": [
                  {
                    "$ref": "#/$defs/emptyObject"
                  },
                  {
                    "$ref": "#/$defs/botInfoResponse"
                  }
                ]
              }
            },
            "required": [
              "id",
              "object",
              "name",
              "avatar_url",
              "type",
              "bot"
            ],
            "additionalProperties": false
          }
        ]
      },
      "meta": {
        "type": "object",
        "description": "Additional response metadata (status, paging).",
        "additionalProperties": true
      }
    },
    "required": [
      "data"
    ],
    "additionalProperties": false,
    "$defs": {
      "idResponse": {
        "type": "string",
        "format": "uuid"
      },
      "emptyObject": {
        "type": "object",
        "properties": {},
        "additionalProperties": false
      },
      "botInfoResponse": {
        "type": "object",
        "properties": {
          "owner": {
            "description": "Details about the owner of the bot.",
            "anyOf": [
              {
                "type": "object",
                "properties": {
                  "type": {
                    "type": "string",
                    "description": "Always `user`",
                    "const": "user"
                  },
                  "user": {
                    "description": "Details about the owner of the bot, when the `type` of the owner is `user`. This means the bot is for a integration.",
                    "anyOf": [
                      {
                        "type": "object",
                        "properties": {
                          "id": {
                            "$ref": "#/$defs/idResponse"
                          },
                          "object": {
                            "type": "string",
                            "description": "The user object type name.",
                            "const": "user"
                          },
                          "name": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "The name of the user."
                          },
                          "avatar_url": {
                            "type": [
                              "string",
                              "null"
                            ],
                            "description": "The avatar URL of the user."
                          },
                          "type": {
                            "type": "string",
                            "description": "The type of the user.",
                            "const": "person"
                          },
                          "person": {
                            "type": "object",
                            "description": "The person info of the user.",
                            "properties": {
                              "email": {
                                "type": "string",
                                "description": "The email of the person."
                              },
                              "email_verified": {
                                "type": "boolean",
                                "description": "Whether the person's email is verified."
                              }
                            },
                            "additionalProperties": false
                          }
                        },
                        "required": [
                          "id",
                          "object",
                          "name",
                          "avatar_url",
                          "type",
                          "person"
                        ],
                        "additionalProperties": false
                      },
                      {
                        "$ref": "#/$defs/partialUserObjectResponse"
                      }
                    ]
                  }
                },
                "required": [
                  "type",
                  "user"
                ],
                "additionalProperties": false
              },
              {
                "type": "object",
                "properties": {
                  "type": {
                    "type": "string",
                    "description": "Always `workspace`",
                    "const": "workspace"
                  },
                  "workspace": {
                    "type": "boolean",
                    "description": "Details about the owner of the bot, when the `type` of the owner is `workspace`. This means the bot is for an internal integration.",
                    "const": true
                  }
                },
                "required": [
                  "type",
                  "workspace"
                ],
                "additionalProperties": false
              }
            ]
          },
          "workspace_id": {
            "type": "string",
            "description": "The ID of the bot's workspace."
          },
          "workspace_limits": {
            "type": "object",
            "description": "Limits and restrictions that apply to the bot's workspace",
            "properties": {
              "max_file_upload_size_in_bytes": {
                "type": "integer",
                "description": "The maximum allowable size of a file upload, in bytes",
                "minimum": 0
              }
            },
            "required": [
              "max_file_upload_size_in_bytes"
            ],
            "additionalProperties": false
          },
          "workspace_name": {
            "type": [
              "string",
              "null"
            ],
            "description": "The name of the bot's workspace."
          }
        },
        "required": [
          "owner",
          "workspace_id",
          "workspace_limits",
          "workspace_name"
        ],
        "additionalProperties": false
      },
      "partialUserObjectResponse": {
        "type": "object",
        "properties": {
          "id": {
            "$ref": "#/$defs/idResponse"
          },
          "object": {
            "type": "string",
            "description": "Always `user`",
            "const": "user"
          }
        },
        "required": [
          "id",
          "object"
        ],
        "additionalProperties": false
      }
    }
  }
  ```
</details>

## Deepline cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.

## Related documentation

* [Notion provider guide](https://deepline.com/docs/providers/notion/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.