---
title: "Ask for a ZIP of markdown of the knowledge you can read (company, project or cluster)"
method: POST
path: "/knowledge/exports"
tags: ["Search"]
---

# Ask for a ZIP of markdown of the knowledge you can read (company, project or cluster)

`POST /knowledge/exports`

## Request

- Base URL: `https://api.atako.ai`
- URL: `https://api.atako.ai/knowledge/exports`
- Auth: HTTP bearer

Queues an export; a background job builds the ZIP within about a minute (poll `GET /knowledge/exports/{id}`). The ZIP holds one `.md` per readable item (YAML front-matter: id, kind, title, path, authority, author, updatedAt, source, sourceId), `manifest.json` (version, company, requester, date, scope, files with sha256 and size), `edges.jsonl` (links between exported items) and `_INDEX.md`. It only contains what YOU can already read: never a colleague's personal file. Journalled in the audit log (`company.storage_exported`, `meta.knowledge`). 404 (not 403) without a company, or for a project / cluster of another company.

## Request body

- object
  - `scope` union, required
    - object
      - `kind` 'company', required
    - object
      - `kind` 'project', required
      - `projectId` string, uuid, required
    - object
      - `kind` 'cluster', required
      - `clusterId` string, uuid, required

## Response `202`

- object
  - `id` string, uuid, required
  - `status` 'pending', required

## Other responses

- `400`: `scope` missing or malformed.
- `401`: Missing, malformed, or invalid bearer token / API key, or revoked session (SESSION_REVOKED).
- `404`: Not found, or the caller is not authorized to access this resource.

---

[API](https://skmtc.dev/atako/apis/atako-api.md) · [All operations](https://skmtc.dev/atako/apis/atako-api/llms.txt) · [OpenAPI document](https://skmtc.dev/atako/apis/atako-api/revisions/aa555c56fbd7?raw)