MetorialDocs

Skill Template Items

Skill template items link template definitions to provider and integration items.

The Skill Template Item object

skill_template_item.json
{
  "object": "skill.template.item",
  "id": "example_id",
  "type": "integration",
  "integration": {
    "object": "integration#preview",
    "id": "example_id",
    "slug": "example_slug",
    "name": "example_name",
    "description": "example_description",
    "metadata": {},
    "configuration": {
      "can_attach_custom_tool_filters": false,
      "can_attach_custom_provider_config": false,
      "can_override_tool_filters": false,
      "enable_callback_tools": false,
      "use_integration_name_in_tool_names": false
    },
    "created_at": "2026-10-17T09:50:02.670Z",
    "updated_at": "2026-10-17T09:50:02.670Z",
    "archived_at": "2026-10-17T09:50:02.670Z"
  },
  "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.670Z",
  "updated_at": "2026-10-17T09:50:02.670Z"
}
object"skill.template.item"required
idstringrequired
type"integration" | "provider"required
created_atdaterequired
updated_atdaterequired

Endpoints

List skill template items

GET/skill-templates/:skill_template_id/items

Returns a paginated list of items for a skill template.

Path parameters

skill_template_idstringrequired

The unique identifier for the skill_template

Query parameters

Example request

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

Get skill template item

GET/skill-templates/:skill_template_id/items/:skill_template_item_id

Retrieves a specific skill template item.

Path parameters

skill_template_idstringrequired

The unique identifier for the skill_template

skill_template_item_idstringrequired

The unique identifier for the skill_template_item

Example request

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

Create skill template item

POST/skill-templates/:skill_template_id/items

Adds a provider or integration item to a skill template.

Path parameters

skill_template_idstringrequired

The unique identifier for the skill_template

Request body

type"provider"required
provider_idstringoptional
integration_idstringoptional

Example request

curl -X POST "https://api.metorial.com/skill-templates/ski_Rm4Mnheq2bfEPhBhP7SY/items" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_io2h4..." \
  -d '{
  "type": "provider"
}'

Delete skill template item

DELETE/skill-templates/:skill_template_id/items/:skill_template_item_id

Deletes a skill template item.

Path parameters

skill_template_idstringrequired

The unique identifier for the skill_template

skill_template_item_idstringrequired

The unique identifier for the skill_template_item

Example request

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