Skill Imports API | Metorial Docs

The Skill Import object

skill_import.json

{
  "object": "skill.import",
  "id": "example_id",
  "status": "pending",
  "source": {
    "type": "public",
    "repository_url": "example_repository_url",
    "repository_name": "example_repository_name",
    "ref": "example_ref"
  },
  "error": "example_error",
  "items": [
    {
      "object": "skill.import.item",
      "status": "pending",
      "skill": {}
    },
    {
      "object": "skill.import.item",
      "status": "pending",
      "skill": {}
    }
  ],
  "started_at": "2026-10-17T09:50:02.673Z",
  "completed_at": "2026-10-17T09:50:02.673Z",
  "created_at": "2026-10-17T09:50:02.673Z"
}

object"skill.import"required

idstringrequired

status"pending" | "processing" | "completed" | "failed"required

sourceobjectrequired

errorstringrequirednullable

itemsobject[]required

started_atdaterequirednullable

completed_atdaterequirednullable

created_atdaterequired

Endpoints

List skill imports

GET/skill-imports

Returns a paginated list of skill imports.

Query parameters

idstring or string[]optional

Example request

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

Get skill import

GET/skill-imports/:skill_import_id

Retrieves an individual skill import and its results.

Path parameters

skill_import_idstringrequired

The unique identifier for the skill_import

Example request

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

Create skill import

POST/skill-imports

Queues a skill import from a repository or uploaded file.

Request body

sourceobjectrequired

Example request

curl -X POST "https://api.metorial.com/skill-imports" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_io2h4..." \
  -d '{
  "source": {
    "type": "public",
    "repository_url": "example_repository_url",
    "ref": "example_ref"
  }
}'