MetorialDocs

Skill Participants

Inspect participants associated with an instance skill.

The Skill Participant object

skill_participant.json
{
  "object": "skill.participant",
  "id": "example_id",
  "skill_id": "example_skill_id",
  "roles": [
    "creator",
    "creator"
  ],
  "actor": {
    "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.669Z",
      "updated_at": "2026-10-17T09:50:02.669Z"
    },
    "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.669Z",
      "updated_at": "2026-10-17T09:50:02.669Z"
    },
    "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.669Z",
      "updated_at": "2026-10-17T09:50:02.669Z",
      "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.669Z",
            "updated_at": "2026-10-17T09:50:02.669Z"
          },
          "assigned_via": "default"
        }
      ]
    }
  },
  "created_at": "2026-10-17T09:50:02.669Z",
  "updated_at": "2026-10-17T09:50:02.669Z"
}
object"skill.participant"required
idstringrequired
skill_idstringrequired
roles"creator" | "editor" | "viewer" | "user" | "forker"[]required
created_atdaterequired
updated_atdaterequired

Endpoints

List skill participants

GET/skills/:skill_id/participants

Returns a paginated list of participants for a specific skill.

Path parameters

skill_idstringrequired

The unique identifier for the skill

Query parameters

Example request

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

Get skill participant by ID

GET/skills/:skill_id/participants/:skill_participant_id

Retrieves a specific participant within a skill.

Path parameters

skill_idstringrequired

The unique identifier for the skill

skill_participant_idstringrequired

The unique identifier for the skill_participant

Example request

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