Skip to main content
POST
Talk to a skill
Send one message of up to 2,000 characters, such as this is broken, why did the last run fail?, or also get the price. The skill reads its runs, steps, and versions, decides what is wrong, and fixes it when it can. It can:
  • Re-learn a step or a field.
  • Change its browser or proxy.
  • Restore a version that worked.
  • Ask you to sign in to the site.
The call answers within about a minute with messages: your message and the skill’s reply. A repair it starts carries on after the call, is checked with a short run, and its result is posted to the skill’s chat. Read the chat with Read a skill’s chat. Repairs are free. New fields you ask for are charged as an improvement. Returns 409 while the skill is still answering your previous message. Only the skill’s owner or an editor in its workspace can talk to it. Needs skills:write. Use this when you do not know which improvement mode fits. In the app, it is the chat box at the top of the skill page. MCP tool: talk_to_skill, with skill and message.

Authorizations

Authorization
string
header
required

API key with the vd_sk_ prefix, as Authorization: Bearer vd_sk_.... Create keys in Settings → API Keys.

Headers

Idempotency-Key
string

Any unique string (such as your order id). Resending the same request with the same key within 24 hours returns the first answer (with Idempotent-Replayed: true) and does nothing twice; the same key with a different request is a 422 idempotency_key_reused.

Required string length: 1 - 255

Path Parameters

slug
string
required

Body

application/json
message
string
required

What you want, in plain words: 'this is broken', 'add the price', 'why did the last run fail?'

Required string length: 1 - 2000

Response

Successful Response

Your message and the doctor's answer(s). Work that takes longer (a repair) carries on after this answers; its result is posted to the chat.

messages
DoctorMessage · object[]