Skill Items

Skill items attach integrations and providers to skills.

Skill Items object

Attributes

object

String

id

String

status

Enum

type

Enum

skill_id

String

integration

ObjectNullable

provider

ObjectNullable

created_at

Date
{
  "object": "skill.item",
  "status": "active",
  "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 items

Returns a paginated list of items for a skill.

URL Parameters

skill_id

String

The unique identifier for the skill

Query Parameters

limit

NumberOptional

after

StringOptional

before

StringOptional

cursor

StringOptional

order

EnumOptional

status

UnionOptional

type

UnionOptional

id

UnionOptional

integration_id

UnionOptional

provider_id

UnionOptional

created_at

ObjectOptional

Filter skill item creation time by date range

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

Get skill item

Retrieves a specific skill item.

URL Parameters

skill_id

String

The unique identifier for the skill

skill_item_id

String

The unique identifier for the skill_item

GEThttp://api.metorial.com/skills/:skill_id/items/:skill_item_id
curl -X GET "https://api.metorial.com/skills/ski_Rm4Mnheq2bfEPhBhP7SY/items/ski_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_..."

Create skill item

Creates a new item on a skill.

URL Parameters

skill_id

String

The unique identifier for the skill

Request Body

type

String

provider_id

String

type

String

integration_id

String
POSThttp://api.metorial.com/skills/:skill_id/items
curl -X POST "https://api.metorial.com/skills/ski_Rm4Mnheq2bfEPhBhP7SY/items" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..." \
  -d '{
  "type": "example_type",
  "provider_id": "example_provider_id",
  "integration_id": "example_integration_id"
}'

Delete skill item

Archives a skill item.

URL Parameters

skill_id

String

The unique identifier for the skill

skill_item_id

String

The unique identifier for the skill_item

DELETEhttp://api.metorial.com/skills/:skill_id/items/:skill_item_id
curl -X DELETE "https://api.metorial.com/skills/ski_Rm4Mnheq2bfEPhBhP7SY/items/ski_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_..."