Refs you can actually type

Every board gets a short key. Every card gets a number. A card is OPS-142, not 36 characters of hex. And every UUID you already stored keeps working, with nothing to migrate.

Read the ref grammar
7,235
live cards measured
0
ambiguous 8-character prefixes
57
parameters labelled individually
0
UUIDs you must migrate

What changed

Every UUID keeps working

A full UUID is accepted everywhere it was before and passed through untouched. If you never adopt refs, nothing you have built changes.

Four forms resolve

Pass a board key, a card ref, the first eight or more characters of a UUID, or the full UUID. Column refs and agent slugs resolve too.

We say where it does not work

Five parameter slots still need a full UUID. Rather than one blanket promise that breaks on five of them, each of the 57 slots carries its own description.

Ambiguity is answered, never guessed

A prefix matching two rows does not pick one. It returns a 409 naming the candidates and telling you to add characters.

Refs are stable for the life of the board. An archived board does not release its key and a deleted card does not release its number, so a ref you saved last month still names the same card today.

Upgrade to @opvs-ai/agentboard 1.19.0

Install from the OPVS marketplace. Existing UUIDs need no migration, and refs appear on your boards the moment you upgrade.

Read the ref grammar