Sign in
Skills

Create a Skill

Pre-release Endpoint This endpoint is currently in beta and is subject to change.

Create a skill for the specified Context Interface. The source determines where the skill's content comes from.

post/v1/context-interfaces/{interfaceId}/skills

Request body

namestring required

The machine name of the skill. Must be unique within the MCP server and must match the name declared in the frontmatter.

display_namestring required

The human-readable display name of the skill.

descriptionstring required

A description of the skill.

labelsLabels required

Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.

Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".

Example request

{
  "name": "pdf-processing",
  "display_name": "PDF Processing",
  "description": "Extract and summarize content from PDF documents",
  "source": {
    "type": "raw",
    "config": {
      "contents": "---\nname: pdf-processing\ndescription: Extract and summarize content from PDF documents\n---\n# PDF Processing\n..."
    }
  },
  "labels": {
    "env": "test"
  }
}

Response

A response to creating a skill.

idstring uuid required

The unique identifier for the skill.

context_interface_idstring uuid required

The ID of the Context Interface this skill belongs to.

namestring required

The machine name of the skill.

display_namestring required

The human-readable display name of the skill.

descriptionstring required

A description of the skill.

labelsLabels required

Labels store metadata of an entity that can be used for filtering an entity list or for searching across entity types.

Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".

status'pending' | 'valid' | 'invalid' required

The current validation status of the skill. pending means the content has not yet been read and validated.

validation_messagestring nullable required

The reason the skill failed validation. null unless status is invalid.

created_atstring date-time required

An ISO-8601 timestamp representation of entity creation date.

updated_atstring date-time required

An ISO-8601 timestamp representation of entity update date.

Example response

{
  "labels": {
    "env": "test"
  },
  "created_at": "2022-11-04T20:10:06.927Z",
  "updated_at": "2022-11-04T20:10:06.927Z"
}

Changes

Changed in 1 of the 83 revisions of this API.1