MetorialDocs

Skill Exports

Export skills, skill plugins, and skill marketplaces as zip files.

The Skill Export object

skill_export.json
{
  "object": "skill.export",
  "id": "example_id",
  "target": "skill",
  "status": "pending",
  "file": {
    "object": "file",
    "id": "fil_9jKlMnPqRsTuVwXy",
    "status": "active",
    "file_name": "company-logo.png",
    "file_size": 245760,
    "file_type": "image/png",
    "title": "Company Logo",
    "purpose": "organization_logo",
    "created_by": {
      "type": "organization_actor",
      "name": "example_name",
      "image_url": "example_image_url",
      "email": "example_email",
      "organization_actor": {
        "object": "organization.actor",
        "id": "omem_5fGhJkLmNpQrStUv",
        "type": "member",
        "organization_id": "org_7hNkPqRsTuVwXyZa",
        "name": "Alex Chen",
        "email": "[email protected]",
        "image_url": "https://avatar-cdn.metorial.com/aimg_1234567890",
        "member": {
          "object": "organization.member#preview",
          "id": "ome_7hNkPqRsTuVwXyZa",
          "status": "active",
          "role": "member"
        },
        "teams": [
          {
            "id": "tm_3eFgHjKlMnPqRsTu",
            "name": "Engineering",
            "slug": "engineering",
            "assignment_id": "tmas_8jKlMnPqRsTuVwXy"
          },
          {
            "id": "tm_3eFgHjKlMnPqRsTu",
            "name": "Engineering",
            "slug": "engineering",
            "assignment_id": "tmas_8jKlMnPqRsTuVwXy"
          }
        ],
        "created_at": "2026-10-17T09:50:02.671Z",
        "updated_at": "2026-10-17T09:50:02.671Z"
      },
      "consumer": {
        "object": "consumer",
        "id": "example_id",
        "name": "example_name",
        "email": "example_email",
        "image_url": "example_image_url",
        "user_id": "example_user_id",
        "created_at": "2026-10-17T09:50:02.671Z",
        "updated_at": "2026-10-17T09:50:02.671Z"
      },
      "consumer_profile": {
        "object": "consumer.profile",
        "id": "example_id",
        "name": "example_name",
        "email": "example_email",
        "image_url": "example_image_url",
        "consumer_id": "example_consumer_id",
        "user_id": "example_user_id",
        "status": "active",
        "created_at": "2026-10-17T09:50:02.672Z",
        "updated_at": "2026-10-17T09:50:02.672Z",
        "groups": [
          {
            "object": "consumer.profile.group_assignment",
            "group": {
              "object": "consumer.group",
              "id": "example_id",
              "status": "active",
              "name": "example_name",
              "description": "example_description",
              "is_default": false,
              "created_at": "2026-10-17T09:50:02.672Z",
              "updated_at": "2026-10-17T09:50:02.672Z"
            },
            "assigned_via": "default"
          }
        ]
      }
    },
    "created_at": "2026-10-17T09:50:02.672Z",
    "updated_at": "2026-10-17T09:50:02.672Z"
  },
  "file_link": {
    "object": "file.file_link",
    "id": "flk_5mNpQrStUvWxYzAb",
    "file_id": "fil_9jKlMnPqRsTuVwXy",
    "url": "https://files.metorial.com/files/fil_9jKlMnPqRsTuVwXy/a8f3k2m9",
    "created_at": "2026-10-17T09:50:02.672Z",
    "expires_at": "2026-10-17T09:50:02.672Z"
  },
  "created_by": {
    "type": "organization_actor",
    "name": "example_name",
    "image_url": "example_image_url",
    "email": "example_email",
    "organization_actor": {
      "object": "organization.actor",
      "id": "omem_5fGhJkLmNpQrStUv",
      "type": "member",
      "organization_id": "org_7hNkPqRsTuVwXyZa",
      "name": "Alex Chen",
      "email": "[email protected]",
      "image_url": "https://avatar-cdn.metorial.com/aimg_1234567890",
      "member": {
        "object": "organization.member#preview",
        "id": "ome_7hNkPqRsTuVwXyZa",
        "status": "active",
        "role": "member"
      },
      "teams": [
        {
          "id": "tm_3eFgHjKlMnPqRsTu",
          "name": "Engineering",
          "slug": "engineering",
          "assignment_id": "tmas_8jKlMnPqRsTuVwXy"
        },
        {
          "id": "tm_3eFgHjKlMnPqRsTu",
          "name": "Engineering",
          "slug": "engineering",
          "assignment_id": "tmas_8jKlMnPqRsTuVwXy"
        }
      ],
      "created_at": "2026-10-17T09:50:02.672Z",
      "updated_at": "2026-10-17T09:50:02.672Z"
    },
    "consumer": {
      "object": "consumer",
      "id": "example_id",
      "name": "example_name",
      "email": "example_email",
      "image_url": "example_image_url",
      "user_id": "example_user_id",
      "created_at": "2026-10-17T09:50:02.672Z",
      "updated_at": "2026-10-17T09:50:02.672Z"
    },
    "consumer_profile": {
      "object": "consumer.profile",
      "id": "example_id",
      "name": "example_name",
      "email": "example_email",
      "image_url": "example_image_url",
      "consumer_id": "example_consumer_id",
      "user_id": "example_user_id",
      "status": "active",
      "created_at": "2026-10-17T09:50:02.672Z",
      "updated_at": "2026-10-17T09:50:02.672Z",
      "groups": [
        {
          "object": "consumer.profile.group_assignment",
          "group": {
            "object": "consumer.group",
            "id": "example_id",
            "status": "active",
            "name": "example_name",
            "description": "example_description",
            "is_default": false,
            "created_at": "2026-10-17T09:50:02.672Z",
            "updated_at": "2026-10-17T09:50:02.672Z"
          },
          "assigned_via": "default"
        }
      ]
    }
  },
  "created_at": "2026-10-17T09:50:02.672Z",
  "started_at": "2026-10-17T09:50:02.672Z",
  "completed_at": "2026-10-17T09:50:02.672Z"
}
object"skill.export"required
idstringrequired
target"skill" | "plugin" | "marketplace"required
status"pending" | "completed" | "failed"required
created_atdaterequired
started_atdaterequirednullable
completed_atdaterequirednullable

Endpoints

List skill exports

GET/skill-exports

Returns a paginated list of skill exports.

Query parameters

idstring or string[]optional
target"skill" | "plugin" | "marketplace" or "skill" | "plugin" | "marketplace"[]optional
status"pending" | "completed" | "failed" or "pending" | "completed" | "failed"[]optional

Example request

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

Get skill export

GET/skill-exports/:skill_export_id

Retrieves a skill export.

Path parameters

skill_export_idstringrequired

The unique identifier for the skill_export

Example request

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

Create skill export

POST/skill-exports

Creates a skill, plugin, or marketplace export.

Request body

target"skill" | "plugin" | "marketplace"required
skill_idstringoptional
skill_plugin_idstringoptional
skill_marketplace_idstringoptional

Example request

curl -X POST "https://api.metorial.com/skill-exports" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_io2h4..." \
  -d '{
  "target": "skill",
  "skill_id": "example_skill_id",
  "skill_plugin_id": "example_skill_plugin_id",
  "skill_marketplace_id": "example_skill_marketplace_id"
}'