Skill Configurations

Manage configuration profiles for skill execution.

Skill Configurations object

Attributes

object

String

String representing the object's type

id

String

is_default

Boolean

allow_scripts

Boolean

allowed_file_extensions

Array of Strings

allow_non_standard_directories

Boolean

deleted_at

DateNullable

created_at

Date

updated_at

Date
{
  "object": "skill.configuration"
}

Create skill configuration

Creates a new non-default skill configuration.

Request Body

allow_scripts

BooleanOptional

allowed_file_extensions

Array of StringsOptionalNullable

allow_non_standard_directories

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

List skill configurations

Returns a paginated list of visible skill configurations.

Query Parameters

limit

NumberOptional

after

StringOptional

before

StringOptional

cursor

StringOptional

order

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

Get skill configuration

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

URL Parameters

skill_configuration_id

String

The unique identifier for the skill_configuration

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

Update skill configuration

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

URL Parameters

skill_configuration_id

String

The unique identifier for the skill_configuration

Request Body

allow_scripts

BooleanOptional

allowed_file_extensions

Array of StringsOptionalNullable

allow_non_standard_directories

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

Delete skill configuration

Soft deletes a specific non-internal skill configuration.

URL Parameters

skill_configuration_id

String

The unique identifier for the skill_configuration

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