Rotate a webhook signing secret (POST /organization/webhooks/{webhook_id}/rotate-secret) — Kite API
Skip to content
KitePlatform
Pricing
Browse endpoints
All endpoints

Reference data

  • List cities
  • List neighborhoods
  • List city directions
  • List enumerated values
  • Get this key's limits
  • What the API covers

Listings

  • Search listings
  • Count listings
  • Get listings by id
  • Get a listing
  • Get a listing's price history
  • Get a listing's advertiser contact

Market data

  • Market summary
  • Price distribution
  • Area distribution
  • New supply
  • Vacancy indicator
  • Prices by neighborhood
  • Commercial rent per m² by neighborhood
  • Plots for sale against their last registered sale
  • Registered sale price against the asking price
  • Places, population and landmarks around a point or in a neighborhood

Official data

  • Registered rents (REGA)
  • Kite Property Index

Analytics

  • Get comparable listings
  • Get a listing's market position
  • Get a listing's nearby asking-price band
  • Find below-market listings
  • Find below-market listings (old path)
  • Get gross rental yield
  • Get price trends
  • Compare neighborhoods
  • List advertisers by matching listings
  • Check the asking price for any home

Registered transactions

  • Search registered deals
  • Registered deal statistics
  • Land prices per m²

Off-plan projects

  • Search projects
  • Get a project
  • List a project's units
  • Get a project's unit availability over time
  • Search project units
  • List developers
  • Get a project's absorption by month
  • Project absorption by area, developer or type

Exports

  • Create an export
  • List exports
  • Get an export

Administration

  • Get your organization
  • List data keys
  • Create a data key
  • Revoke a key
  • List projects
  • Daily usage
  • List members and invitations
  • List audit events
  • List request logs
  • Create a webhook endpoint
  • List webhook endpoints
  • Update a webhook endpoint
  • Re-enable a webhook endpoint
  • Rotate a webhook signing secret
  • Delete a webhook endpoint
  • List deliveries
  • Replay a delivery

Interactive reference

All endpoints

Reference data

  • List cities
  • List neighborhoods
  • List city directions
  • List enumerated values
  • Get this key's limits
  • What the API covers

Listings

  • Search listings
  • Count listings
  • Get listings by id
  • Get a listing
  • Get a listing's price history
  • Get a listing's advertiser contact

Market data

  • Market summary
  • Price distribution
  • Area distribution
  • New supply
  • Vacancy indicator
  • Prices by neighborhood
  • Commercial rent per m² by neighborhood
  • Plots for sale against their last registered sale
  • Registered sale price against the asking price
  • Places, population and landmarks around a point or in a neighborhood

Official data

  • Registered rents (REGA)
  • Kite Property Index

Analytics

  • Get comparable listings
  • Get a listing's market position
  • Get a listing's nearby asking-price band
  • Find below-market listings
  • Find below-market listings (old path)
  • Get gross rental yield
  • Get price trends
  • Compare neighborhoods
  • List advertisers by matching listings
  • Check the asking price for any home

Registered transactions

  • Search registered deals
  • Registered deal statistics
  • Land prices per m²

Off-plan projects

  • Search projects
  • Get a project
  • List a project's units
  • Get a project's unit availability over time
  • Search project units
  • List developers
  • Get a project's absorption by month
  • Project absorption by area, developer or type

Exports

  • Create an export
  • List exports
  • Get an export

Administration

  • Get your organization
  • List data keys
  • Create a data key
  • Revoke a key
  • List projects
  • Daily usage
  • List members and invitations
  • List audit events
  • List request logs
  • Create a webhook endpoint
  • List webhook endpoints
  • Update a webhook endpoint
  • Re-enable a webhook endpoint
  • Rotate a webhook signing secret
  • Delete a webhook endpoint
  • List deliveries
  • Replay a delivery

Interactive reference

Administration

Rotate a webhook signing secret

POST/organization/webhooks/{webhook_id}/rotate-secret

Issues a new signing secret, shown once in the response. For overlap_seconds (default 86400, up to 7 days; 0 for none) every delivery carries a signature for both the new and the previous secret, so a receiver holding either one can verify during the overlap. A receiver must accept the header if any v1 entry matches: the new secret's entry comes first, so a parser that reads only the last v1 gets the previous secret's signature until the overlap ends. After a leak, use 0. Rotating again during an overlap drops the older secret.

Authentication
Send an admin key (dk_admin_…) as a Bearer token. Data keys are refused here.
Scope
organization
Cost
Free

Parameters

NameDescription
webhook_idrequiredType: string · path
Idempotency-KeyType: string · header

A unique string (a UUID is ideal) making this call safe to retry. The same key with the same body replays the first response and sets Idempotent-Replay: true; with a different body it returns 409 idempotency_key_reuse. Remembered for 24 hours.

Request body

NameDescription
overlap_secondsType: integer

How long the previous secret keeps signing. Default 86400.

Response

The data field is an object with these fields.

NameDescription
idrequiredType: string
secretrequiredType: string

The new signing secret. Shown once.

previous_secret_expires_atrequiredType: string (date-time) | null

When the old secret stops signing; null if it already has.

Example request

cURL
curl -X POST "https://api.kite.sa/v1/organization/webhooks/webhook_id/rotate-secret" \  -H "Authorization: Bearer $KITE_ADMIN_KEY" \  -H "Content-Type: application/json" \  -d '{}'
JavaScript (@kite-sa/sdk)
import { Kite } from "@kite-sa/sdk";const kite = new Kite({ apiKey: process.env.KITE_ADMIN_KEY });const result = await kite.organization.webhooks.rotateSecret("webhook_id", {});
Python (kite-sa)
import osfrom kite_sa import Kitekite = Kite(api_key=os.environ["KITE_ADMIN_KEY"])result = kite.organization.webhooks.rotate_secret("webhook_id")

Open in the interactive reference

Related endpoints

  • Get your organizationGET /organization
  • List data keysGET /organization/keys
  • Create a data keyPOST /organization/keys
  • Revoke a keyPOST /organization/keys/{key_id}/revoke
  • List projectsGET /organization/projects
  • Daily usageGET /organization/usage
  • List members and invitationsGET /organization/members
  • List audit eventsGET /organization/audit-events
  • List request logsGET /organization/request-logs
  • Create a webhook endpointPOST /organization/webhooks
  • List webhook endpointsGET /organization/webhooks
  • Update a webhook endpointPOST /organization/webhooks/{webhook_id}/update
  • Re-enable a webhook endpointPOST /organization/webhooks/{webhook_id}/enable
  • Delete a webhook endpointPOST /organization/webhooks/{webhook_id}/delete
  • List deliveriesGET /organization/webhooks/{webhook_id}/deliveries
  • Replay a deliveryPOST /organization/webhooks/{webhook_id}/deliveries/{delivery_id}/replay

Guides

  • Quickstart
  • Authentication
  • Webhooks
  • Limits and quotas
  • Errors

Ready to make a request? The Sandbox plan is free. For volume or licensing, talk to us.

Get an API keyTalk to us
Kite API

Saudi real estate data for developers.

Product
  • Data coverage
  • Pricing
  • Investors and developers
  • Valuation checks
  • Proptech and apps
Developers
  • Quickstart
  • Guides
  • API reference
  • MCP server
  • JavaScript SDK (npm)
  • Python SDK (PyPI)
  • Changelog
  • Status
Company
  • kite.sa
  • Blog
  • Contact
  • Security
Legal
  • Terms
  • Sources and data rights
  • Privacy
  • DPA
  • Subprocessors
© Kite