Skip to main content
POST
Create skill

Authorizations

Authorization
string
header
required

Organization API key, generated in studio.sidenet.ai. Backend only — never in a browser.

Body

application/json
name
string
required

1-64 chars: lowercase letters, digits and hyphens. Two skills on one agent may not share a name.

Example:

"refund-policy"

description
string
required

What the skill covers and when the agent should load it. Shown to the agent on every turn.

Maximum string length: 1024
Example:

"How refunds are decided and worded. Load before answering any refund or cancellation question."

instructions
string
required

Markdown the agent receives when it loads the skill. Positive, imperative rules work best.

Maximum string length: 60000
Example:

"## Refunds\n\n1. Full refund within 14 days of purchase…"

Response

The new skill and its first version (not yet published)

skill
object
latest
object | null

The working copy (newest version).

active
object | null

What agents get. Null until the skill is published.