---
title: "Add a server"
method: POST
path: "/discover/{name}"
tags: ["discovery"]
---

# Add a server

`POST /discover/{name}`

Queues a single server for discovery. Auth is optional: send Discovery credentials to skip the rate limit, or call anonymously and take the limit. We dial the server before answering, so the status code tells you what actually happened: 201 if it is reachable and freshly added, 208 if we already knew it, 422 if it would not answer (we record it offline rather than re-dial it on every retry).

## Path parameters

- `name` string, required

## Response `201`

Server was reachable and queued

## Other responses

- `208` — Server already known, nothing to do
- `401` — Invalid Discovery credentials (only if you send them)
- `422` — Server could not be reached, nothing added
- `429` — Rate limited (anonymous callers)

---

[API](https://skmtc.net/etkecc/apis/matrix-rooms-search-api.md) · [All operations](https://skmtc.net/etkecc/apis/matrix-rooms-search-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/etkecc/matrix-rooms-search-api/revisions/ae3c2fd65492/schema)