Gatana logoGatana Docs
Routes

Share Skill

Share a skill with a user or a team as reader or maintainer, whatever its visibility, and return who it is shared with

PUT
/skills/{skillId}/shares/{memberType}/{memberId}
AuthorizationBearer <token>

In: header

Path Parameters

skillId*string
memberType*string

'users' to share with one user account, 'teams' to share with every member of a team

Value in"users" | "teams"
memberId*string

ID of the user or of the team

Length1 <= length

Request Body

application/json

role?string

'read' (the default) opens it to the principal; 'maintain' gives them the same rights as the creator and the organization owners

Value in"read" | "maintain"

Response Body

application/json

curl -X PUT "https://YOUR_ORG_ID.gatana.ai/api/v1/skills/string/shares/users/string" \  -H "Content-Type: application/json" \  -d '{}'
{
  "users": [
    {
      "id": "string",
      "name": "string",
      "email": "string",
      "role": "read"
    }
  ],
  "teams": [
    {
      "id": "string",
      "name": "string",
      "memberCount": 0,
      "role": "read"
    }
  ],
  "inherited": {
    "collectionId": "string",
    "collectionName": "string",
    "visibility": "organization",
    "users": [
      {
        "id": "string",
        "name": "string",
        "email": "string",
        "role": "read"
      }
    ],
    "teams": [
      {
        "id": "string",
        "name": "string",
        "memberCount": 0,
        "role": "read"
      }
    ]
  }
}