---
title: "Put Default"
method: PUT
path: "/webhooks/default"
tags: ["Webhooks"]
---

# Put Default

`PUT /webhooks/default`

## Request

- Base URL: `https://api.hedra.com/v3`
- URL: `https://api.hedra.com/v3/webhooks/default`
- Auth: one of:
  - API key in header `Authorization`
  - HTTP bearer

## Request body

- WebhookDefaultUpdate
  - `url` string, required: HTTPS endpoint to receive terminal webhooks for every job that names no per-job `webhook` on submit.
  - `enabled` boolean: Whether the default endpoint receives deliveries; false pauses it without discarding the URL.

## Response `200`

Successful Response

- WebhookDefaultConfig
  - `url` string, nullable: The stored default endpoint; null when none is configured.
  - `enabled` boolean: Whether the default endpoint is active.
  - `updated_at` string, date-time, nullable: ISO-8601 instant the config last changed.
  - `updated_by_key_id` string, nullable: The API key that last changed the config.

## Other responses

- `400`: Invalid or failed-validation request.
- `401`: Authentication failed: missing, malformed, or invalid credentials.
- `403`: Insufficient scope or plan.
- `404`: Resource not found.
- `429`: Rate limit exceeded.
- `500`: Internal error.

## Changes

- **2026-10-16** `06692d16e78a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/hedra-labs/apis/hedra-api/changes/webhooks/default/put.md)

---

[API](https://skmtc.dev/hedra-labs/apis/hedra-api.md) - [All operations](https://skmtc.dev/hedra-labs/apis/hedra-api/llms.txt) - [OpenAPI document](https://skmtc.dev/hedra-labs/apis/hedra-api/revisions/6ef35a11cefe?raw)