POST
/
v1
/
teams
/
{teamId}
/
agent-skills
TypeScript client
import { OctosparkClient } from '@octospark/sdk'

const client = new OctosparkClient({
  token: process.env.OCTOSPARK_TOKEN
})

const response = await client.agentSkills.createAgentSkill({
  teamId: process.env.OCTOSPARK_TEAM_ID ?? "teamId",
  body: {},
})
{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "teamId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "description": "<string>",
  "body": "<string>",
  "createdBy": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "createdAt": "<string>",
  "updatedAt": "<string>"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
teamId
string
required

Team (workspace) id (UUID). Discover ids via the list teams endpoint or the agent context.

Body

application/json
​
name
string
required

Unique (per team) name the model passes to load_skill, 1-80 characters.

Required string length: 1 - 80
​
description
string
required

One-line summary listed in the prompt so the model knows when to load the skill, 1-500 characters.

Required string length: 1 - 500
​
body
string
required

The markdown body returned by load_skill (progressive disclosure), up to 60000 characters.

Required string length: 1 - 60000

Response

Success

​
id
string<uuid>
required

a Universally Unique Identifier

Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
​
teamId
string<uuid>
required

a Universally Unique Identifier

Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
​
name
string
required

Unique (per team) name the model passes to load_skill, 1-80 characters.

Required string length: 1 - 80
​
description
string
required

One-line summary listed in the prompt so the model knows when to load the skill, 1-500 characters.

Required string length: 1 - 500
​
body
string
required

The markdown body returned by load_skill (progressive disclosure), up to 60000 characters.

Required string length: 1 - 60000
​
createdBy
string<uuid>
required

a Universally Unique Identifier

Pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$
​
createdAt
string
required

When the skill was created (ISO-8601 UTC).

​
updatedAt
string
required

When the skill last changed (ISO-8601 UTC).