---
title: "POST /falcon-ai/skills/"
method: POST
path: "/falcon-ai/skills/"
tags: ["falcon-ai"]
---

# POST /falcon-ai/skills/

`POST /falcon-ai/skills/`

## Request

- Base URL: `http://localhost:8000`
- URL: `http://localhost:8000/falcon-ai/skills/`
- Auth: one of:
  - API key in header `X-Api-Key`
  - API key in header `X-Secret-Key`

List and create skills.

## Request body

- SkillCreate
  - `name` string, required
  - `description` string
  - `icon` string
  - `instructions` string, required
  - `tool_names` string[]
  - `trigger_phrases` string[], required

## Response `201`

Created

- SkillDetailResponse
  - `status` boolean, required
  - `result` SkillDetail, required
    - `id` string, uuid
    - `name` string, required
    - `slug` string, slug, required
    - `description` string
    - `icon` string
    - `is_builtin` boolean
    - `is_active` boolean
    - `instructions` string
    - `tool_names` object
    - `example_trajectories` object
    - `trigger_phrases` object
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `created_by_display` string

## Other responses

- `403`: Forbidden
- `409`: Conflict
- `default`: Default error response

---

[API](https://skmtc.dev/futureagi/apis/future-agi-management-api.md) · [All operations](https://skmtc.dev/futureagi/apis/future-agi-management-api/llms.txt) · [OpenAPI document](https://skmtc.dev/futureagi/apis/future-agi-management-api/revisions/c8684118e142?raw)