|
5781 | 5781 | }, |
5782 | 5782 | "value": { |
5783 | 5783 | "description": "The value to use for add/replace/test operations. Can be any JSON value per RFC 6902 (string, number, boolean, object, array, or null).", |
5784 | | - "nullable": true, |
5785 | 5784 | "oneOf": [ |
5786 | 5785 | { |
5787 | | - "type": "string" |
| 5786 | + "type": "string", |
| 5787 | + "nullable": true |
5788 | 5788 | }, |
5789 | 5789 | { |
5790 | 5790 | "type": "number" |
|
24703 | 24703 | "/webhooks/subscriptions": { |
24704 | 24704 | "get": { |
24705 | 24705 | "summary": "List webhook subscriptions", |
24706 | | - "description": "List all webhook subscriptions owned by the authenticated user. Optionally filter by threat_model_id.", |
| 24706 | + "description": "List all webhook subscriptions. Requires administrator privileges.", |
24707 | 24707 | "operationId": "listWebhookSubscriptions", |
24708 | 24708 | "tags": [ |
24709 | 24709 | "webhooks" |
|
24878 | 24878 | }, |
24879 | 24879 | "post": { |
24880 | 24880 | "summary": "Create webhook subscription", |
24881 | | - "description": "Create a new webhook subscription. The subscription will be in pending_verification status until the challenge is completed.", |
| 24881 | + "description": "Create a new webhook subscription. Requires administrator privileges. The subscription will be in pending_verification status until the challenge is completed.", |
24882 | 24882 | "operationId": "createWebhookSubscription", |
24883 | 24883 | "tags": [ |
24884 | 24884 | "webhooks" |
|
25121 | 25121 | "/webhooks/subscriptions/{webhook_id}": { |
25122 | 25122 | "get": { |
25123 | 25123 | "summary": "Get webhook subscription", |
25124 | | - "description": "Get a specific webhook subscription by ID", |
| 25124 | + "description": "Retrieve details of a specific webhook subscription. Requires administrator privileges.", |
25125 | 25125 | "operationId": "getWebhookSubscription", |
25126 | 25126 | "tags": [ |
25127 | 25127 | "webhooks" |
|
25319 | 25319 | }, |
25320 | 25320 | "delete": { |
25321 | 25321 | "summary": "Delete webhook subscription", |
25322 | | - "description": "Delete a webhook subscription. Only the owner can delete a subscription.", |
| 25322 | + "description": "Delete a webhook subscription and all its associated deliveries. Requires administrator privileges.", |
25323 | 25323 | "operationId": "deleteWebhookSubscription", |
25324 | 25324 | "tags": [ |
25325 | 25325 | "webhooks" |
|
25512 | 25512 | "/webhooks/subscriptions/{webhook_id}/test": { |
25513 | 25513 | "post": { |
25514 | 25514 | "summary": "Test webhook subscription", |
25515 | | - "description": "Send a test event to the webhook URL to verify it's working correctly", |
| 25515 | + "description": "Send a test event to the webhook endpoint. Requires administrator privileges. Returns a delivery ID that can be used to track the test delivery status.", |
25516 | 25516 | "operationId": "testWebhookSubscription", |
25517 | 25517 | "tags": [ |
25518 | 25518 | "webhooks" |
|
25723 | 25723 | "/webhooks/deliveries": { |
25724 | 25724 | "get": { |
25725 | 25725 | "summary": "List webhook deliveries", |
25726 | | - "description": "List webhook deliveries for the authenticated user's subscriptions", |
| 25726 | + "description": "List webhook deliveries. Requires administrator privileges. Optionally filter by subscription_id.", |
25727 | 25727 | "operationId": "listWebhookDeliveries", |
25728 | 25728 | "tags": [ |
25729 | 25729 | "webhooks" |
|
25900 | 25900 | "/webhooks/deliveries/{delivery_id}": { |
25901 | 25901 | "get": { |
25902 | 25902 | "summary": "Get webhook delivery", |
25903 | | - "description": "Get details of a specific webhook delivery", |
| 25903 | + "description": "Retrieve details of a specific webhook delivery including payload and delivery attempts. Requires administrator privileges.", |
25904 | 25904 | "operationId": "getWebhookDelivery", |
25905 | 25905 | "tags": [ |
25906 | 25906 | "webhooks" |
|
0 commit comments