Skip to content
Get started

Get a skill

GET/api/promptly/skills/{skillId}

Get a skill

Path ParametersExpand Collapse
skillId: string
formatuuid
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

Get a skill

curl https://0ct.com/api/promptly/skills/$SKILL_ID \
    -H "Authorization: Bearer $0CT_API_KEY"
{
  "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
}