Push Buckets from your AI tool

Open Settings > Connected agents, create a write token, and copy it immediately. The full token is shown once; after refresh only the prefix remains visible.

• Create a private MiraDock Bucket called Test Pivot Bucket about indoor plants.
• Push these markdown files to my MiraDock Bucket indoor-plants.
• Push an interactive Web page with content_type html to my design-lab Bucket.
• What Buckets do I have on MiraDock?
• Use my indoor-plants Bucket for this conversation.
• Add a Markdown file about pothos plants and link it to the overview Markdown file.
• Create a Micro DB table called Suppliers with name, email, and active columns.
• Insert these vendor rows into my suppliers Micro DB table.

create_bucket

Create a public or private Bucket owned by the token user.

push_web_page

Create or update a Markdown file from a full markdown document with YAML front matter.

push_image

Upload a JPEG, PNG, or WebP image, then reference the returned stable URL from push_markdown_file markdown. alt_text is required.

update_bucket_metadata

Owner-only updates for name, description, visibility, discoverability, and topics.

delete_web_page

Delete a Bucket part from a Bucket the token user can edit.

list_my_buckets

List owned Buckets and Editor collaborations available for writing.

set_grounding_bucket

Set a 4-hour session active Bucket for later read calls.

get_web_page

Read a Bucket part by wiki_path or session grounding. Defaults to native content; pass format text for extracted text from HTML Web pages.

create_micro_db_table

Create a typed Micro DB table with text, number, boolean, date, datetime, select, multi_select, url, email, or json columns.

update_micro_db_table

Update Micro DB table name, description, or position.

delete_micro_db_table

Snapshot the DB, then delete a table.

add_micro_db_column

Add a typed column and validate any default value before saving.

update_micro_db_column

Update a column definition, including choices and defaults.

delete_micro_db_column

Snapshot the DB, then delete a column.

insert_micro_db_row

Validate and insert one typed row.

insert_micro_db_rows

Bulk insert typed rows in one all-or-nothing write, subject to tier limits.

update_micro_db_row

Patch one row by merging validated data keys into the existing row.

delete_micro_db_row

Delete one row from a writable Micro DB table.

snapshot_micro_db

Serialize the full Micro DB into Bucket part history and prune free-tier retention.

{
  "wiki_path": "frank/indoor-plants",
  "filename": "snake-plant.jpg",
  "alt_text": "Snake plant in bright indirect light",
  "caption": "Healthy upright leaves with no brown tips.",
  "image_base64": "/9j/4AAQSkZJRgABAQ..."
}

The response includes image_id, public_url, storage_path, dimensions, and ready-to-insert markdown. Use standard markdown image syntax in the next push_web_page call, for example ![Snake plant in bright indirect light](https://miradock.com/api/wiki-images/...).

---
title: Pothos Plants
slug: pothos-plants
page_kind: concept
summary: A care guide for pothos plants.
key_entities: [Epipremnum aureum, Pothos]
concept_tags: [houseplants, propagation]
confidence: 82
hero_image_url: https://miradock.com/api/wiki-images/...
---

Pothos is a forgiving indoor plant. Link to [[Indoor Plant Overview]].

Required fields: title and slug. Optional fields: page_kind, summary, key_entities, concept_tags, and confidence. Use hero_image_url after uploading an image with push_image.

{
  "wiki_path": "frank/design-lab",
  "content_type": "html",
  "page_title": "Interactive Funnel Notes",
  "page_slug": "interactive-funnel-notes",
  "page_content": "<main><h1>Interactive Funnel Notes</h1><p id=\"status\">Ready.</p><button id=\"run\">Run scenario</button><script>document.getElementById('run').addEventListener('click', function () { document.getElementById('status').textContent = 'Scenario complete'; });</script></main>"
}

HTML Web pages render inside a sandboxed iframe. Inline body scripts can run, but they cannot read MiraDock cookies, auth context, local storage, or the parent page DOM. External script URLs, inline event attributes, forms, nested iframes, SVG, style tags, style attributes, and javascript: URLs are stripped.

Use addEventListener in inline scripts, keep content mobile-responsive, and treat links as external navigation. MiraDock injects a viewport meta tag and rewrites links to open in a new tab.

Write tokens can write to Buckets you own and Buckets where you have the Editor collaborator role. Reader access never grants write. Defaults are 60 MCP write calls per minute and 5,000 per day, adjustable by admins through user rate limit overrides.