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

# Start Bulk Publication

`POST /agent-knowledge/publications`

## Request

- Base URL: `https://api.traversal.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.traversal.com/agent-knowledge/publications`
- Auth: none declared

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

> 66 revisions in range; 9 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

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

---

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