Skip to content
Kalipto Devs Platform — API Docs

Update Subscription

PATCH
/platform/v1/webhooks/subscriptions/{sub_id}
 
curl --request PATCH \
  --url https://example.com/platform/v1/webhooks/subscriptions/1 \
  --header 'Content-Type: application/json' \
  --data '{ "buffer_max_batch": 1, "buffer_window_seconds": 1, "custom_headers": { "additionalProperty": "example" }, "description": "example", "event_types": [ "example" ], "inactivity_minutes": 1, "is_active": true, "platform_channel_id": 1, "target_url": "https://example.com" }'

Partial update.

  • Re-running target_url triggers the SSRF guard again.
  • event_types validator runs in the schema (422 on unknown).
  • platform_channel_id must belong to the account (422 on miss).

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
sub_id
required
Sub Id
integer

Request Body required

Section titled “Request Body required ”
Media type application/json
PlatformWebhookSubscriptionUpdate

Partial update of a normalized subscription.

object
buffer_max_batch
Any of:
integer
>= 1 <= 100
buffer_window_seconds
Any of:
integer
>= 1 <= 60
custom_headers
Any of:
object
key
additional properties
string
description
Any of:
string
<= 200 characters
event_types
Any of:
Array<string>
inactivity_minutes
Any of:
integer
>= 1 <= 1440
is_active
Any of:
boolean
platform_channel_id
Any of:
integer
target_url
Any of:
string format: uri
>= 1 characters <= 2083 characters
Example generated
{
  "buffer_max_batch": 1,
  "buffer_window_seconds": 1,
  "custom_headers": {
    "additionalProperty": "example"
  },
  "description": "example",
  "event_types": [
    "example"
  ],
  "inactivity_minutes": 1,
  "is_active": true,
  "platform_channel_id": 1,
  "target_url": "https://example.com"
}

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Successful Response

Media type application/json
PlatformWebhookSubscriptionResponse

Subscription response — NEVER includes secret_encrypted.

object
buffer_max_batch
Any of:
integer
buffer_window_seconds
Any of:
integer
created_at
Any of:
string format: date-time
custom_headers
Any of:
object
key
additional properties
string
description
Any of:
string
developer_account_id
required
Developer Account Id
integer
event_types
Event Types
Array<string>
failure_count
required
Failure Count
integer
id
required
Id
integer
inactivity_minutes
Any of:
integer
is_active
required
Is Active
boolean
is_paused
required
Is Paused
boolean
last_delivery_at
Any of:
string format: date-time
paused_reason
Any of:
string
platform_channel_id
Any of:
integer
target_url
required
Target Url
string
updated_at
Any of:
string format: date-time
Example generated
{
  "buffer_max_batch": 1,
  "buffer_window_seconds": 1,
  "created_at": "2026-04-15T12:00:00Z",
  "custom_headers": {
    "additionalProperty": "example"
  },
  "description": "example",
  "developer_account_id": 1,
  "event_types": [
    "example"
  ],
  "failure_count": 1,
  "id": 1,
  "inactivity_minutes": 1,
  "is_active": true,
  "is_paused": true,
  "last_delivery_at": "2026-04-15T12:00:00Z",
  "paused_reason": "example",
  "platform_channel_id": 1,
  "target_url": "example",
  "updated_at": "2026-04-15T12:00:00Z"
}

422

Section titled “422 ”

Validation Error

Media type application/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
ctx
Context
object
input
Input
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Example generated
{
  "detail": [
    {
      "ctx": {},
      "input": "example",
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example"
    }
  ]
}