MetorialDocs

Skill Items

Skill items attach integrations and providers to skills.

The Skill Item object

skill_item.json
{
  "object": "skill.item",
  "id": "example_id",
  "status": "active",
  "type": "integration",
  "skill_id": "example_skill_id",
  "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.668Z",
    "updated_at": "2026-10-17T09:50:02.668Z",
    "archived_at": "2026-10-17T09:50:02.668Z"
  },
  "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.668Z"
}
object"skill.item"required
idstringrequired
status"active" | "archived" | "deleted"required
type"integration" | "provider"required
skill_idstringrequired
created_atdaterequired

Endpoints

List skill items

GET/skills/:skill_id/items

Returns a paginated list of items for a skill.

Path parameters

skill_idstringrequired

The unique identifier for the skill

Query parameters

status"active" | "archived" | "deleted" or "active" | "archived" | "deleted"[]optional
type"integration" | "provider" or "integration" | "provider"[]optional
idstring or string[]optional
integration_idstring or string[]optional
provider_idstring or string[]optional

Example request

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

Get skill item

GET/skills/:skill_id/items/:skill_item_id

Retrieves a specific skill item.

Path parameters

skill_idstringrequired

The unique identifier for the skill

skill_item_idstringrequired

The unique identifier for the skill_item

Example request

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

Create skill item

POST/skills/:skill_id/items

Creates a new item on a skill.

Path parameters

skill_idstringrequired

The unique identifier for the skill

Request body

type"provider"required
provider_idstringoptional
integration_idstringoptional

Example request

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

Delete skill item

DELETE/skills/:skill_id/items/:skill_item_id

Archives a skill item.

Path parameters

skill_idstringrequired

The unique identifier for the skill

skill_item_idstringrequired

The unique identifier for the skill_item

Example request

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