GAgatana
skills

POST /skills

Changed on

Create a skill from a SKILL.md document, or from a name, a one-line description of when to use it and Markdown instructions, at root or in a collection

Request

  • Base URL
    https://YOUR_ORG_ID.gatana.ai/api/v1
  • URL
    https://YOUR_ORG_ID.gatana.ai/api/v1/skills
  • Auth
    • HTTP bearer
    • or OAuth 2
      Authorization code: /oauth/authorize
      Token URL: /oauth/token

Request body

markdownstring

The whole skill as one SKILL.md document: a frontmatter block with name and description, then the instructions. The three fields are taken from it, so name, description and content are not given alongside

namestring
descriptionstring

One line saying when to use the skill, written for an agent deciding whether it applies

contentstring

The instructions as Markdown: the body of a SKILL.md without the frontmatter. Maximum 200 KiB

visibility'organization' | 'private'
collectionIdstring

Response

Successful response

idstring required
namestring required

Unique name in the organization; how agents address the skill

descriptionstring required

One line saying when to use the skill

visibility'organization' | 'private' required
collectionIdstring required
collectionNamestring required
contentBytesnumber required

Size of the Markdown body in bytes

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

sharedWithUserIdsSchema1318[] required

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

sharedWithTeamIdsSchema1320[] required

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

maintainerUserIdsSchema1322[] required

IDs of the users that maintain the skill: the same rights as the creator

maintainerTeamIdsSchema1324[] required

IDs of the teams whose members maintain the skill

collectionVisibility'organization' | 'private' required
collectionSharedWithUserIdsSchema1327[] required

Users with access through the collection, any role

collectionSharedWithTeamIdsSchema1329[] required

Teams with access through the collection, any role

collectionMaintainerUserIdsSchema1331[] required

Users that maintain the collection, and so this skill

collectionMaintainerTeamIdsSchema1333[] required

Teams that maintain the collection, and so this skill

createdAtstring required
updatedAtstring required

Changes

  • 2d7044033b1eRevision changes
    • info

      added to the response property anyOf list for the response status

    • info

      added to the response property anyOf list for the response status

    • info

      added to the response property anyOf list for the response status

    • info

      removed from the response property anyOf list for the response status

    • info

      removed from the response property anyOf list for the response status

    • info

      removed from the response property anyOf list for the response status

  • bb62e8b46ac2Revision changes
    • info

      added to the response property anyOf list for the response status

    • info

      added to the response property anyOf list for the response status

    • info

      added to the response property anyOf list for the response status

    • info

      removed from the response property anyOf list for the response status

    • info

      removed from the response property anyOf list for the response status

    • info

      removed from the response property anyOf list for the response status