---
title: "Start Bulk Publication"
method: POST
path: "/agent-knowledge/publications"
tags: ["agent-knowledge"]
---

# Start Bulk Publication

`POST /agent-knowledge/publications`

## Request body

- BulkPublishAgentKnowledgeRequest
  - `baseCommitId` string, required
  - `destination` string, required — Publication prefix. Aliases: 'deep_wiki' → ai_generated/deep_wiki, 'user_generated' → user_generated. Nested ai_generated/<name>/... and user_generated/<name>/... paths are allowed. Replacing the generated root is rejected at publish time.
  - `bundleSha256` string, required
  - `fileCount` integer, required
  - `sizeBytes` integer, required
  - `idempotencyKey` string, required

## Response `201`

Successful Response

- BulkPublishAgentKnowledgeResponse
  - `publicationId` string, required
  - `uploadUrl` string, nullable
  - `uploadHeaders` object, nullable
  - `uploadExpiresAt` string, date-time, nullable
  - `status` 'awaiting_upload' | 'validating' | 'applying' | 'committed' | 'conflicted' | 'failed', required
  - `workflowId` string, nullable

## Other responses

- `422` — Validation Error

## Changes

> 22 revisions in range; 6 not diffed.

- **2026-08-20** `946736f3fe32` — 4 breaking, 1 warning
  - removed the enum value `deep_wiki` of the request property `destination`
  - removed the enum value `user_generated` of the request property `destination`
  - the `fileCount` request property's min was increased to `1.00`
  - the `destination` request property's minLength was increased from `0` to `1`
  - …1 more

[Change history](https://skmtc.dev/traversal/apis/fastapi/changes/agent-knowledge/publications/post.md)

---

[API](https://skmtc.dev/traversal/apis/fastapi.md) · [All operations](https://skmtc.dev/traversal/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/traversal/fastapi/revisions/01ca496f3b4f/schema)