Skip to content

Listar skills de la organización​

GET
/v1/org/{org_id}/skill

skill.view — OWNER ADMIN OPERATOR VIEWER

Opcionalmente filtrado por agente / huérfanas / archivadas.

Autorizaciones​

bearer

Token de servicio (kjtk_live_…), creado desde el panel en Ajustes → Tokens de servicio. Pertenece a una organización y lleva sus propios permisos.

Tipo
HTTP (bearer)
o
JWT

Sesión de una persona en el panel. No sirve para integrar.

Tipo
HTTP (bearer)

Parámetros​

Parámetros de la ruta

org_id*
Tipo
number
Requerido

Parámetros de consulta

agent_id

Restrict to skills assigned to this agent (handy for the per-agent view).

Tipo
number
Mínimo
1
unassigned

When true, only return skills with zero assignments. Default false.

Tipo
boolean
archived

When true, return ONLY archived (soft-deleted) skills. Default false → live skills only.

Tipo
boolean
search

Free-text search across name + description (case-insensitive substring).

Tipo
string
effort

Per-skill effort overrides to keep (LOW/MEDIUM/HIGH/XHIGH/MAX). Repeat or CSV.

Tipo
array
sort_by

Sort column.

Tipo
string
Valores válidos
"updated_at""name""created_at"
sort_dir

Sort direction.

Tipo
string
Valores válidos
"asc""desc"
limit

Page size (1-200). Default 50.

Tipo
number
Mínimo
1
Máximo
200
offset

Offset (>= 0). Default 0.

Tipo
number
Mínimo
0

Respuestas​

application/json
JSON
{
  
"rows": [
  
  
{
  
  
  
"id": 1,
  
  
  
"name": "code-review",
  
  
  
"description": "Review a diff for correctness and style.",
  
  
  
"model": "claude-haiku-4-5",
  
  
  
"effort": "LOW",
  
  
  
"content_hash": "string",
  
  
  
"assignment_count": 3,
  
  
  
"created_by": 0,
  
  
  
"created_at": "string",
  
  
  
"updated_at": "string",
  
  
  
"archived_at": "string"
  
  
}
  
],
  
"total": 31,
  
"limit": 50,
  
"offset": 0
}

Pruébalo​

Autorización
Variables
Clave
Valor

Ejemplos​