Vee and Catalog Data in Velveteen
Updated June 13, 2026
Vee should use Velveteen catalog tools when your question depends on your own releases, tracks, artists, labels, pitches, royalties, or analytics. Those tools are scoped by user permissions.
This is the difference between asking a general help question and asking about your catalog. General questions can use docs. Catalog questions need account-scoped data.
Questions that need catalog tools
Specific release or track
Use tools when asking about one release, one track, current fields, status, or validation details.
Artist and label records
Use tools for artist metadata, DSP identifiers, label ownership, and approval state.
Royalties and payouts
Use royalty and balance tools when the answer depends on your account data.
Streaming analytics
Use streaming tools for stream totals, top tracks, and performance summaries.
Why FAQ is not enough
FAQ results are useful for general policy and product behavior.
They should not replace catalog reads. If you ask about a specific ISRC, release status, payout balance, track field, or artist record, Vee needs the relevant tool result before it can give a grounded answer.
Heads up
Permission boundaries
Vee tools must scope queries to the current user and the relevant permission tables.
That means Vee can help with records you are allowed to access, not every record in Velveteen.
When Vee edits draft metadata
For supported draft-release edits, Vee reports the exact fields it changed and can show the previous and new value for each field.
When every changed field has a previous value, Vee can use that same thread context to undo the edit by restoring those values. If a requested field was not changed, Vee should say so instead of implying the whole request succeeded.
Tip
Frequently asked questions
Can Vee see all my releases?+
Vee can use permitted catalog tools. The result depends on your account and permissions.
Can Vee see another artist's catalog?+
No, not unless your account has permission for that entity or you are operating in an authorized admin context.
Should Vee answer from FAQ for metadata questions?+
No. The system prompt tells Vee to use catalog tools for catalog metadata, specific fields, release or track lookups, and identifiers.
Can Vee show what it changed?+
For supported draft-release metadata edits, yes. Vee can summarize the changed fields with before and after values, and simple reversible edits can be undone from the same thread.
Can Vee navigate instead of answering?+
Yes, when you ask to go somewhere. For summaries and cross-entity questions, Vee should answer with tool data instead of only navigating.
Related articles
Overview
How to use Vee for product questions, catalog lookups, release guidance, navigation, and handoff to support when an issue needs a person.
Overview
The full release object: formats, metadata, tracks, labels, readiness checks, submission, review, and delivery.
Overview
The recording-level object: audio, previews, ISRCs, credits, contributors, performers, shareholders, and release attachments.
Overview
A complete guide to artist profiles, from setup and metadata to DSP identifiers, credits, approval, and trust declarations.