Skip to main content
POST
Create a skill

Authorizations

Authorization
string
header
required

Send your API key in the Authorization header as Bearer API_KEY. Account API keys work in every workspace you belong to: send X-Notra-Organization-Id with the workspace id or slug to choose one. Workspace endpoints require it when you belong to more than one workspace; GET /v1/me/workspaces works without it. Organization keys only accept their own workspace there.

Body

application/json
name
string
required

Skill name. Lowercase letters, digits, and hyphens only.

Required string length: 1 - 64
Pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$
Example:

"humanizer"

description
string
required

Short description of when the skill should be used.

Required string length: 1 - 1000
Example:

"Polish near-final drafts so they sound natural and specific."

content
string
required

Full skill instructions, typically Markdown.

Required string length: 1 - 200000
Example:

"# Humanizer\n\nRewrite the draft so it reads like a person wrote it. Remove filler, vary sentence length, and keep concrete details."

Response

Skill created successfully

skill
object
required
Last modified on October 13, 2026