PUT /api/org/webhook

Sets or replaces the webhook. The secret that signs every delivery is shown here and derived from the id, so replacing the URL keeps it.

Surface: organisation. Who may call: organisation-key. Key: organisation.webhook.set.

Example request

curl -X PUT https://caremcp.com/api/org/webhook \
  -H "Authorization: Bearer <API key or session>" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://agentheim.com/hooks/care"}'

Example input

{
  "url": "https://agentheim.com/hooks/care"
}

Input schema

{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "type": "object",
 "properties": {
  "url": {
   "type": "string",
   "format": "uri"
  }
 },
 "required": [
  "url"
 ]
}

Output schema

{
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "type": "object",
 "properties": {
  "id": {
   "type": "string"
  },
  "url": {
   "type": "string"
  },
  "secret": {
   "type": "string"
  },
  "createdAt": {
   "type": "string"
  }
 },
 "required": [
  "id",
  "url",
  "createdAt"
 ],
 "additionalProperties": false
}