Gatana logoGatana Docs
RoutesSkill collectionsCollectionid

/skill-collections/{collectionId}

Rename a skill collection, or change its description or general access

PUT
/skill-collections/{collectionId}
AuthorizationBearer <token>

In: header

Path Parameters

collectionId*string

Request Body

application/json

name?string

Name of the collection: lowercase letters, digits and single dashes, 1-64 characters, unique in the organization. What the CLI subscribes to

Match^[a-z0-9]+(-[a-z0-9]+)*$
Length1 <= length <= 64
description?string

One line saying what the collection gathers

Lengthlength <= 1024
visibility?string

'organization' (the default): every member can read the collection and its skills; 'private': the creator and the users and teams it is shared with

Value in"organization" | "private"

Response Body

application/json

curl -X PUT "https://YOUR_ORG_ID.gatana.ai/api/v1/skill-collections/string" \  -H "Content-Type: application/json" \  -d '{}'
{
  "id": "string",
  "name": "string",
  "description": "string",
  "visibility": "organization",
  "createdByUserId": "string",
  "createdByUserName": "string",
  "createdByUserEmail": "string",
  "sharedWithUserIds": [
    "string"
  ],
  "sharedWithTeamIds": [
    "string"
  ],
  "maintainerUserIds": [
    "string"
  ],
  "maintainerTeamIds": [
    "string"
  ],
  "skillCount": 0,
  "createdAt": "string",
  "updatedAt": "string"
}