Update a webhook

Update the enabled status of a webhook. The webhook must belong to the current project.

PATCH

/webhooks/{webhookId}

Authorization

Authorization

header

string

required

Enter the project access token with the Bearer prefix, e.g. "Bearer project_access_token"

Path Parameters

webhookId

string

required

Webhook ID

Bodyapplication/json

Webhook update parameters

enabled

boolean

Enabled indicates whether the webhook should be enabled or disabled.

Examples:

true

events

string[]

Events specifies the types of events that will trigger the webhook.

Available options:

job.createdjob.completedjob.failedjob.cancelledsource.createdsource.deletedupload.createdupload.completedupload.failedupload.expiredasset.createdasset.readyasset.playback_readyasset.failedasset.expiredasset.deletedasset.output.createdasset.output.readyasset.output.failedasset.output.deletedworkflow_run.createdworkflow_run.completedworkflow_run.failedworkflow_run.cancelledtranscoding.createdtranscoding.readytranscoding.failedtranscoding.cancelledtranscoding.expiredtranscoding.deletedthumbnail.createdthumbnail.readythumbnail.failedthumbnail.expiredthumbnail.deleted

Examples:

["asset.playback_ready", "asset.failed"]

Responses

The webhook was updated successfully

application/json

error

object

required

Error response details

status

"error"

string

required

Status indicates the response status "error"

Authentication error: invalid token or subscription inactive

application/json

error

object

required

Error response details

status

"error"

string

required

Status indicates the response status "error"

Resource not found

application/json

error

object

required

Error response details

status

"error"

string

required

Status indicates the response status "error"

Rate limit exceeded

import Chunkify from '@chunkify/chunkify';

const client = new Chunkify({
  projectAccessToken: 'My Project Access Token',
});

await client.webhooks.update('webhookId');
from chunkify import Chunkify

client = Chunkify(
    project_access_token="My Project Access Token",
)
client.webhooks.update(
    webhook_id="webhookId",
)
<?php

use Chunkify\Client;

$client = new Client(
    projectAccessToken: 'My Project Access Token',
);

$client->webhooks->update('webhookId');
package main

import (
  "context"

  "github.com/chunkifydev/chunkify-go"
  "github.com/chunkifydev/chunkify-go/option"
)

func main() {
  client := chunkify.NewClient(
    option.WithProjectAccessToken("My Project Access Token"),
  )
  err := client.Webhooks.Update(
    context.TODO(),
    "webhookId",
    chunkify.WebhookUpdateParams{

    },
  )
  if err != nil {
    panic(err.Error())
  }
}

No content
{
  "error": {
    "code": 401,
    "message": "Authentication error: invalid token or subscription inactive",
    "type": "AuthenticationError"
  },
  "status": "error"
}
{
  "error": {
    "code": 404,
    "message": "Ressource not found",
    "type": "NotFoundError"
  },
  "status": "error"
}
{
  "error": {
    "code": 429,
    "message": "Rate limit exceeded",
    "type": "TooManyRequestsError"
  },
  "status": "error"
}

# Update a webhook > Update the enabled status of a webhook. The webhook must belong to the current project. ```json { "path": "/webhooks/{webhookId}", "method": "patch", "schema": { "description": "Update the enabled status of a webhook. The webhook must belong to the current project.", "operationId": "updateWebhook", "parameters": [ { "description": "Webhook ID", "in": "path", "name": "webhookId", "required": true, "schema": { "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WebhookUpdateParams" } } }, "description": "Webhook update parameters", "required": true, "x-originalParamName": "request" }, "responses": { "204": { "description": "The webhook was updated successfully" }, "401": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResponseErrorAuthentication" } } }, "description": "Authentication error: invalid token or subscription inactive" }, "404": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResponseErrorNotFound" } } }, "description": "Resource not found" }, "429": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResponseErrorTooManyRequests" } } }, "description": "Rate limit exceeded" } }, "security": [ { "ProjectAccessToken": [] } ], "summary": "Update a webhook", "tags": [ "Webhooks" ], "x-codeSamples": [ { "lang": "JavaScript", "source": "import Chunkify from '@chunkify/chunkify';\n\nconst client = new Chunkify({\n projectAccessToken: 'My Project Access Token',\n});\n\nawait client.webhooks.update('webhookId');" }, { "lang": "Python", "source": "from chunkify import Chunkify\n\nclient = Chunkify(\n project_access_token=\"My Project Access Token\",\n)\nclient.webhooks.update(\n webhook_id=\"webhookId\",\n)" }, { "lang": "php", "source": "\u003c?php\n\nuse Chunkify\\Client;\n\n$client = new Client(\n projectAccessToken: 'My Project Access Token',\n);\n\n$client-\u003ewebhooks-\u003eupdate('webhookId');" }, { "lang": "Go", "source": "package main\n\nimport (\n \"context\"\n\n \"github.com/chunkifydev/chunkify-go\"\n \"github.com/chunkifydev/chunkify-go/option\"\n)\n\nfunc main() {\n client := chunkify.NewClient(\n option.WithProjectAccessToken(\"My Project Access Token\"),\n )\n err := client.Webhooks.Update(\n context.TODO(),\n \"webhookId\",\n chunkify.WebhookUpdateParams{\n\n },\n )\n if err != nil {\n panic(err.Error())\n }\n}\n" } ] } } ``` ```json #/components/schemas/WebhookUpdateParams { "properties": { "enabled": { "description": "Enabled indicates whether the webhook should be enabled or disabled.", "examples": [ true ], "type": "boolean" }, "events": { "description": "Events specifies the types of events that will trigger the webhook.", "examples": [ "[\"asset.playback_ready\"\u0026comma; \"asset.failed\"]" ], "items": { "$ref": "#/components/schemas/WebhookEvent" }, "type": "array" } }, "type": "object" } ``` ```json #/components/schemas/WebhookEvent { "enum": [ "job.created", "job.completed", "job.failed", "job.cancelled", "source.created", "source.deleted", "upload.created", "upload.completed", "upload.failed", "upload.expired", "asset.created", "asset.ready", "asset.playback_ready", "asset.failed", "asset.expired", "asset.deleted", "asset.output.created", "asset.output.ready", "asset.output.failed", "asset.output.deleted", "workflow_run.created", "workflow_run.completed", "workflow_run.failed", "workflow_run.cancelled", "transcoding.created", "transcoding.ready", "transcoding.failed", "transcoding.cancelled", "transcoding.expired", "transcoding.deleted", "thumbnail.created", "thumbnail.ready", "thumbnail.failed", "thumbnail.expired", "thumbnail.deleted" ], "examples": [ "asset.playback_ready" ], "type": "string" } ``` ```json #/components/schemas/ResponseErrorAuthentication { "description": "Error response", "properties": { "error": { "description": "Error response details", "properties": { "code": { "const": 401, "description": "Code is the HTTP status code", "examples": [ 401 ], "type": "integer" }, "message": { "description": "Message is a human-readable error description", "examples": [ "Authentication error: invalid token or subscription inactive" ], "type": "string" }, "type": { "const": "AuthenticationError", "description": "Type indicates the error category", "enum": [ "AuthenticationError" ], "type": "string" } }, "required": [ "type", "code", "message" ], "type": "object" }, "status": { "const": "error", "description": "Status indicates the response status \"error\"", "type": "string" } }, "required": [ "status", "error" ], "type": "object" } ``` ```json #/components/schemas/ResponseErrorNotFound { "description": "Error response", "properties": { "error": { "description": "Error response details", "properties": { "code": { "const": 404, "description": "Code is the HTTP status code", "examples": [ 404 ], "type": "integer" }, "message": { "description": "Message is a human-readable error description", "examples": [ "Ressource not found" ], "type": "string" }, "type": { "const": "NotFoundError", "description": "Type indicates the error category", "enum": [ "NotFoundError" ], "type": "string" } }, "required": [ "type", "code", "message" ], "type": "object" }, "status": { "const": "error", "description": "Status indicates the response status \"error\"", "type": "string" } }, "required": [ "status", "error" ], "type": "object" } ``` ```json #/components/schemas/ResponseErrorTooManyRequests { "description": "Error response", "properties": { "error": { "description": "Error response details", "properties": { "code": { "const": 429, "description": "Code is the HTTP status code", "examples": [ 429 ], "type": "integer" }, "message": { "description": "Message is a human-readable error description", "examples": [ "Rate limit exceeded" ], "type": "string" }, "type": { "const": "TooManyRequestsError", "description": "Type indicates the error category", "enum": [ "TooManyRequestsError" ], "type": "string" } }, "required": [ "type", "code", "message" ], "type": "object" }, "status": { "const": "error", "description": "Status indicates the response status \"error\"", "type": "string" } }, "required": [ "status", "error" ], "type": "object" } ```