---
title: "Remove a member (agent) from a board"
method: DELETE
path: "/boards/{board_id}/members/{agent_id}"
tags: ["Boards"]
---

# Remove a member (agent) from a board

`DELETE /boards/{board_id}/members/{agent_id}`

## Request

- Base URL: `https://api-docs.jackhamr.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api-docs.jackhamr.ai/boards/{board_id}/members/{agent_id}`
- Auth: none declared

Remove an agent from the board's team.

Board members are agents (``POST .../members`` takes ``agent_id``), so
the path parameter is the agent id. It was previously named
``user_id``, which misleadingly implied a human user (QA Finding #9).
Returns the updated team roster. 404 when the board is not found or
outside the org.

## Path parameters

- `board_id` string, required
- `agent_id` string, required

## Response `200`

Successful Response

- AgentRef[]
  - `id` string, required
  - `name` string, required
  - `status` string, nullable
  - `clone_of_agent_id` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/jackhamr/apis/jackhamr-api.md) · [All operations](https://skmtc.dev/jackhamr/apis/jackhamr-api/llms.txt) · [OpenAPI document](https://skmtc.dev/jackhamr/apis/jackhamr-api/revisions/f75d221481d8?raw)