Skills

Configure skill automation

PUT
/spaces/{space_id}/skills/{skill_id}/automation

Replace the schedule, platform-event trigger, webhook and stored run request of a Skill in a Space. Each trigger has an entry: the agent, or a pinned script that runs without a model call and escalates to the agent on exceptions or failure. A webhook receives as soon as it is configured and executes only while active; omit the webhook key to keep the current one. Automated runs execute on behalf of the caller. Returns the effective automation, as skills.automation.get does.

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

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

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 PUT "https://example.com/spaces/123e4567-e89b-42d3-a456-426614174000/skills/123e4567-e89b-42d3-a456-426614174000/automation" \  -H "Idempotency-Key: 123e4567-e89b-42d3-a456-426614174000" \  -H "Content-Type: application/json" \  -d '{    "schedule": {      "kind": "cron",      "timezone": "example",      "active": false    },    "event": {      "event_type": "example",      "entity_id": "123e4567-e89b-42d3-a456-426614174000",      "severity": "info",      "filters": [],      "active": false    },    "run": {      "inputs": {},      "scope": {}    }  }'
{  "schedule": {    "cron": "0 8 * * 1",    "timezone": "Europe/Berlin",    "active": true  },  "event": null,  "run": {    "inputs": {},    "scope": {      "include_all_processed_documents": true    }  },  "webhook": null,  "status": {    "schedule": {      "active": true,      "next_fire_at": "2026-09-04T12:00:00Z"    },    "event": null,    "webhook": null  }}