---
title: "Block User"
method: POST
path: "/relations/{relationId}/block"
tags: ["Relations"]
---

# Block User

`POST /relations/{relationId}/block`

## Request

- The document declares no server URL.
- Auth: none declared

## Response `200`

- RelationshipExt: Relationship with extended data including the related user
  - `channelId` string, uuid, nullable
  - `id` string, uuid, required
  - `relationId` string, uuid, required
  - `state` 'NONE' | 'FRIEND' | 'BLOCKED' | 'INCOMING_REQUEST' | 'OUTGOING_REQUEST', required
  - `user` UserExt, required: User with extended data including handle
    - `avatar` string, nullable
    - `category` 'BOT' | 'UNVERIFIED', nullable
    - `description` string, nullable
    - `handle` string, nullable: The user's handle (if claimed)
    - `id` string, uuid, required
    - `name` string, required
    - `spaceOrder` string[], nullable: Persisted ordering of the user's spaces in the sidebar. Always present on responses; optional in the schema so the base `User` shape remains structurally assignable to `UserExt`.
  - `userId` string, uuid, required

## Changes

- **2026-05-19** `7d22ce9ed272`: 1 info
  - added the optional property `user/spaceOrder` to the response with the `200` status
- **2026-04-06** `0a10cd1321bf`: 1 info
  - endpoint added
- **2025-09-22** `2792e551a954`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/mikotoio/apis/mikoto-superego/changes/relations/:relationId/block/post.md)

---

[API](https://skmtc.dev/mikotoio/apis/mikoto-superego.md) - [All operations](https://skmtc.dev/mikotoio/apis/mikoto-superego/llms.txt) - [OpenAPI document](https://skmtc.dev/mikotoio/apis/mikoto-superego/revisions/55ae42443991?raw)
