MEmetorial
Skills

Share skill

Shares a skill with consumers or organization members.

post/skills/{skill_id}/shares

Request

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

Path parameters

skill_idstring required

Unique identifier of the skill.

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.

Request body

consumer_profile_idsstring[]
organization_member_idsstring[]
permission'none' | 'read' | 'write' required

Response

Successful response

object'skill' required
idstring required
status'active' | 'archived' | 'deleted' required
slugstring required
namestring required
descriptionstring nullable required
image_urlstring required
client_namestring required
client_descriptionstring nullable required
client_metadataobject nullable required
licensestring nullable required
compatibilitystring nullable required
metadataobject required
store_idstring required
created_atstring date-time required
updated_atstring date-time required

Example response

{
  "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.