API Reference
Getting Started
Core Concepts
Backend API — Guides
Frontend API — Guides
OAuth & OpenID Connect — Guides
Enterprise: SSO & SCIM — Guides
Webhooks — Guides
SDKs
Backend API (BAPI)
Frontend API (FAPI)
Dashboard API
Public API
SCIM
OIDC
Platform

Bot Labels

AdminUpdated Sep 11, 2026

Bot Labels

Backend API — secret key (Authorization: Bearer sk_…).

2 routes. Each row is one endpoint with its explanation, required scope, and whether it honours the Idempotency-Key header.

Method & path

Scope

Idem

Explanation

GET /v1/bot_labels

bot_signals:read

Export the supervised training labels (bot / human / suspect) with their subject and source.

POST /v1/bot_labels

bot_signals:write

Add a supervised training label to a subject (user / device / ip_hash / attempt) — an analyst confirming a bot or a human. Same label set that banning-as-bot writes.

Was this page helpful?