MetorialDocs

Skill Configurations

Manage configuration profiles for skill execution.

The Skill Configuration object

skill_configuration.json
{
  "object": "skill.configuration",
  "id": "example_id",
  "is_default": false,
  "allow_scripts": false,
  "allowed_file_extensions": [
    "example_allowed_file_extensions"
  ],
  "allow_non_standard_directories": false,
  "deleted_at": "2026-10-17T09:50:02.660Z",
  "created_at": "2026-10-17T09:50:02.660Z",
  "updated_at": "2026-10-17T09:50:02.660Z"
}
object"skill.configuration"required
idstringrequired
is_defaultbooleanrequired
allow_scriptsbooleanrequired
allowed_file_extensionsstring[]required
allow_non_standard_directoriesbooleanrequired
deleted_atdaterequirednullable
created_atdaterequired
updated_atdaterequired

Endpoints

Create skill configuration

POST/skills/configurations

Creates a new non-default skill configuration.

Request body

allow_scriptsbooleanoptional
allowed_file_extensionsstring[]optionalnullable
allow_non_standard_directoriesbooleanoptional

Example request

curl -X POST "https://api.metorial.com/skills/configurations" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_io2h4..." \
  -d '{
  "allow_scripts": false,
  "allowed_file_extensions": [
    "example_allowed_file_extensions"
  ],
  "allow_non_standard_directories": false
}'

List skill configurations

GET/skills/configurations

Returns a paginated list of visible skill configurations.

Query parameters

Example request

curl -X GET "https://api.metorial.com/skills/configurations" \
  -H "Authorization: Bearer metorial_sk_io2h4..."

Get skill configuration

GET/skills/configurations/:skill_configuration_id

Retrieves a specific skill configuration by ID, or the default.

Path parameters

skill_configuration_idstringrequired

The unique identifier for the skill_configuration

Example request

curl -X GET "https://api.metorial.com/skills/configurations/ski_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_io2h4..."

Update skill configuration

PATCH/skills/configurations/:skill_configuration_id

Updates a specific skill configuration. Updating default creates it first if needed.

Path parameters

skill_configuration_idstringrequired

The unique identifier for the skill_configuration

Request body

allow_scriptsbooleanoptional
allowed_file_extensionsstring[]optionalnullable
allow_non_standard_directoriesbooleanoptional

Example request

curl -X PATCH "https://api.metorial.com/skills/configurations/ski_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_io2h4..." \
  -d '{
  "allow_scripts": false,
  "allowed_file_extensions": [
    "example_allowed_file_extensions"
  ],
  "allow_non_standard_directories": false
}'

Delete skill configuration

DELETE/skills/configurations/:skill_configuration_id

Soft deletes a specific non-internal skill configuration.

Path parameters

skill_configuration_idstringrequired

The unique identifier for the skill_configuration

Example request

curl -X DELETE "https://api.metorial.com/skills/configurations/ski_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Authorization: Bearer metorial_sk_io2h4..."