Skip to content
Aura

Put Project Skill

PUT
/api/v1/projects/{project_id}/skills/{skill}
curl --request PUT \
  --url https://aura-api-eu.strangeworks.com/api/v1/projects/example/skills/example \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "files": { "additionalProperty": "example" } }'

Create or replace one of this project’s own customer skills.

Writes only the project’s own scope. Naming it after one of the deployment’s shadows that skill here without changing the deployment. Replaces the skill’s whole file set rather than merging, so a file dropped locally does not linger server-side.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
project_id
required
Project Id
string
skill
required
Skill
string

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
SkillWriteRequest

One skill’s files, keyed by path relative to the skill’s own directory.

Must include SKILL.md. Text only — a skill is instructions plus the occasional reference file, and the bodies travel to the sandbox in the turn payload.

object
files
required
Files
object
>= 1 properties
key
additional properties
string
Examplegenerated
{
  "files": {
    "additionalProperty": "example"
  }
}

Responses

Section titled “Responses”

200

Section titled “200”

Successful Response

Media typeapplication/json
SkillSummary
object
description
required
Description
string
files
required
Files
Array<string>
name
required
Name
string
Examplegenerated
{
  "description": "example",
  "files": [
    "example"
  ],
  "name": "example"
}

422

Section titled “422”

Validation Error

Media typeapplication/json
HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
ctx
Context
object
input
Input
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string
Examplegenerated
{
  "detail": [
    {
      "ctx": {},
      "input": "example",
      "loc": [
        "example"
      ],
      "msg": "example",
      "type": "example"
    }
  ]
}