Skill Templates

Skill templates define reusable starting points for skills.

Skill Templates object

Attributes

object

String

id

String

status

Enum

owner

Enum

slug

String

name

String

description

StringNullable

metadata

Object

A key-value map

store_id

String

items

Object

created_at

Date

updated_at

Date
{
  "object": "skill.template",
  "status": "active",
  "owner": "system",
  "metadata": {},
  "items": [
    {
      "object": "skill.template.item",
      "type": "integration",
      "integration": {
        "object": "integration#preview",
        "metadata": {},
        "configuration": {}
      },
      "provider": {
        "object": "provider#preview",
        "id": "pro_5gHjKlMnPqRsTuVw",
        "name": "GitHub",
        "description": "Connect to GitHub repositories, issues, and pull requests",
        "slug": "github",
        "created_at": "2025-09-15T10:30:00.000Z",
        "updated_at": "2026-01-10T14:45:00.000Z"
      }
    },
    {
      "object": "skill.template.item",
      "type": "integration",
      "integration": {
        "object": "integration#preview",
        "metadata": {},
        "configuration": {}
      },
      "provider": {
        "object": "provider#preview",
        "id": "pro_5gHjKlMnPqRsTuVw",
        "name": "GitHub",
        "description": "Connect to GitHub repositories, issues, and pull requests",
        "slug": "github",
        "created_at": "2025-09-15T10:30:00.000Z",
        "updated_at": "2026-01-10T14:45:00.000Z"
      }
    }
  ]
}

List skill templates

Returns a paginated list of skill templates.

Query Parameters

limit

NumberOptional

after

StringOptional

before

StringOptional

cursor

StringOptional

order

EnumOptional

search

StringOptional

status

UnionOptional

owner

UnionOptional

id

UnionOptional

provider_id

UnionOptional

integration_id

UnionOptional

created_at

ObjectOptional

Filter skill template creation time by date range

updated_at

ObjectOptional

Filter skill template last update time by date range

GEThttp://api.metorial.com/skill-template
curl -X GET "https://api.metorial.com/skill-template" \
  -H "Authorization: Bearer metorial_sk_..."

Get skill template

Retrieves a specific skill template.

URL Parameters

skill_template_id

String

The unique identifier for the skill_template

GEThttp://api.metorial.com/skill-template/:skill_template_id
curl -X GET "https://api.metorial.com/skill-template/ski_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_..."

Create skill template

Creates a skill template.

Request Body

name

String

description

StringOptional

metadata

ObjectOptional

A key-value map

from_skill_Id

StringOptional
POSThttp://api.metorial.com/skill-template
curl -X POST "https://api.metorial.com/skill-template" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..." \
  -d '{
  "name": "example_name",
  "description": "example_description",
  "metadata": {},
  "from_skill_Id": "example_from_skill_Id"
}'

Update skill template

Updates a skill template.

URL Parameters

skill_template_id

String

The unique identifier for the skill_template

Request Body

name

StringOptional

description

StringOptionalNullable

metadata

ObjectOptionalNullable

A key-value map

PATCHhttp://api.metorial.com/skill-template/:skill_template_id
curl -X PATCH "https://api.metorial.com/skill-template/ski_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..." \
  -d '{
  "name": "example_name",
  "description": "example_description",
  "metadata": {}
}'

Delete skill template

Archives a skill template.

URL Parameters

skill_template_id

String

The unique identifier for the skill_template

DELETEhttp://api.metorial.com/skill-template/:skill_template_id
curl -X DELETE "https://api.metorial.com/skill-template/ski_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_..."