MetorialDocs

Skill Templates

Skill templates define reusable starting points for skills.

The Skill Template object

skill_template.json
{
  "object": "skill.template",
  "id": "example_id",
  "status": "active",
  "owner": "system",
  "slug": "example_slug",
  "name": "example_name",
  "description": "example_description",
  "metadata": {},
  "store_id": "example_store_id",
  "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"
      }
    }
  ],
  "created_at": "2026-10-17T09:50:02.669Z",
  "updated_at": "2026-10-17T09:50:02.669Z"
}
object"skill.template"required
idstringrequired
status"active" | "archived" | "deleted"required
owner"system" | "tenant"required
slugstringrequired
namestringrequired
descriptionstringrequirednullable
metadataRecord<string, any>required
store_idstringrequired
created_atdaterequired
updated_atdaterequired

Endpoints

List skill templates

GET/skill-templates

Returns a paginated list of skill templates.

Query parameters

searchstringoptional
status"active" | "archived" | "deleted" or "active" | "archived" | "deleted"[]optional
owner"system" | "tenant" or "system" | "tenant"[]optional
idstring or string[]optional
provider_idstring or string[]optional
integration_idstring or string[]optional

Example request

curl -X GET "https://api.metorial.com/skill-templates" \
  -H "Authorization: Bearer metorial_sk_io2h4..."

Get skill template

GET/skill-templates/:skill_template_id

Retrieves a specific skill template.

Path parameters

skill_template_idstringrequired

The unique identifier for the skill_template

Example request

curl -X GET "https://api.metorial.com/skill-templates/ski_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_io2h4..."

Create skill template

POST/skill-templates

Creates a skill template.

Request body

namestringrequired
descriptionstringoptional
metadataRecord<string, any>optional
from_skill_Idstringoptional

Example request

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

Update skill template

PATCH/skill-templates/:skill_template_id

Updates a skill template.

Path parameters

skill_template_idstringrequired

The unique identifier for the skill_template

Request body

namestringoptional
descriptionstringoptionalnullable
metadataRecord<string, any>optionalnullable

Example request

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

Delete skill template

DELETE/skill-templates/:skill_template_id

Archives a skill template.

Path parameters

skill_template_idstringrequired

The unique identifier for the skill_template

Example request

curl -X DELETE "https://api.metorial.com/skill-templates/ski_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_io2h4..."