authored-skills

Validate an instruction skill (live editor validation)

Validate the simple instruction-skill form (name + description + plain-markdown instructions) WITHOUT saving. Returns friendly, non-technical errors for the editor to show inline. Always 200.

post/v1/authored-skills/instructions/validate

Request

  • Base URL: https://api.patricia.app (the document declares no server; this is the origin it was published from)
  • URL: https://api.patricia.app/v1/authored-skills/instructions/validate
  • Auth: HTTP bearer

Headers

X-Tenant-Idstring nullable

Request body

titlestring required

The skill's name, e.g. 'Refund policy'.

descriptionstring nullable

A one-line summary of what the skill helps with.

instructionsstring required

Plain-markdown guidance: when someone asks about X, do Y; use our tone; check Z first.

recommended_integrationsstring[]

App slugs from the integrations catalog to recommend connecting for this skill.

skill_idstring uuid nullable

When editing an existing instruction skill, its id. An edit targets this skill and keeps its identity even if the name changed. Omit when creating a new skill.

Response

Successful Response

validboolean required
slugstring nullable
titlestring nullable
descriptionstring nullable
delivery_modestring nullable
errorsstring[]

Changes

No recorded changes to this operation across all 1 revision of this API.