---
title: "Leave the public ranking"
method: POST
path: "/api/ranking/opt-out"
tags: ["Telemetry"]
---

# Leave the public ranking

`POST /api/ranking/opt-out`

## Request

- Base URL: `http://localhost:3013`
- URL: `http://localhost:3013/api/ranking/opt-out`
- Auth: HTTP bearer

Turns PUBLIC_RANKING_ENABLED off and sends ranking.opted_out, so workers stop sending ranking.usage. The install leaves agent-swarm.dev/ranking at the next hourly refresh.

## Response `200`

Opted out

- object
  - `enabled` false, required

## Other responses

- `401`: Unauthorized
- `403`: Only a config admin can opt out

## Changes

- **2026-10-19** `915daaf44761`: 1 breaking
  - removed the required property `leaveUrl` from the response with the `200` status
- **2026-10-19** `9cbdf0c80fac`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/changes/api/ranking/opt-out/post.md)

---

[API](https://skmtc.dev/desplega-ai/apis/agent-swarm-api.md) - [All operations](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/llms.txt) - [OpenAPI document](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/revisions/7e4c7198192a?raw)