---
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

---

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