Skip to main content
POST
/
api
/
v1
/
skills
Create Skill
curl --request POST \
  --url https://control-plane.kubiya.ai/api/v1/skills \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "<string>",
  "type": "<string>",
  "description": "<string>",
  "icon": "<string>",
  "enabled": true,
  "configuration": {
    "base_dir": "<string>",
    "enable_save_file": true,
    "enable_read_file": true,
    "enable_list_files": true,
    "enable_search_files": true,
    "allowed_commands": [
      "<string>"
    ],
    "blocked_commands": [
      "<string>"
    ],
    "timeout": 123,
    "enable_container_management": true,
    "enable_image_management": true,
    "enable_volume_management": true,
    "enable_network_management": true,
    "enable_code_execution": true,
    "allowed_imports": [
      "<string>"
    ],
    "blocked_imports": [
      "<string>"
    ],
    "enable_json_generation": true,
    "enable_csv_generation": true,
    "enable_pdf_generation": true,
    "enable_txt_generation": true,
    "output_directory": "<string>",
    "max_diagram_size": 123,
    "enable_flowchart": true,
    "enable_sequence": true,
    "enable_class_diagram": true,
    "enable_er_diagram": true,
    "enable_gantt": true,
    "enable_pie_chart": true,
    "enable_state_diagram": true,
    "enable_git_graph": true,
    "enable_user_journey": true,
    "enable_quadrant_chart": true,
    "workflow_type": "<string>",
    "workflow_definition": "<string>",
    "python_dsl_code": "<string>",
    "validation_enabled": true,
    "default_runner": "<string>",
    "custom_class": "<string>",
    "custom_config": {}
  }
}'
{
  "id": "<string>",
  "organization_id": "<string>",
  "name": "<string>",
  "type": "<string>",
  "description": "<string>",
  "icon": "<string>",
  "enabled": true,
  "configuration": {},
  "created_at": "<string>",
  "updated_at": "<string>"
}

Body

application/json
name
string
required

Skill name

type
string
required

Skill type (file_system, shell, docker, python, etc.)

description
string | null

Skill description

icon
string | null
default:Wrench

Icon name

enabled
boolean
default:true

Whether skill is enabled

configuration
object

Configuration for a skill

Response

Successful Response

id
string
required
organization_id
string
required
name
string
required
type
string
required
description
string | null
required
icon
string
required
enabled
boolean
required
configuration
object
required
created_at
string
required
updated_at
string
required