Skip to content
Aura

Put Deployment Skill

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

Create or replace one customer skill.

Replaces the skill’s whole file set rather than merging, so a file dropped locally does not linger server-side. A customer skill is mounted alongside Aura’s own and can never take one of their names.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
name
required
Name
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"
    }
  ]
}