# Webhooks

## Returns the list of webhooks.

> The webhooks are sorted by creation date, with the most recent webhook appearing first.

```json
{"openapi":"3.1.0","info":{"title":"Rialto Manager API","version":"1.0.0"},"servers":[{"url":"https://api.rialtobridge.xyz/api/manager/v1","description":"Main (production) server for the Rialto Manager API"},{"url":"https://staging.api.rialtobridge.xyz/api/manager/v1","description":"Test (staging) server for the Rialto Manager API"},{"url":"http://localhost:3002/api/manager/v1","description":"Development server for the Rialto Manager API"}],"security":[{"api_key":[]}],"components":{"securitySchemes":{"api_key":{"type":"apiKey","name":"RIALTO_API_KEY","in":"header"}},"schemas":{"Webhook":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The unique identifier of the webhook."},"url":{"type":"string","format":"uri","description":"The URL of the webhook."},"createdAt":{"type":"string","format":"date-time","description":"The creation date of the webhook."},"updatedAt":{"type":"string","format":"date-time","description":"The last update date of the webhook."}}}}},"paths":{"/webhooks":{"get":{"summary":"Returns the list of webhooks.","description":"The webhooks are sorted by creation date, with the most recent webhook appearing first.","operationId":"getWebhooks","tags":["Webhooks"],"responses":{"200":{"description":"A JSON array of webhooks.","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Webhook"}}}}},"401":{"description":"Invalid API key"},"500":{"description":"An unexpected error occurred."}}}}}}
```

## Creates a webhook.

> Creates a webhook with the specified URL.\<br /> A webhook secret is generated and returned in the response. It is used to sign the webhook payloads.<br>

```json
{"openapi":"3.1.0","info":{"title":"Rialto Manager API","version":"1.0.0"},"servers":[{"url":"https://api.rialtobridge.xyz/api/manager/v1","description":"Main (production) server for the Rialto Manager API"},{"url":"https://staging.api.rialtobridge.xyz/api/manager/v1","description":"Test (staging) server for the Rialto Manager API"},{"url":"http://localhost:3002/api/manager/v1","description":"Development server for the Rialto Manager API"}],"security":[{"api_key":[]}],"components":{"securitySchemes":{"api_key":{"type":"apiKey","name":"RIALTO_API_KEY","in":"header"}}},"paths":{"/webhooks":{"post":{"summary":"Creates a webhook.","description":"Creates a webhook with the specified URL.<br /> A webhook secret is generated and returned in the response. It is used to sign the webhook payloads.\n","operationId":"createWebhook","tags":["Webhooks"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"url":{"type":"string","format":"uri","description":"The URL of the webhook."}},"required":["url"]}}}},"responses":{"201":{"description":"The webhook has been created.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The unique identifier of the webhook."},"url":{"type":"string","format":"uri","description":"The URL of the webhook."},"secret":{"type":"string","description":"The secret used to sign the webhook payloads."},"createdAt":{"type":"string","format":"date-time","description":"The creation date of the webhook."},"updatedAt":{"type":"string","format":"date-time","description":"The last update date of the webhook."}}}}}},"400":{"description":"The request is invalid.","content":{"application/json":{"schema":{"type":"object","properties":{"reason":{"type":"string","description":"The reason why the request is invalid."},"parameterErrors":{"type":["object","null"],"description":"The errors related to the parameters of the request.<br /> The object is null if there is no error related to the parameters.\n"}}}}}},"401":{"description":"Invalid API key"},"500":{"description":"An unexpected error occurred."}}}}}}
```

## Returns a webhook by ID.

> Returns a webhook by its unique identifier.

```json
{"openapi":"3.1.0","info":{"title":"Rialto Manager API","version":"1.0.0"},"servers":[{"url":"https://api.rialtobridge.xyz/api/manager/v1","description":"Main (production) server for the Rialto Manager API"},{"url":"https://staging.api.rialtobridge.xyz/api/manager/v1","description":"Test (staging) server for the Rialto Manager API"},{"url":"http://localhost:3002/api/manager/v1","description":"Development server for the Rialto Manager API"}],"security":[{"api_key":[]}],"components":{"securitySchemes":{"api_key":{"type":"apiKey","name":"RIALTO_API_KEY","in":"header"}},"schemas":{"Webhook":{"type":"object","properties":{"id":{"type":"string","format":"uuid","description":"The unique identifier of the webhook."},"url":{"type":"string","format":"uri","description":"The URL of the webhook."},"createdAt":{"type":"string","format":"date-time","description":"The creation date of the webhook."},"updatedAt":{"type":"string","format":"date-time","description":"The last update date of the webhook."}}}}},"paths":{"/webhooks/{webhookId}":{"get":{"summary":"Returns a webhook by ID.","description":"Returns a webhook by its unique identifier.","operationId":"getWebhookById","tags":["Webhooks"],"responses":{"200":{"description":"A webhook.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Webhook"}}}},"401":{"description":"Invalid API key"},"404":{"description":"Webhook not found."},"500":{"description":"An unexpected error occurred."}}}}}}
```

## Deletes a webhook by ID.

> Deletes a webhook by its unique identifier.

```json
{"openapi":"3.1.0","info":{"title":"Rialto Manager API","version":"1.0.0"},"servers":[{"url":"https://api.rialtobridge.xyz/api/manager/v1","description":"Main (production) server for the Rialto Manager API"},{"url":"https://staging.api.rialtobridge.xyz/api/manager/v1","description":"Test (staging) server for the Rialto Manager API"},{"url":"http://localhost:3002/api/manager/v1","description":"Development server for the Rialto Manager API"}],"security":[{"api_key":[]}],"components":{"securitySchemes":{"api_key":{"type":"apiKey","name":"RIALTO_API_KEY","in":"header"}}},"paths":{"/webhooks/{webhookId}":{"delete":{"summary":"Deletes a webhook by ID.","description":"Deletes a webhook by its unique identifier.","operationId":"deleteWebhookById","tags":["Webhooks"],"responses":{"204":{"description":"The webhook has been deleted."},"401":{"description":"Invalid API key"},"404":{"description":"Webhook not found."},"500":{"description":"An unexpected error occurred."}}}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.rialtobridge.xyz/manager-api-reference/webhooks.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.