Add one block to the Hive Bio page and save it as a draft. A new block starts switched off until it is finished, and nothing reaches the public page until it is published.

post/api/v1/tools/add_bio_block

Request

  • Base URL: https://hivepublish.com
  • URL: https://hivepublish.com/api/v1/tools/add_bio_block
  • Auth: HTTP bearer

Headers

Idempotency-Keystring required

Required for every write.

Request body

type'link' | 'text' | 'heading' | 'image' | 'gallery' | 'video' | 'music' | 'social' | 'email-signup' | 'contact-form' | 'poll' | 'pdf' | 'map' | 'contact-details' | 'email' | 'stats' | 'faq' | 'event' | 'discount' | 'destination' | 'product' | 'booking' | 'course' | 'community' | 'collection' | 'chatbot' | 'message-me' required

Which kind of block. Call describe_bio_blocks first if unsure.

titlestring

The words on the row.

fieldsobject

The rest of the block, named as describe_bio_blocks says.

positioninteger

Where it goes in the list, counted from zero. Leave it out for the end.

expectedDraftVersionIdstring

Optional saved draftVersionId from read_bio_page. Send it to refuse this addition if the page changed before saving.

Response

Tool result

dataunknown required

Changes

No recorded changes to this operation across all 1 revision of this API.