Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.auvy.ai/llms.txt

Use this file to discover all available pages before exploring further.

​
Skills API

Skills are versioned markdown documents with optional tool links (Connect integration + tool scope). They live on the vault/document lane with kind: skill and are brain-scoped when brain_id is set. Requires API key auth. Brain-scoped lists and mutations need X-Brain-Id (or brain_id in body on create).

​
List

GET /v1/skills?limit=50&brain_id=<uuid>

const auvy = await fromApiKey()
const skills = await auvy.skills.list({ brain_id: brainId, limit: 50 })
Query: limit, offset, brain_id, sortBy (created_at | updated_at | name), sortDirection.

​
Get

GET /v1/skills/:id

const skill = await auvy.skills.get(skillId)
// { id, body_md, skill_path, tool_links, latest_version, ... }

​
Create

POST /v1/skills

{
  "body_md": "# Incident runbook\n\n1. Check status page…",
  "brain_id": "<uuid>",
  "path_name": "incident-runbook",
  "tool_links": [
    { "integration_id": "<uuid>", "scope_path": "slack.channels.read" }
  ]
}

const created = await auvy.skills.create({
  body_md: '# My skill',
  brain_id: brainId,
  tool_links: [],
})

​
Update

PUT /v1/skills/:id

await auvy.skills.update(skillId, { body_md: '# Updated content' })

​
Delete

DELETE /v1/skills/:id

await auvy.skills.delete(skillId)

​
SDK namespace

auvy.skills — see SDK resources (skills row).
  • Neurons — attach skills to agent config
  • Connect SDK — integration ids for tool_links