Skip to main content
POST
Create an organization skill

Authorizations

Authorization
string
header
required

A workspace API key (oc_…) or organization API key (oc_org_…). Workspace-scoped endpoints called with an organization key also need X-Workspace-Id.

Body

application/json
name
string
required
Maximum string length: 64
Pattern: ^[a-z0-9]+(?:-[a-z0-9]+)*$
description
string
required
Maximum string length: 500
content
string
required
Maximum string length: 24000
enabled
boolean
default:true
files
object[]
Maximum array length: 5

Response

Created

id
string
scope
enum<string>
Available options:
agent,
workspace,
organization
agentId
string | null
workspaceId
string | null
organizationId
string | null
name
string
description
string
content
string

The SKILL.md body.

enabled
boolean
createdByEmail
string | null
createdAt
string<date-time>
updatedAt
string<date-time>
files
object[]