Create a skill from a task
Record a plain-language task in a cloud browser and publish it as a typed, versioned skill. Answers at once with a creation id to poll.
GET /v1/skill-creations/{creation_id} until status is ready or failed. See Create a skill from a task for a full example.Authorizations
API key with the vd_sk_ prefix. Create keys from Settings, API Keys in the dashboard.
Headers
Retry-safe key. The same key from the same account returns what it already started.
Body
What the skill does, in plain words.
3 - 2000"Search for dentists in Austin and list them"
The http(s) page the skill starts on.
2000"https://www.google.com/maps"
Skill name. Derived from the task when omitted.
100Up to 5 inputs, each mapped to the example value the recording uses. Each value must appear in what the browser types or opens. Inferred when omitted.
Up to 25 columns, as {name: description} or a list of names. Inferred when omitted.
private, public Response
Creation started (or the existing one, for a repeated Idempotency-Key).
"sc_3f9a1c2b7d4e5f60"
queued, recording, validating, ready, failed "/v1/skill-creations/sc_3f9a1c2b7d4e5f60"
Set once the recording is saved.
Set once the recording is saved.
/v1/skills/{slug} once saved.
/v1/skills/{slug}/run once ready.
Why it failed.
True when an Idempotency-Key matched an existing creation.
On failure: what was tried and example hints.

