Skills

List skills

GET

https://api.lelemon.cl

/v2/agents/{id}/skills

Bearer (API key)

Newest first, without the content.

Required scope: skills:read.

List skills › path Parameters

id

string · pattern: ^agt_[0-9A-Za-z]{22}… · required

The id of the agent (agt_…).

List skills › query Parameters

limit

integer · min: 1 · max: 100

Default: 20

cursor

string · maxLength: 512

The nextCursor of the previous page, with the same filters.

List skills › Headers

Lelemon-Subaccount

string · pattern: ^sub_[0-9A-Za-z]{22}…

The subaccount (sub_…) this request acts on. Only for the keys of a platform account; without it the request acts on the account itself.

List skills › Responses

SkillList

object

string · enum · required

Enum values:

list

hasMore

boolean · required

nextCursor

string | null · required

Skill[] · required

Create a skill

POST

https://api.lelemon.cl

/v2/agents/{id}/skills

Bearer (API key)

Writes know-how the agent loads only when the conversation needs it. In the prompt travels only the name and the description; the content is loaded by the agent when it is about to do that task, with a loading tool the agent receives on its own as soon as it has at least one skill. You do not grant it and it does not appear in the agent tools. An agent holds up to 30 skills.

Required scope: skills:write.

Create a skill › path Parameters

id

string · pattern: ^agt_[0-9A-Za-z]{22}… · required

The id of the agent (agt_…).

Create a skill › Headers

Lelemon-Subaccount

string · pattern: ^sub_[0-9A-Za-z]{22}…

The subaccount (sub_…) this request acts on. Only for the keys of a platform account; without it the request acts on the account itself.

Idempotency-Key

string · minLength: 1 · maxLength: 255

Makes the request safe to retry. Once it starts running, its final response (2xx, 4xx or 5xx) is kept for 24 hours and the same key gets it back, without repeating the effect. A request rejected before it runs leaves the key free. A replayed create omits the secret. The same key with a different request is rejected with 409 idempotency_key_reused.

Create a skill › Request Body

CreateSkill

name

string · maxLength: 255 · pattern: \S · required

How you see it.

description

string · maxLength: 500 · pattern: \S · required

One line that says WHEN to load it. It is the only part of the skill that travels in the prompt, in every message, so keep it short.

content

string · maxLength: 20000 · pattern: \S · required

The full instructions, in Markdown. The agent loads them when it is about to do that task.

slug

string · maxLength: 100 · pattern: ^[a-z0-9]+(-[a-z0-9]…

The identifier the agent uses to load it. It cannot change. Defaults to the name in lowercase with hyphens. Creating again with the same slug and the same content returns the same skill; with different content it is a 409.

requires

string[] · maxItems: 5 · unique

Slugs of other skills of the same agent that the agent receives first, in full, every time it loads this one. One level only: a required skill cannot require another. Up to 5.

Create a skill › Responses

SkillWithContent

object

string · enum · required

Enum values:

skill

id

string · required

slug

string · required

name

string · required

description

string · required

requires

string[] · required

createdAt

string · date-time · required

updatedAt

string · date-time · required

content

string · required

Markdown.

POST/v2/agents/{id}/skills

curl https://api.lelemon.cl/v2/agents/:id/skills \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer <token>' \
  --data '{
  "name": "Late order",
  "description": "Load it when a customer says an order arrived late.",
  "content": "# Late order\n\nApologize once, check the delivery with the order action and offer the refund policy.",
  "slug": "late-order"
}'

Example Request Body

{
  "name": "Late order",
  "description": "Load it when a customer says an order arrived late.",
  "content": "# Late order\n\nApologize once, check the delivery with the order action and offer the refund policy.",
  "slug": "late-order"
}

json

application/json

Example Responses

{
  "object": "skill",
  "id": "skl_2Wq9Lm3tYbZc01aKq9RvXn",
  "slug": "late-order",
  "name": "name",
  "description": "description",
  "requires": [
    "string"
  ],
  "createdAt": "2024-08-25T15:00:00Z",
  "updatedAt": "2024-08-25T15:00:00Z",
  "content": "content"
}

json

application/json

Retrieve a skill

GET

https://api.lelemon.cl

/v2/agents/{id}/skills/{skillId}

Bearer (API key)

Includes the content.

Required scope: skills:read.

Retrieve a skill › path Parameters

id

string · pattern: ^agt_[0-9A-Za-z]{22}… · required

The id of the agent (agt_…).

skillId

string · pattern: ^skl_[0-9A-Za-z]{22}… · required

The id of the skill (skl_…).

Retrieve a skill › Headers

Lelemon-Subaccount

string · pattern: ^sub_[0-9A-Za-z]{22}…

The subaccount (sub_…) this request acts on. Only for the keys of a platform account; without it the request acts on the account itself.

Retrieve a skill › Responses

SkillWithContent

object

string · enum · required

Enum values:

skill

id

string · required

slug

string · required

name

string · required

description

string · required

requires

string[] · required

createdAt

string · date-time · required

updatedAt

string · date-time · required

content

string · required

Markdown.

Delete a skill

DELETE

https://api.lelemon.cl

/v2/agents/{id}/skills/{skillId}

Bearer (API key)

Deletes the skill from your organization and removes it from every agent that had it, not only this one. Answers 409 while another skill requires it.

Required scope: skills:write.

Delete a skill › path Parameters

id

string · pattern: ^agt_[0-9A-Za-z]{22}… · required

The id of the agent (agt_…).

skillId

string · pattern: ^skl_[0-9A-Za-z]{22}… · required

The id of the skill (skl_…).

Delete a skill › Headers

Lelemon-Subaccount

string · pattern: ^sub_[0-9A-Za-z]{22}…

The subaccount (sub_…) this request acts on. Only for the keys of a platform account; without it the request acts on the account itself.

Delete a skill › Responses

Deleted.

No data returned

Update a skill

PATCH

https://api.lelemon.cl

/v2/agents/{id}/skills/{skillId}

Bearer (API key)

Changes only what you send. The slug cannot change. The change reaches every agent that has this skill.

Required scope: skills:write.

Update a skill › path Parameters

id

string · pattern: ^agt_[0-9A-Za-z]{22}… · required

The id of the agent (agt_…).

skillId

string · pattern: ^skl_[0-9A-Za-z]{22}… · required

The id of the skill (skl_…).

Update a skill › Headers

Lelemon-Subaccount

string · pattern: ^sub_[0-9A-Za-z]{22}…

The subaccount (sub_…) this request acts on. Only for the keys of a platform account; without it the request acts on the account itself.

Update a skill › Request Body optional

UpdateSkill

name

string · minLength: 1 · maxLength: 255 · pattern: \S

description

string · maxLength: 500 · pattern: \S

content

string · maxLength: 20000 · pattern: \S

requires

string[] · maxItems: 5 · unique

Slugs of other skills of the same agent that the agent receives first, in full, every time it loads this one. One level only: a required skill cannot require another. Up to 5.

Update a skill › Responses

SkillWithContent

object

string · enum · required

Enum values:

skill

id

string · required

slug

string · required

name

string · required

description

string · required

requires

string[] · required

createdAt

string · date-time · required

updatedAt

string · date-time · required

content

string · required

Markdown.

Data connectors Agent tools