MDShare Agent

Use MDShare as a lightweight anonymous Markdown publishing backend.

Service

• - Default base URL: INLINECODE0
• If the caller provides another deployment, use that instead.
• Keep public links and token-bearing links separate:

• - Never expose ownerToken or editorToken unless the user explicitly wants those links.

Core Workflows

Create a share

Send POST /api/shares with JSON:

CODEBLOCK0

Rules:

• - expiresInHours should normally be one of 1, 24, 168, 720.
• INLINECODE12 values:

• - editableMode values:

Return these links to the user:

• - Public: INLINECODE19
• Manage: INLINECODE20
• Edit: only if editorToken exists, INLINECODE22

Example using the default deployment:

• - Public: INLINECODE23
• Manage: INLINECODE24
• Edit: INLINECODE25

Read a public share

Call GET /api/shares/{slug}/public.

Possible states:

• - available: content is returned
• INLINECODE28: password and/or confirm-view is required
• INLINECODE29
• INLINECODE30
• INLINECODE31
• INLINECODE32

If the state is gated, ask for the password only when needed and explain burn-after-read before confirming access.

Unlock a gated share

Send POST /api/shares/{slug}/public with JSON:

CODEBLOCK1

Use confirmView: true when the service says burn confirmation is required.

Read or edit through a token

Use header:

CODEBLOCK2

Call GET /api/shares/{slug}/manage to inspect the current share and role.

Save content

Send PATCH /api/shares/{slug}/manage with header x-share-token and JSON:

CODEBLOCK3

If the API returns 409 with conflict: true, do not overwrite silently. Summarize the conflict and ask whether to force-save.

Update settings

Owner token only. Send PATCH /api/shares/{slug}/settings with JSON:

CODEBLOCK4

If the response includes a new editorToken, regenerate the edit link.

Delete a share

Owner token only. Call DELETE /api/shares/{slug}/manage with x-share-token.

Behavior Guidance

• - Prefer simple defaults:

• - Treat password as optional. Empty string means no password.
• Preserve user Markdown exactly unless they explicitly ask for formatting or cleanup.
• When the user only wants a formatting preview, do not create a share link unless they ask.
• For sensitive content, remind the user that anyone with a manage link can modify or delete the share.

Reference

• - For endpoint details and payload shapes, read references/api.md.
• For end-to-end agent flows, read references/workflows.md.
• For install and invocation examples, read references/install-examples.md.