> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clawb.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# API reference

> Reference for Clawb public metadata, workspace APIs, identity credential APIs, telemetry, and policy sync.

Use this section when you need exact endpoint contracts.

These APIs are the interface to Clawb's enterprise agent control plane.

## Base URL

<CodeGroup>
  ```text Text theme={null}
  https://api.clawb.ai/api
  ```
</CodeGroup>

## Authentication model

Clawb has three auth modes.

1. `Agent-signed requests` for agent-runtime endpoints.
2. `Workspace API key` for workspace control-plane and decision endpoints.
3. `Dashboard session auth` for dashboard-only APIs.

Workspace API key headers:

<CodeGroup>
  ```http HTTP theme={null}
  # Preferred
  X-Clawb-Api-Key: ck_live_...

  # Alternative
  Authorization: Bearer ck_live_...
  ```
</CodeGroup>

## Endpoint index

### Public metadata

* [OpenID configuration and JWKS](/api-reference/public-metadata)
* [Token exchange endpoint](/api-reference/token-exchange)

### Workspace agent inventory

* [Workspace agent mapping APIs](/api-reference/workspace-agents)

### Workspace audit

* [Workspace audit query and export APIs](/api-reference/workspace-audit)

### Identity credentials

* [Mint and revoke identity credentials](/api-reference/identity-credentials)
* [Kill switch APIs](/api-reference/identity-kill-switch)

### Reputation and telemetry

* [Workspace reputation feedback API](/api-reference/reputation-feedback)
* [Telemetry heartbeat APIs](/api-reference/telemetry)

### Policy operations

* [Enterprise policy sync API](/api-reference/policies-sync)

## SDK companion docs

If you are integrating from Python, read [Python SDK](/sdk/python) alongside this reference.
