Skills

List skills

Returns a paginated list of skills.

get/skills

Request

  • Base URL
    https://api.metorial.com
  • Auth
    HTTP bearer

Query parameters

limitnumber
afterstring
beforestring
cursorstring
order'asc' | 'desc'
searchstring
'active' | 'archived' | 'deleted'
OR
string[]
string
OR
string[]
string
OR
string[]
string
OR
string[]
string
OR
string[]
gtstring date-time

Only include records after this timestamp for skill creation time

ltstring date-time

Only include records before this timestamp for skill creation time

Filter skill creation time by date range

gtstring date-time

Only include records after this timestamp for skill last update time

ltstring date-time

Only include records before this timestamp for skill last update time

Filter skill last update time by date range

Headers

Metorial-Versionstring
Example:2025-01-01

Pin the dated API version for this request, e.g. 2025-01-01. Defaults to the version configured for the environment.

Response

Successful response

Example response

{
  "items": [
    {
      "hierarchy": {
        "creator": {
          "organization_actor": {
            "id": "omem_5fGhJkLmNpQrStUv",
            "organization_id": "org_7hNkPqRsTuVwXyZa",
            "name": "Alex Chen",
            "email": "alex.chen@acme.com",
            "image_url": "https://avatar-cdn.metorial.com/aimg_1234567890",
            "member": {
              "id": "ome_7hNkPqRsTuVwXyZa"
            },
            "teams": [
              {
                "id": "tm_3eFgHjKlMnPqRsTu",
                "name": "Engineering",
                "slug": "engineering",
                "assignment_id": "tmas_8jKlMnPqRsTuVwXy"
              }
            ]
          }
        },
        "fork": {
          "creator": {
            "organization_actor": {
              "id": "omem_5fGhJkLmNpQrStUv",
              "organization_id": "org_7hNkPqRsTuVwXyZa",
              "name": "Alex Chen",
              "email": "alex.chen@acme.com",
              "image_url": "https://avatar-cdn.metorial.com/aimg_1234567890",
              "member": {
                "id": "ome_7hNkPqRsTuVwXyZa"
              },
              "teams": [
                {
                  "id": "tm_3eFgHjKlMnPqRsTu",
                  "name": "Engineering",
                  "slug": "engineering",
                  "assignment_id": "tmas_8jKlMnPqRsTuVwXy"
                }
              ]
            }
          },
          "original_creator": {
            "organization_actor": {
              "id": "omem_5fGhJkLmNpQrStUv",
              "organization_id": "org_7hNkPqRsTuVwXyZa",
              "name": "Alex Chen",
              "email": "alex.chen@acme.com",
              "image_url": "https://avatar-cdn.metorial.com/aimg_1234567890",
              "member": {
                "id": "ome_7hNkPqRsTuVwXyZa"
              },
              "teams": [
                {
                  "id": "tm_3eFgHjKlMnPqRsTu",
                  "name": "Engineering",
                  "slug": "engineering",
                  "assignment_id": "tmas_8jKlMnPqRsTuVwXy"
                }
              ]
            }
          }
        }
      },
      "providers": [
        {
          "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"
        }
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.