Skip to content
Authrim

Update a webhook configuration.

PUT
/api/admin/webhooks/{id}
Code sample: Shell / cURL 
curl --request PUT \
  --url https://auth.example.com/api/admin/webhooks/example \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "name": "example", "url": "https://example.com", "events": [ "example" ], "secret": "example", "headers": { "additionalProperty": "example" }, "retryPolicy": { "maxRetries": 1, "initialDelayMs": 1, "backoffMultiplier": 1, "maxDelayMs": 1 }, "timeoutMs": 1, "active": true }'

Replace Webhook in the Webhooks area. The request body is JSON unless the detailed schema for this operation states otherwise.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
id
required
string

Header Parameters

Section titled “Header Parameters ”
X-Tenant-Id
string

Tenant selector for multi-tenant admin requests.

Request Body required

Section titled “Request Body required ”
Media type application/json
object
name
string
>= 1 characters
url
string format: uri
events
Array<string>
>= 1 items
secret
string
headers
object
key
additional properties
string
retryPolicy
object
maxRetries
integer
<= 10
initialDelayMs
integer
backoffMultiplier
number
>= 1
maxDelayMs
integer
key
additional properties
timeoutMs
integer
>= 1000 <= 60000
active
boolean
key
additional properties
Example generated
{
  "name": "example",
  "url": "https://example.com",
  "events": [
    "example"
  ],
  "secret": "example",
  "headers": {
    "additionalProperty": "example"
  },
  "retryPolicy": {
    "maxRetries": 1,
    "initialDelayMs": 1,
    "backoffMultiplier": 1,
    "maxDelayMs": 1
  },
  "timeoutMs": 1,
  "active": true
}

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Webhook updated.

Media type application/json
object
success
required
boolean
webhook
One of:
object
id
string
tenantId
string
clientId
string | null
scope
string
name
string
url
string format: uri
events
Array<string>
hasSecret
boolean
headers
object
key
additional properties
string
retryPolicy
object
maxRetries
integer
<= 10
initialDelayMs
integer
backoffMultiplier
number
>= 1
maxDelayMs
integer
key
additional properties
timeoutMs
integer
active
boolean
createdAt
string
updatedAt
string
lastSuccessAt
string | null
lastFailureAt
string | null
key
additional properties
Example generated
{
  "success": true,
  "webhook": {
    "id": "example",
    "tenantId": "example",
    "clientId": "example",
    "scope": "example",
    "name": "example",
    "url": "https://example.com",
    "events": [
      "example"
    ],
    "hasSecret": true,
    "headers": {
      "additionalProperty": "example"
    },
    "retryPolicy": {
      "maxRetries": 1,
      "initialDelayMs": 1,
      "backoffMultiplier": 1,
      "maxDelayMs": 1
    },
    "timeoutMs": 1,
    "active": true,
    "createdAt": "example",
    "updatedAt": "example",
    "lastSuccessAt": "example",
    "lastFailureAt": "example"
  }
}

400

Section titled “400 ”

Error response.

Media type application/json
object
error
string
message
string
error_description
string
key
additional properties
Example generated
{
  "error": "example",
  "message": "example",
  "error_description": "example"
}

404

Section titled “404 ”

Error response.

Media type application/json
object
error
string
message
string
error_description
string
key
additional properties
Example generated
{
  "error": "example",
  "message": "example",
  "error_description": "example"
}