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

# Endpoints API

> Manage customer webhook destinations.

# Endpoints API

## List endpoints

```http theme={null}
GET /v1/endpoints
```

## Create endpoint

```http theme={null}
POST /v1/endpoints
```

### Request body

```json theme={null}
{
  "url": "https://example.com/webhooks/praeto",
  "description": "Production endpoint",
  "subscribed_events": ["order.created", "invoice.paid"]
}
```

The signing secret is returned only on create and rotate.

## Get endpoint

```http theme={null}
GET /v1/endpoints/{endpoint_id}
```

## Update endpoint

```http theme={null}
PATCH /v1/endpoints/{endpoint_id}
```

## Rotate endpoint secret

```http theme={null}
POST /v1/endpoints/{endpoint_id}/rotate-secret
```

## Endpoint health

```http theme={null}
GET /v1/endpoints/{endpoint_id}/health
```