Unpublished draft

Tutorial: Iconoplasm API for third-party developers

This tutorial walks through how a third-party developer (a script, an AI agent, a research tool, a small game) integrates with Iconoplasm programmatically. It is the developer counterpart to Tutorial: How to generate and edit blots in Iconoplasm, which is aimed at humans clicking through the website.

It will take around 10 minutes of your time.

Prerequisites:

  • Comfort with HTTP and JSON
  • A way to send GET and POST requests (curl, requests, fetch, or any HTTP client)
  • For paid tiers: a wallet (x402) or a Stripe-compatible account (Stripe MPP), per the gating below

1. What kind of API are you integrating with?

Iconoplasm exposes two API surfaces with very different audiences,