Skip to main content
POST
/
projects
/
{project_reference}
/
skills
Create Skill
curl --request POST \
  --url https://api.veryfront.com/projects/{project_reference}/skills \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "allowed_tools": [
    "<string>"
  ],
  "sections": {
    "Summary": "<string>",
    "Usage": "<string>",
    "Examples": "<string>",
    "Notes": "<string>"
  },
  "source": "<string>"
}
'
{
  "id": "<string>",
  "name": "<string>",
  "description": "<string>",
  "source_path": "<string>",
  "sections": {
    "Summary": "<string>",
    "Usage": "<string>",
    "Examples": "<string>",
    "Notes": "<string>"
  },
  "source": "<string>",
  "source_only_reasons": [
    "<string>"
  ],
  "allowed_tools": [
    "<string>"
  ]
}

Authorizations

​
Authorization
string
header
required

Use a JWT bearer token or a Veryfront API key in the Authorization header.

Path Parameters

​
project_reference
string
required

Query Parameters

​
source_target_kind
string
​
target_branch_id
string<uuid> | null

Body

application/json
​
id
string
required
Minimum string length: 1
​
name
string
required
Minimum string length: 1
​
description
string
required
Minimum string length: 1
​
allowed_tools
string[]
Minimum string length: 1
​
sections
object
​
source
string
Minimum string length: 1

Response

Created project skill document

​
id
string
required
​
name
string
required
​
description
string
required
​
source_path
string
required
​
edit_mode
enum<string>
required
Available options:
structured,
source_only
​
sections
object
required
​
source
string
required
​
source_only_reasons
string[]
required
​
allowed_tools
string[]