Skip to main content
PUT
Error

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

alias
string<string>
required

The app's namespace or its UUID

id
string<string>
required

The resource ID

Body

application/json

Skill update request

Body for PUT /v1/apps/{alias}/skills/{id}.

skill
object
required

Skill fields to change. Omitted fields keep their current value.

tools
object[]

Optional tool list. If present, the skill's existing tools are replaced with this list.

Response

Ok

A skill returned by the skills endpoints.

instructions
string

System prompt steering the skill's behavior

app
object
status
enum<string>

Lifecycle status of the skill

Available options:
ACTIVE,
INACTIVE,
DRAFT
tools
object

Connection of tools attached to the skill

id
string<uuid>

The skill ID

properties
object

Type-specific skill configuration

name
string

The skill's display name

type
enum<string>

Skill kind

Available options:
INTERNAL,
CUSTOM
description
string

Short summary of what the skill does