---
title: "Grant or revoke the 'used by' logo consent"
method: POST
path: "/api/used-by"
tags: ["Telemetry"]
---

# Grant or revoke the 'used by' logo consent

`POST /api/used-by`

## Request

- Base URL: `http://localhost:3013`
- URL: `http://localhost:3013/api/used-by`
- Auth: HTTP bearer

Records consent to show the organization's logo on agent-swarm.dev. A grant requires a valid contact email. It sends organization identity, contact details, and an optional quote to the proxy for manual review. This explicit admin action works when telemetry is off. A revoke clears the stored contact details and quote.

## Request body

- object
  - `granted` boolean, required
  - `contactEmail` string, email
  - `contactFunction` 'engineer' | 'eng_lead' | 'founder' | 'product' | 'marketing' | 'sales' | 'research' | 'ops' | 'other'
  - `quote` string

## Response `200`

Consent recorded

- object
  - `granted` boolean, required
  - `changedAt` string, required

## Other responses

- `400`: Invalid contact details, or missing organization name or website
- `401`: Unauthorized
- `403`: Only a config admin can change the consent
- `502`: The telemetry proxy did not accept the consent

## Changes

- **2026-10-25** `d944b5ab6201`: 3 info
  - added the new `marketing` enum value to the request property `contactFunction`
  - added the new `research` enum value to the request property `contactFunction`
  - added the new `sales` enum value to the request property `contactFunction`
- **2026-10-19** `f6ab201accbf`: 3 info
  - added the new optional request property `contactEmail`
  - added the new optional request property `contactFunction`
  - added the new optional request property `quote`
- **2026-10-12** `4096a267550c`: 1 info
  - endpoint added
- **2026-10-12** `90c376f780df`: 1 breaking
  - api path removed without deprecation
- **2026-10-12** `9ea4863df376`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/desplega-ai/apis/agent-swarm-api/changes/api/used-by/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)