---
title: "Add Agents relationship"
method: POST
path: "/api/v2/ui/agents/{id}/relationships/{relation}"
tags: ["Agents"]
---

# Add Agents relationship

`POST /api/v2/ui/agents/{id}/relationships/{relation}`

POST request to create a to-one relationship link.

## Path parameters

- `id` integer, required
- `relation` string, required

## Response `204`

successfully created

## Other responses

- `400` — Invalid request
- `401` — Authentication failed
- `403` — Permission denied
- `404` — Not Found
- `409` — Resource already exists

---

[API](https://skmtc.dev/hashtopolis/apis/hashtopolis-api.md) · [All operations](https://skmtc.dev/hashtopolis/apis/hashtopolis-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hashtopolis/hashtopolis-api/revisions/62465883745a/schema)