List your imported brush packs
GET /brush-packs
Returns your imported brush packs with their complete stamp manifests.
You need to be signed in with a session or API token; no extra permission is checked. Without one you get 401. Packs belong to your account alone: there’s no team sharing or administrator override on these endpoints, and public mode doesn’t open the catalogue to signed-out callers.
With no packs the response is {"packs":[]}. Otherwise it holds every pack you own, newest first by creation time, with no pagination, count or limit. Equal creation times have no further tie-breaker. The frontend’s built-in brushes aren’t stored here and never appear.
Stamp entries carry metadata, not image bytes. They’re ordered by stored creation time with no tie-breaker, and stamps imported together share one transaction timestamp, so their original ABR order isn’t guaranteed.
The pack list and each pack’s stamps are separate database reads, one stamp query per pack, not one atomic snapshot: a concurrent deletion can leave a returned pack with an empty stamp list. The server doesn’t cache this catalogue or check that each bitmap is still readable.
The web brush panel loads this list when it mounts, registers the packs in memory and starts loading every stamp image. If the catalogue fails to load, the built-in brushes stay available.
Responses
Section titled “ Responses ”Your packs and stamp metadata, or an empty packs array.
object
All packs owned by the resolved account, newest creation time first. Empty when none exist. No pagination or bitmap data is included.
A pack owned by one account, with its complete stamp manifest. These endpoints create packs by importing ABR samples; the manifest doesn’t include bitmap bytes or the original ABR.
object
Database pack UUID. Every successful import creates a new one, including repeated imports of the same file.
Saved display name, taken from the explicit upload field or the filename fallback.
The uploaded file’s basename, when it isn’t empty. It’s display metadata, not a link to a kept ABR file.
When the import’s database transaction started, not when the upload finished. Catalogue reads sort on it, newest first, with no tie-breaker.
Complete metadata for the stored stamps, or an empty array. Import responses follow decoded sample order; later reads sort by creation time alone, so stamps from the same transaction may not keep that order.
Metadata for one stored stamp. Fetch its PNG from /brush-packs/stamps/{id}. Imports currently use default stroke settings instead of reading Photoshop descriptor dynamics.
object
Database stamp UUID, stable for as long as this row exists. Reimporting creates a new ID. It isn’t the ABR sample identifier or a content hash.
Optional saved label. Current ABR imports leave it out because descriptor names aren’t imported; the web client shows Stamp instead.
Decoded mask width in pixels, preserved when the PNG is encoded.
Decoded mask height in pixels, preserved when the PNG is encoded.
Distance between successive stamps, as a fraction of their effective diameter. Imports set 0.1. The database accepts values above zero up to 10; the schema’s minimum of zero is broader.
Whether the renderer rotates a stamp to follow the stroke. Current imports set false.
Optional random size variation, from 0 to 1. Current imports leave it out rather than copying Photoshop dynamics.
Optional random opacity variation, from 0 to 1. Current imports leave it out rather than copying Photoshop dynamics.
Optional random angle variation in degrees, from 0 to 360. Current imports leave it out rather than copying Photoshop dynamics.
Authentication required, missing, or invalid
object
Human-readable error summary
Example
the request could not be completedExample
{ "error": "authentication required: sign in and retry with a valid session or API token"}