Agent29

Agent Attachments2

Agent Evals12

Agent MCP Servers5

Agent Personas7

Agent Skills5

Agent Tools6

Agent Traces3

Components46

Desk53

Documents38

Job Status5

Knowledge Base Graph65

Knowledge Bases26

organizations16

Queue Status1

schematic-classes1

schematic-templates2

semantic-catalog6

Usage1

Agent Skills

Create agent skill

Changed on Sep 25, 2026

Create a new instruction-document skill for the current user.

post/api/v0/agent/skills

Request

Base URL
https://api.outerport.com (the document declares no server; this is the origin it was published from)
Auth
HTTP bearer
TypeScript
https://skmtc.dev/outerport/apis/outerport-api/docs/api/v0/agent/skills/post.ts
A function with typed inputs. Its response is checked against the schema.

Request body

namestring required

The name of the skill.

descriptionstring

One-line description shown to the agent in the persona's available-skills list.

bodystring

Markdown body: the SKILL.md-style content the agent reads via the read_skill tool when invoking this skill.

Response

Successful Response

idstring uuid required

The ID of the skill.

namestring required

The name of the skill.

descriptionstring required

The description of the skill.

bodystring

Markdown body of the skill, which the agent reads via the read_skill builtin tool when a persona has preloaded it.

created_atstring date-time required

When the skill was created.

updated_atstring date-time required

When the skill was last updated.

Changes

Sep 25, 2026fcd15f6d35b4 Revision changes
- info
  added the required property to the response with the status

Operation history

Create agent skill

Request

Request body

Response 200OK

Changes

Response