---
title: "Join Space"
method: POST
path: "/spaces/join/{invite}"
tags: ["Spaces"]
---

# Join Space

`POST /spaces/join/{invite}`

## Response `200`

- SpaceExt — Represents a Mikoto Space.
  - `channels` Channel[], required
    - `id` string, uuid, required
    - `lastUpdated` string, date-time
    - `name` string, required
    - `order` integer, required
    - `parentId` string, uuid, nullable
    - `spaceId` string, uuid, nullable
    - `type` 'TEXT' | 'VOICE' | 'DOCUMENT' | 'APPLICATION' | 'THREAD' | 'CATEGORY', required
  - `handle` string, nullable — The space's handle (if claimed)
  - `icon` string, nullable
  - `id` string, uuid, required
  - `memberCount` integer, required
  - `name` string, required
  - `ownerId` string, uuid, nullable
  - `roles` Role[], required
    - `color` string, nullable
    - `id` string, uuid, required
    - `name` string, required
    - `permissions` string, required
    - `position` integer, required
    - `spaceId` string, uuid, required
  - `type` 'NONE' | 'DM' | 'GROUP', required
  - `visibility` 'PRIVATE' | 'PUBLIC'

---

[API](https://skmtc.net/mikotoio/apis/mikoto-superego.md) · [All operations](https://skmtc.net/mikotoio/apis/mikoto-superego/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mikotoio/mikoto-superego/revisions/2884da9c4ee0/schema)
