API ReferenceLatest API (v2)Skills

Update Skill

Update skill metadata (name, description, enabled, etc.).

Authentication

X-Browser-Use-API-Keystring
API Key authentication via header

Path parameters

skill_idstringRequiredformat: "uuid"

Request

This endpoint expects an object.
titlestring or nullOptional<=100 characters

Display name for the skill (shows up in the public view)

descriptionstring or nullOptional<=1000 characters

Description of what the skill does (shows up in the public view)

categorieslist of enums or nullOptional
Categories to assign to the skill
domainslist of strings or nullOptional

Domains/websites this skill interacts with

isEnabledboolean or nullOptional
Whether the skill is enabled for execution

Response

Successful Response
idstringformat: "uuid"
Unique identifier for the skill
titlestring

Title of the skill (shows up in the public view)

descriptionstring

Description of the skill (shows up in the public view)

categorieslist of enums
Categories of the skill
domainslist of strings

Domains/websites this skill interacts with

statusenum
Status of the skill
parameterslist of objects
Input parameters of the skill
outputSchemamap from strings to any
Output schema of the skill
isEnabledboolean
Whether the skill is enabled
isPublicboolean
Whether the skill is publicly available
currentVersioninteger or null
Current version of the skill
createdAtdatetime
Creation timestamp
updatedAtdatetime
Last update timestamp
slugstring or null

URL-friendly slug for the skill

goalstring or null

Goal of the skill (not shown in the public view)

agentPromptstring or null

Prompt for the agent to use when generating the skill automatically (not shown in the public view)

iconUrlstring or null
URL of the custom skill icon
firstPublishedAtdatetime or null
When the skill was first published
lastPublishedAtdatetime or null
When the skill was last published
currentVersionStartedAtdatetime or null
When the current version started generating
currentVersionFinishedAtdatetime or null
When the current version finished generating
codestring or null
Base64 encoded generated code (contact support@browser-use.com to get access) - ENTERPRISE ONLY
clonedFromSkillIdstring or nullformat: "uuid"
Unique identifier for the skill this skill was cloned from

Errors