---
title: "Submit a usage snapshot"
method: POST
path: "/v1/beacon/usage-snapshot"
tags: ["beacon"]
---

# Submit a usage snapshot

`POST /v1/beacon/usage-snapshot`

Records aggregate entity counts (workspaces, projects, datasets, active users, etc.)
from a self-hosted deployment or BYOC data plane.
Self-hosted authenticates via license_key in the body.
BYOC data planes authenticate via the X-Data-Plane-Auth JWT header.

## Request body

- BeaconSubmitUsageSnapshotPayload
  - `from_timestamp` string
  - `license_key` string
  - `measures` object
  - `to_timestamp` string

## Response `204`

No Content

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal Server Error

---

[API](https://skmtc.net/langchain-ai/apis/langsmith.md) · [All operations](https://skmtc.net/langchain-ai/apis/langsmith/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/langchain-ai/langsmith/revisions/a0acb3a6a101/schema)