---
title: "The JSON Schema of every event's data, and the payload versions."
method: GET
path: "/v1/webhooks/schemas"
tags: ["webhooks"]
---

# The JSON Schema of every event's data, and the payload versions.

`GET /v1/webhooks/schemas`

## Request

- Base URL: `https://api.50heads.com`
- URL: `https://api.50heads.com/v1/webhooks/schemas`
- Auth: none required

Payloads are additive inside a version: new optional fields may appear; existing fields never change meaning or disappear.

## Response `200`

OK

- WebhooksSchemasResponse
  - `apiVersions` string[], required
  - `latest` '2026-10-10', required
  - `events` object, required
    - `question.reserved` object, required: JSON Schema of question.reserved data.
    - `question.completed` object, required: JSON Schema of question.completed data.
    - `question.underfilled` object, required: JSON Schema of question.underfilled data.
    - `question.canceled` object, required: JSON Schema of question.canceled data.
    - `question.refused` object, required: JSON Schema of question.refused data.
    - `credits.purchased` object, required: JSON Schema of credits.purchased data.
    - `credits.low` object, required: JSON Schema of credits.low data.
    - `credits.expiring` object, required: JSON Schema of credits.expiring data.
    - `dispute.resolved` object, required: JSON Schema of dispute.resolved data.
    - `connection.cap_warning` object, required: JSON Schema of connection.cap_warning data.
    - `webhook.test` object, required: JSON Schema of webhook.test data.
    - `member.provisioned` object, required: JSON Schema of member.provisioned data.
    - `member.deprovisioned` object, required: JSON Schema of member.deprovisioned data.
    - `policy.changed` object, required: JSON Schema of policy.changed data.
    - `approval.requested` object, required: JSON Schema of approval.requested data.
    - `approval.decided` object, required: JSON Schema of approval.decided data.
    - `approval.expired` object, required: JSON Schema of approval.expired data.
    - `approval.refused` object, required: JSON Schema of approval.refused data.
    - `workspace.created` object, required: JSON Schema of workspace.created data.
    - `workspace.moved` object, required: JSON Schema of workspace.moved data.
    - `workspace.closed` object, required: JSON Schema of workspace.closed data.

## Other responses

- `429`: Too many requests; wait for Retry-After.

---

[API](https://skmtc.dev/50heads/apis/50heads-api.md) · [All operations](https://skmtc.dev/50heads/apis/50heads-api/llms.txt) · [OpenAPI document](https://skmtc.dev/50heads/apis/50heads-api/revisions/20175e8b00e3?raw)