---
title: "Get a space"
method: POST
path: "/bot{token}/getSpace"
tags: ["Bot"]
---

# Get a space

`POST /bot{token}/getSpace`

Returns one accessible space, the bot's own membership, and bot-relevant settings without exposing the member roster.

## Path parameters

- `token` string, required

## Headers

- `authorization` string

## Request body

- GetSpaceInput — Returns one accessible space and only the bot's own membership.
  - `space_id` integer, required — A positive Inline space identifier

## Response `200`

Successful getSpace response.

- BotGetSpaceSuccess — Successful getSpace response.
  - `ok` true, required — Always true for a successful request.
  - `result` object, required — Method-specific response payload.
    - `space` BotSpace, required
      - `id` integer, required — A positive Inline space identifier
      - `name` string, required
      - `is_public` boolean
      - `handle` string
    - `membership` BotSpaceMember, required
      - `id` integer, required — A positive integer that can be represented exactly by a JavaScript number
      - `space_id` integer, required — A positive Inline space identifier
      - `user_id` integer, required — A positive Inline user identifier
      - `role` 'owner' | 'admin' | 'member'
      - `date` integer, required — A non-negative integer that can be represented exactly by a JavaScript number
      - `can_access_public_chats` boolean, required
    - `settings` object, required
      - `grid_enabled` boolean, required

## Other responses

- `400` — The request parameters are missing or invalid.
- `401` — The bot token is missing or invalid.
- `403` — The bot is not allowed to perform this action.
- `404` — The requested method or resource was not found.
- `500` — The server could not complete the request.

---

[API](https://skmtc.dev/inline/apis/inline-bot-http-api-docs.md) · [All operations](https://skmtc.dev/inline/apis/inline-bot-http-api-docs/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/inline/inline-bot-http-api-docs/revisions/69017b8dc5fe/schema)