Capabilities

create_webhook

Register an HTTPS receiver; prove the returned secret before events are sent. Receives IDs only, never file text or names.

How this capability is exposed

Stable ID: ursy.cloud:create_webhook
Owning service: URSY.cloud
Runtime: See the source declaration

Capability declarations describe what the service exposes. They are not a guarantee of availability or permission to execute an operation.

Accepted contract

REGISTRY JSON

{
    "id": "ursy.cloud:create_webhook",
    "name": "create_webhook",
    "description": "Register an HTTPS receiver; prove the returned secret before events are sent. Receives IDs only, never file text or names.",
    "method": "POST",
    "path": "/v1/webhooks",
    "inputSchema": {
        "type": "object",
        "additionalProperties": false,
        "properties": {
            "url": {
                "type": "string",
                "maxLength": 1024,
                "pattern": "^https://"
            },
            "idempotency_key": {
                "type": "string",
                "minLength": 8,
                "maxLength": 128,
                "pattern": "^[A-Za-z0-9._:-]+$"
            }
        },
        "required": [
            "url",
            "idempotency_key"
        ]
    },
    "outputSchema": {
        "type": "object",
        "additionalProperties": true,
        "properties": {
            "webhook": {
                "type": "object",
                "additionalProperties": false,
                "properties": {
                    "id": {
                        "type": "string"
                    },
                    "url": {
                        "type": "string"
                    },
                    "state": {
                        "type": "string",
                        "enum": [
                            "pending",
                            "active",
                            "disabled",
                            "revoked"
                        ]
                    },
                    "failures": {
                        "type": "integer",
                        "minimum": 0
                    },
                    "last_error": {
                        "type": "string"
                    }
                },
                "required": [
                    "id",
                    "url",
                    "state",
                    "failures",
                    "last_error"
                ]
            },
            "secret": {
                "type": "string"
            },
            "verification": {
                "type": "string"
            }
        },
        "required": [
            "webhook",
            "secret",
            "verification"
        ]
    },
    "auth_required": true,
    "scope": "cloud.webhooks.manage",
    "read_only": false,
    "service_id": "ursy-cloud",
    "parent_id": "",
    "summary": "Register an HTTPS receiver; prove the returned secret before events are sent. Receives IDs only, never file text or names.",
    "source_url": "https://api.ursy.cloud/v1/registry-capabilities",
    "source_type": "capability_manifest",
    "verified_at": "2026-10-15 05:32:02",
    "revision": "5d046284cd6428f2916a4a66472d67f9375c66b6fed8769e1971597f6d4cd92f",
    "type": "capabilities",
    "source": {
        "url": "https://api.ursy.cloud/v1/registry-capabilities",
        "type": "capability_manifest"
    },
    "last_verified_at": "2026-10-15 05:32:02",
    "stale": false
}