Skill Agents

Manage sub-agents attached to a skill.

Skill Agents object

Attributes

object

String

String representing the object's type

id

String

skill_id

String

name

String

description

StringNullable

slug

String

status

Enum

store_id

String

store_item_id

StringNullable

path

StringNullable

document_id

String

archived_at

DateNullable

created_at

Date

updated_at

Date
{
  "object": "skill.agent",
  "status": "active"
}

Create skill agent

Creates a new agent document in the skill agents directory.

URL Parameters

skill_id

String

The unique identifier for the skill

Request Body

name

String

description

StringOptionalNullable

content

StringOptional
POSThttp://api.metorial.com/skills/:skill_id/agents
curl -X POST "https://api.metorial.com/skills/ski_Rm4Mnheq2bfEPhBhP7SY/agents" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..." \
  -d '{
  "name": "example_name",
  "description": "example_description",
  "content": "example_content"
}'

List skill agents

Returns a paginated list of agents for a specific skill.

URL Parameters

skill_id

String

The unique identifier for the skill

Query Parameters

limit

NumberOptional

after

StringOptional

before

StringOptional

cursor

StringOptional

order

EnumOptional

include_archived

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

Get skill agent by ID

Retrieves a specific agent within a skill.

URL Parameters

skill_id

String

The unique identifier for the skill

skill_agent_id

String

The unique identifier for the skill_agent

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

Update skill agent

Updates the name or description for a specific skill agent.

URL Parameters

skill_id

String

The unique identifier for the skill

skill_agent_id

String

The unique identifier for the skill_agent

Request Body

name

StringOptional

description

StringOptionalNullable
PATCHhttp://api.metorial.com/skills/:skill_id/agents/:skill_agent_id
curl -X PATCH "https://api.metorial.com/skills/ski_Rm4Mnheq2bfEPhBhP7SY/agents/ski_Rm4Mnheq2bfEPhBhP7SY" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer metorial_sk_..." \
  -d '{
  "name": "example_name",
  "description": "example_description"
}'

Delete skill agent

Archives a specific skill agent and removes its linked store item.

URL Parameters

skill_id

String

The unique identifier for the skill

skill_agent_id

String

The unique identifier for the skill_agent

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