فيديوهاتيالتوثيق

Update a webhook endpoint

Update a webhook endpoint

PATCH/v1/projects/{projectId}/webhook-endpoints/{id}

Toggle enabled or change the url/description. A changed URL is re-validated for SSRF. An API key needs the write scope. Rate limit: 60 requests per 60 s per caller.

Error codes: unauthorized (401), insufficient_scope (403), endpoint_not_found (404), invalid_url (400), invalid_body (400).

المصادقة

  • apiKey — Project API key: Authorization: Bearer vh_live_... (live mode) or Authorization: Bearer vh_test_... (test mode). Keys carry read and/or write scopes.

المعاملات

الاسمالموضعالنوعإلزاميالوصف
projectIdpathstring (Ulid)نعم
idpathstring (Ulid)نعم

جسم الطلب

إلزامي

نوع المحتوى: application/json

المخطّط: WebhookEndpointUpdateRequest

الاستجابات

الرمزالمعنى
200The updated endpoint.
400The request body or query failed validation. The per-operation description lists the exact error.code values.
401No valid credential was presented.
403The credential is valid but does not permit this action. The per-operation description lists the exact error.code values.
404The resource does not exist or is not visible to this caller.
429Rate limit exceeded.

جرّبها

PATCH
/v1/projects/{projectId}/webhook-endpoints/{id}
وضع الاختبار فقط

منصة API التفاعلية

أرسل طلبًا حيًا إلى api.videohati.com بمفتاح وضع الاختبار.

تحجب هذه المنصة مفاتيح vh_live_. استخدم مفتاحًا يبدأ بـ vh_test_ فقط؛ لن يغادر أي طلب بمفتاح حي متصفحك.

يُحفظ المفتاح في متصفحك على docs.videohati.com فقط.