Skip to main content
PUT
/
public-api
/
skills
/
{skill_id}
Replace whole files / rename a skill
curl --request PUT \
  --url https://api.neoagent.io/public-api/skills/{skill_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data @- <<EOF
{
  "files": [
    {
      "content": "print('reconcile v2')\n",
      "path": "scripts/reconcile.py"
    }
  ],
  "source_run_id": "24183-0610"
}
EOF
{
  "data": {
    "description": "<string>",
    "files": [
      {
        "content": "<string>",
        "id": "<string>",
        "path": "<string>",
        "version": 123
      }
    ],
    "id": "<string>",
    "name": "<string>",
    "slug": "<string>",
    "source_run_id": "<string>",
    "updated_at": "<string>"
  },
  "meta": {
    "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "timings_ms": {},
    "pagination": {
      "has_more": true,
      "next_cursor": "<string>"
    },
    "warnings": [
      "<string>"
    ]
  }
}

Authorizations

​
Authorization
string
header
required

Authorization: Bearer <token> where <token> is either a neo_sk_<env>_<secret> API key (service account) or a Microsoft Entra ID access token (dashboard user).

Path Parameters

​
skill_id
string
required

Body

application/json

PUT — replace whole files and/or update metadata. Supply files to add a new version of each given path; supply any of name/description/source_run_id to update metadata (omitted fields keep their current value). At least one of these is required.

​
description
string | null
​
files
SkillFileInput · object[] | null
​
name
string | null
​
source_run_id
string | null

Response

Success.

​
data
PublicSkill · object
required

A tenant skill read whole — the row plus the latest version of each file.

​
meta
object
required