skill-collections

PUT /skill-collections/{collectionId}

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

Request

  • Base URL
    https://YOUR_ORG_ID.gatana.ai/api/v1
  • URL
    https://YOUR_ORG_ID.gatana.ai/api/v1/skill-collections/{collectionId}
  • Auth
    • HTTP bearer
    • or OAuth 2
      Authorization code: /oauth/authorize
      Token URL: /oauth/token

Path parameters

collectionIdstring required

Request body

namestring
descriptionstring

One line saying what the collection gathers

visibility'organization' | 'private'

Response

Successful response

idstring required
namestring required

Unique name in the organization; what the CLI subscribes to

descriptionstring required

One line saying what the collection gathers

visibility'organization' | 'private' required
createdByUserIdstring required
createdByUserNamestring required

Display name of the creator, empty when no name is set or the account is removed

createdByUserEmailstring required

Email of the creator, empty when the account is removed

sharedWithUserIdsSchema1345[] required

IDs of the users the collection is shared with, any role

sharedWithTeamIdsSchema1347[] required

IDs of the teams the collection is shared with, any role

maintainerUserIdsSchema1349[] required

IDs of the users that maintain the collection

maintainerTeamIdsSchema1351[] required

IDs of the teams whose members maintain the collection

skillCountnumber required

How many skills in it the caller can read

createdAtstring required
updatedAtstring required

Changes

No recorded changes to this operation across all 12 revisions of this API.