---
title: "Replace the complete Hive Bio draft document returned by read_bio_page, keeping its current public address. Change the header, design, profile copy, page settings and blocks; use the Hive Bio screen to change the public address. Requires current permission to read and change Hive Bio. Send the saved version you read and keep the exact original request to recover its saved receipt. This saves a draft and publishes nothing."
method: POST
path: "/api/v1/tools/update_bio_document"
---

# Replace the complete Hive Bio draft document returned by read_bio_page, keeping its current public address. Change the header, design, profile copy, page settings and blocks; use the Hive Bio screen to change the public address. Requires current permission to read and change Hive Bio. Send the saved version you read and keep the exact original request to recover its saved receipt. This saves a draft and publishes nothing.

`POST /api/v1/tools/update_bio_document`

## Request

- Base URL: `https://hivepublish.com`
- URL: `https://hivepublish.com/api/v1/tools/update_bio_document`
- Auth: HTTP bearer

## Headers

- `Idempotency-Key` string, required

## Request body

- object
  - `document` object, required: The complete document from read_bio_page with the requested changes.
  - `expectedDraftVersionId` string, required: The draftVersionId from read_bio_page, or publishedVersionId when no draft exists.
  - `approvalToken` string: Single-use token returned by Hive after the owner approves this exact action.

## Response `200`

Tool result

- ToolResult
  - `data` unknown, required
  - `meta` object, required
    - `tool` string
    - `workspaceId` string, uuid

## Other responses

- `400`: Invalid input
- `401`: Missing or invalid credential
- `403`: Missing workspace scope, role permission, or plan entitlement
- `409`: Idempotency conflict, replay, or request still in progress
- `429`: Rate limit exceeded

---

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