/api/artifacts/{id}/share

Create or rotate a public share token

auth: API keybase https://app.nz

Request

curl -sX POST https://app.nz/api/artifacts/{id}/share \
  -H "Authorization: Bearer pk_live_..." \
  -H "Content-Type: application/json" \
  -d '{}'

Artifacts API

Create, update, list, share, and delete user artifacts. Supported kinds are drawing, doc, sheet, pdf, image, and file. Documents store Markdown text and open in /write; sheets store JSON grid data and open in /sheets, so agents can produce editable office documents directly.

Artifact body

title*stringDisplay title.

mimestringMIME type, e.g. text/markdown for doc or application/json for sheet.

datastringInline data. Documents use Markdown; sheets use JSON grid data.

urlstringOptional https:// or app-relative URL for binary artifacts.

teamIdstringOptional team visibility scope.

Create editable document and sheet artifacts

curl -sX POST https://app.nz/api/artifacts \
  -H "Authorization: Bearer pk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"kind":"doc","title":"Runbook","mime":"text/markdown","data":"# Runbook\n\nShip it."}'

curl -sX POST https://app.nz/api/artifacts \
  -H "Authorization: Bearer pk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"kind":"sheet","title":"Budget","mime":"application/json","data":"[{"name":"Sheet1","rows":{"0":{"cells":{"0":{"text":"Item"},"1":{"text":"Cost"}}}}}]"}'