Skip to content

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.

Your packs and stamp metadata, or an empty packs array.

object
packs
required

All packs owned by the resolved account, newest creation time first. Empty when none exist. No pagination or bitmap data is included.

Array<object>

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
id
required

Database pack UUID. Every successful import creates a new one, including repeated imports of the same file.

string format: uuid
name
required

Saved display name, taken from the explicit upload field or the filename fallback.

string
source_file

The uploaded file’s basename, when it isn’t empty. It’s display metadata, not a link to a kept ABR file.

string
nullable
created_at
required

When the import’s database transaction started, not when the upload finished. Catalogue reads sort on it, newest first, with no tie-breaker.

string format: date-time
stamps
required

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.

Array<object>

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
id
required

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.

string format: uuid
label

Optional saved label. Current ABR imports leave it out because descriptor names aren’t imported; the web client shows Stamp instead.

string
nullable
width
required

Decoded mask width in pixels, preserved when the PNG is encoded.

integer
height
required

Decoded mask height in pixels, preserved when the PNG is encoded.

integer
spacing
required

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.

number format: double
<= 10
align_to_path
required

Whether the renderer rotates a stamp to follow the stroke. Current imports set false.

boolean
size_jitter

Optional random size variation, from 0 to 1. Current imports leave it out rather than copying Photoshop dynamics.

number format: double
nullable
opacity_jitter

Optional random opacity variation, from 0 to 1. Current imports leave it out rather than copying Photoshop dynamics.

number format: double
nullable
angle_jitter

Optional random angle variation in degrees, from 0 to 360. Current imports leave it out rather than copying Photoshop dynamics.

number format: double
nullable

Authentication required, missing, or invalid

object
error
required

Human-readable error summary

string
Example
the request could not be completed
Example
{
"error": "authentication required: sign in and retry with a valid session or API token"
}