Skip to content
0ct
Get started
API Reference
Promptly
Skills

Create a skill

POST/api/promptly/skills

Create a new reusable instruction set

Body ParametersExpand Collapse
content: string
name: string
organizationId: string
formatuuid
category: optional string
description: optional string
frontmatter: optional unknown
iconUrl: optional string
isPublic: optional boolean
slug: optional string
ReturnsExpand Collapse
Skill = object { id, content, name, 11 more }
id: string
formatuuid
content: string

Markdown instructions that guide task execution

name: string
category: optional string
createdAt: optional string
formatdate-time
description: optional string
frontmatter: optional object { author, requiredSources, tags }

Skill metadata

author: optional string
requiredSources: optional array of string

Source slugs this skill depends on

tags: optional array of string
iconUrl: optional string
formaturi
isPublic: optional boolean

Whether the skill is shared publicly

isUserInvocable: optional boolean

Whether users can manually attach this skill

organizationId: optional string
formatuuid
slug: optional string

URL-friendly identifier

updatedAt: optional string
formatdate-time
version: optional number

Create a skill

curl https://0ct.com/api/promptly/skills \
    -H 'Content-Type: application/json' \
    -H "Authorization: Bearer $0CT_API_KEY" \
    -d '{
          "content": "content",
          "name": "name",
          "organizationId": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e"
        }'
{
  "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  "content": "content",
  "name": "name",
  "category": "category",
  "createdAt": "2019-12-27T18:11:19.117Z",
  "description": "description",
  "frontmatter": {
    "author": "author",
    "requiredSources": [
      "string"
    ],
    "tags": [
      "string"
    ]
  },
  "iconUrl": "https://example.com",
  "isPublic": true,
  "isUserInvocable": true,
  "organizationId": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  "slug": "slug",
  "updatedAt": "2019-12-27T18:11:19.117Z",
  "version": 0
}
Returns Examples
{
  "id": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  "content": "content",
  "name": "name",
  "category": "category",
  "createdAt": "2019-12-27T18:11:19.117Z",
  "description": "description",
  "frontmatter": {
    "author": "author",
    "requiredSources": [
      "string"
    ],
    "tags": [
      "string"
    ]
  },
  "iconUrl": "https://example.com",
  "isPublic": true,
  "isUserInvocable": true,
  "organizationId": "182bd5e5-6e1a-4fe4-a799-aa6d9a6ab26e",
  "slug": "slug",
  "updatedAt": "2019-12-27T18:11:19.117Z",
  "version": 0
}