FruxonDocs
IntegrationsSkills

Creates a new skill.

Persists a tenant-scoped skill and returns its assigned ID in the `Location` header. The skill becomes immediately eligible for agents in the same tenant — attach it via the agent configuration. To author the definition from a markdown file instead of writing it by hand, run `POST SkillGenerateFromMarkdown` or `POST SkillGenerateFromGitHub` first, then POST the result here.

POST
/v1/tenants/{tenant}/skills

Authorization

Bearer
AuthorizationBearer <token>

JWT Authorization header using the Bearer scheme. Enter 'Bearer' [space] and then your token.

In: header

Path Parameters

tenant*string

The tenant identifier

Request Body

The skill definition to create.

id*string
Length1 <= length
displayName*string
Length1 <= length
description*string
Length1 <= length
instructions?string|null
tools?|null
resources?|null
[key: string]?never

Response Body

curl -X POST "https://api.fruxon.com/v1/tenants/string/skills" \  -H "Content-Type: application/json" \  -d '{    "id": "string",    "displayName": "string",    "description": "string"  }'
{
  "id": "string",
  "displayName": "string",
  "description": "string",
  "instructions": "string",
  "tools": [
    {
      "integrationId": "string",
      "id": "string"
    }
  ],
  "resources": [
    {
      "assetId": "string",
      "description": "string",
      "vectorized": false
    }
  ],
  "type": "SYSTEM",
  "createdAt": 0,
  "modifiedAt": 0
}
{
  "type": "string",
  "title": "string",
  "status": 0,
  "detail": "string",
  "instance": "string",
  "property1": null,
  "property2": null
}
Empty
Empty

Lists importable markdown files from a GitHub repository.

Walks the given repo via the GitHub API and returns paths to every `.md` file found, so a UI can let the user pick which one to import. The provided token is used only for this request and is not persisted. Pair with `POST SkillGenerateFromGitHub` to fetch one of the listed files and produce a draft skill definition.

Updates an existing skill.

Full replace of the mutable fields on the skill. Agents that have this skill attached pick up the new instructions on their next turn — there is no per-conversation pinning. Built-in skills cannot be updated and will return 404.