/knowledge-organize

name: knowledge-organize
description: "Create, move, reorder, or link learning units and documents in the Knowledge base. Use when the user wants to structure content ('create unit Module 3', 'move these docs to lesson 2', 'reorder lessons by logical sequence', 'link doc X to unit Y')."

knowledge-organize

Group: **Curation**. Units: create, move, reorder, link documents.

When to trigger

• "Create unit 'Module 3'"
• "Reorder lessons by logical sequence"
• "Move these documents to unit X"
• "Link doc Y to lesson 2"

Arguments

| Name | Type | Required | Description | |---|---|---|---| | `action` | str | yes | `create` \| `move` \| `reorder` \| `link` \| `update` | | `connection` | str | no | Defaults to first ready | | (action-specific args below) | | | |

Actions

`create`

Args: `space_id` (or `space` slug), `slug`, `title`, `sequence_idx` (optional), `description`, `prerequisites` (list uuids), `metadata` (dict).

from dashboard.backend.sdk_client import evo

unit = evo.post(
    "/api/knowledge/v1/units",
    {"space_id": space_id, "slug": slug, "title": title, ...},
    headers={"X-Knowledge-Connection": connection},
)

`move` (document → unit)

Args: `document_id`, `unit_id` (null to unlink).

evo.patch(
    f"/api/knowledge/v1/documents/{document_id}",
    {"unit_id": unit_id},
    headers={"X-Knowledge-Connection": connection},
)

`reorder` (units within space)

Args: `space_id`, `ordered_ids` (list of unit uuids in desired order).

evo.post(
    "/api/knowledge/v1/units/reorder",
    {"space_id": space_id, "ordered_ids": ordered_ids},
    headers={"X-Knowledge-Connection": connection},
)

`link` (N documents → 1 unit)

Args: `unit_id`, `document_ids` (list).

for doc_id in document_ids:
    evo.patch(
        f"/api/knowledge/v1/documents/{doc_id}",
        {"unit_id": unit_id},
        headers={"X-Knowledge-Connection": connection},
    )

`update` (unit metadata)

Args: `unit_id`, `title`, `description`, `sequence_idx`, `prerequisites`, `metadata`.

evo.patch(
    f"/api/knowledge/v1/units/{unit_id}",
    {"title": title, "description": description, ...},
    headers={"X-Knowledge-Connection": connection},
)

Output

Confirmation per action:

✓ Unit created: {title}
  slug: {slug}
  space: {space}
  sequence_idx: {N}
  id: {uuid}

For reorder:

✓ Reordered {N} units in space {space}:
  1. {title_1}
  2. {title_2}
  ...

Actionable failures

• Invalid `action` → list valid actions
• `unit_id` not found → "Unit not found. Use `knowledge-browse scope=units`."
• Duplicate `sequence_idx` → suggest reorder
• Insufficient permission → "Token lacks `write` scope"