Organizations

Create an organization skill

Changed on
post/api/experimental/organizations/{organization}/skills

Request

  • Base URL
    / (relative, and the document was published on a file host, not at the API’s origin)
  • URL
    /api/experimental/organizations/{organization}/skills
  • Auth
    API key in header Coder-Session-Token

Path parameters

organizationstring required

Organization ID or name

Request body

actionboolean

Action is only accepted for project skills and defaults to false.

contentstring

Content must be SKILL.md-format Markdown with YAML frontmatter. The frontmatter must include name, may include description, and must be followed by a non-empty body.

model_invocableboolean

ModelInvocable defaults to false when the content's frontmatter sets disable-model-invocation: true, and to true otherwise.

Response

Created

actionboolean

Action reports whether a project skill is offered as a one-click action above project composers. It is always false for personal and organization skills.

contentstring
created_atstring date-time
descriptionstring
enabledboolean
idstring uuid
model_invocableboolean

ModelInvocable reports whether agents can discover and load the skill on their own. Users can still invoke a skill explicitly when it is false.

namestring
updated_atstring date-time

Changes