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
tools?
resources?
[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.

Lists Markdown files in the specified GitHub repository for import. The token is used only for this request and is not saved. Use the GitHub skill-generation action to fetch a selected file and generate a draft skill.

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.