Start a skill run

Start one immutable native Skill run.

Authorization

bearerApiKey

AuthorizationBearer <token>

Create a scoped API key in the Adlass settings.

In: header

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.

skill_id*string

Formatuuid

space_id*string

Formatuuid

inputs*

items?array<>

Data objects handed to the run, for example the result items of a previous Skill. The run reads them from input/items.jsonl in its working directory; a script entry takes them as its input file.

Itemsitems <= 1000

scope*

model?string

A model id from skills.models; defaults to the Skill setting or the runtime default.

reasoning_effort?string

Must be one of the efforts listed for the model in skills.models.

Value in

"none"
"low"
"medium"
"high"
"xhigh"
"max"

review_max_rounds?integer

Number of review passes. After a rejected pass the executor corrects its own result before the next pass; the last correction is not reviewed again.

Range1 <= value <= 3

instruction?string

Additional instruction for this run only.

Lengthlength <= 4000

dry_run?boolean

Rehearsal: integration write and send operations are recorded with their arguments instead of executed; reads run normally and page outputs stay unpublished.

Response Body

`application/json`

`application/problem+json`

curl -X POST "https://example.com/skill-runs" \  -H "Idempotency-Key: 123e4567-e89b-42d3-a456-426614174000" \  -H "Content-Type: application/json" \  -d '{    "skill_id": "123e4567-e89b-42d3-a456-426614174000",    "space_id": "123e4567-e89b-42d3-a456-426614174000",    "inputs": {},    "scope": {}  }'

{  "id": "123e4567-e89b-42d3-a456-426614174000",  "space_id": "123e4567-e89b-42d3-a456-426614174000",  "installation_id": "123e4567-e89b-42d3-a456-426614174000",  "skill_id": "123e4567-e89b-42d3-a456-426614174000",  "skill_name": "Invoice extractor",  "version_id": "123e4567-e89b-42d3-a456-426614174000",  "version": 0,  "requested_by_id": "123e4567-e89b-42d3-a456-426614174000",  "requested_by": {    "id": "123e4567-e89b-42d3-a456-426614174000",    "email": "ada@example.com",    "name": "Customer documents",    "image_url": "example"  },  "actor_type": "api",  "origin": "manual",  "entry": "example",  "entry_script_run_id": "123e4567-e89b-42d3-a456-426614174000",  "trigger": {    "id": "123e4567-e89b-42d3-a456-426614174000",    "kind": "schedule"  },  "status": "ACTIVE",  "model": "claude-sonnet-5",  "reasoning_effort": "medium",  "effective_max_turns": 0,  "review_max_rounds": 0,  "instruction": "example",  "dry_run": false,  "cost_micro_usd": 0,  "micro_credits": 0,  "turns_used": 0,  "pages": [    {      "key": "summary",      "name": "Customer documents",      "page_id": "123e4567-e89b-42d3-a456-426614174000",      "url": "https://api.adlass.io/v1/workflows/hooks/example"    }  ],  "error_code": "example",  "error_message": "example",  "started_at": "2026-09-04T12:00:00Z",  "completed_at": "2026-09-04T12:00:00Z",  "created_at": "2026-09-04T12:00:00Z",  "reversal": {    "id": "123e4567-e89b-42d3-a456-426614174000",    "status": "ACTIVE",    "requested_by_id": "123e4567-e89b-42d3-a456-426614174000",    "skip_conflicts": false,    "summary": {},    "error_code": "example",    "created_at": "2026-09-04T12:00:00Z",    "started_at": "2026-09-04T12:00:00Z",    "completed_at": "2026-09-04T12:00:00Z"  },  "undo": {    "available": false,    "blocked_reason": "example"  }}

Authorization

Header Parameters

Request Body

Response Body

202application/json

400application/problem+json

401application/problem+json

402application/problem+json

403application/problem+json

404application/problem+json

405application/problem+json

409application/problem+json

410application/problem+json

413application/problem+json

415application/problem+json

422application/problem+json

429application/problem+json

500application/problem+json

502application/problem+json

503application/problem+json

504application/problem+json

`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`