Skills

Arm the skill webhook for a test delivery

POST
/spaces/{space_id}/skills/{skill_id}/automation/webhook/listen

Arm the Skill's webhook for a test delivery: the next authenticated delivery within ten minutes is captured as the sample (readable through skills.automation.get under webhook.sample.payload) instead of being executed. Only while the webhook is inactive.

Authorization

bearerApiKey
AuthorizationBearer <token>

Create a scoped API key in the Adlass settings.

In: header

Path Parameters

space_id*string

Resource identifier: space_id.

Formatuuid
skill_id*string

Resource identifier: skill_id.

Formatuuid

Header Parameters

X-Request-Id?string

Optional correlation identifier.

Lengthlength <= 128
Idempotency-Key*string

A unique key for this intended write. Reuse it only for an identical retry.

Length1 <= length <= 200

Response Body

application/json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

application/problem+json

curl -X POST "https://example.com/spaces/123e4567-e89b-42d3-a456-426614174000/skills/123e4567-e89b-42d3-a456-426614174000/automation/webhook/listen" \  -H "Idempotency-Key: 123e4567-e89b-42d3-a456-426614174000"
{  "schedule": null,  "event": null,  "webhook": {    "auth": "hmac_signature",    "methods": [      "POST"    ],    "integration": null,    "active": false,    "entry": {      "kind": "agent"    },    "url": "https://api.adlass.io/api/v1/webhooks/triggers/abc/",    "has_secret": true,    "subscription_state": "none",    "subscription_count": 0,    "last_error_code": null,    "subscription_synced_at": null,    "listening_until": "2026-09-19T12:10:00Z",    "sample": null  },  "run": {    "inputs": {},    "scope": {},    "instruction": null  },  "status": {    "schedule": null,    "event": null,    "webhook": null  }}