---
title: "Remove Agents relationship"
method: DELETE
path: "/api/v2/ui/agents/{id}/relationships/accessGroups"
tags: ["Agents"]
---

# Remove Agents relationship

`DELETE /api/v2/ui/agents/{id}/relationships/accessGroups`

## Request

- Base URL: `https://docs.hashtopolis.org`
- URL: `https://docs.hashtopolis.org/api/v2/ui/agents/{id}/relationships/accessGroups`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/hashtopolis/apis/hashtopolis-api/docs/api/v2/ui/agents/:id/relationships/accessGroups/delete.ts> (a function with typed inputs; its response is checked against the schema)

Remove Agents relationship

## Path parameters

- `id` integer, required

## Request body

- AgentRelationAccessGroups
  - `data` object[], required
    - `type` 'accessGroup', required
    - `id` integer, required

## Response `204`

successfully deleted

## Other responses

- `400`: Invalid request
- `401`: Authentication failed
- `403`: Permission denied
- `404`: Not Found

## Changes

- **2026-10-22** `559b0274a0c8`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hashtopolis/apis/hashtopolis-api/changes/api/v2/ui/agents/:id/relationships/accessGroups/delete.md)

---

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