Skip to main content
PATCH
Update a 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.

Path Parameters

skillId
string
required

Body

application/json

Partial; at least one field. name is immutable.

description
string
Maximum string length: 500
content
string
Maximum string length: 24000
enabled
boolean
files
object[]
Maximum array length: 5

Response

Updated

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[]