• SongkeeperSongkeeper

Search Documentation

Search for articles and glossary terms

Articles
  • Getting Started
  • Artists
  • Contacts
  • Contract Vault
  • Files
  • Glossary
  • Ideas
  • Keyboard Shortcuts
  • Media Library
  • Playlists
  • Projects
  • Recording Versions
  • Releases
  • Settings
  • Songs
  1. Docs
  3. contracts

Contract Vault

Organize private agreement records with files, parties, linked music records, notes, tags, and upcoming dates.

Contract Vault is for organizing agreements you already have. A contract record can hold structured metadata, contacts as parties, related songs, projects, releases, or artists, private files, and important dates.

Not legal review
Songkeeper does not draft, interpret, validate, or review contracts. Use this feature to organize records and dates you already manage.

What a Contract Record Stores

AreaDetails
MetadataTitle, status, category, tags, notes, and optional metadata source information.
PartiesContacts linked to the agreement, with optional contract-party roles.
Linked recordsRelated songs, projects, releases, and artists.
FilesOne primary file plus supporting files for amendments, exhibits, scans, or reference material.
DatesEffective, expiration, renewal, termination notice, and custom dates used by the upcoming dates view.

Create a Contract

  1. Open Contracts from the business area.
  2. Add a title, status, category, tags, notes, and any relevant dates.
  3. Link contact records as parties. You can create a contact from the party picker if the person is not already in your contacts.
  4. Link related songs, projects, releases, or artists when the agreement belongs with specific music records.
  5. Optionally upload a primary PDF, JPEG, PNG, or WebP file.

Find and Review Contracts

  • Search uses structured metadata only: titles, categories, notes, tags, parties, and linked record names.
  • Filter by status or linked entity type, then sort by recent activity, title, or next important date.
  • The upcoming dates panel shows fixed dates and custom dates without sending notifications.

Files and Downloads

Each contract can have one primary file plus supporting files such as amendments or exhibits. Preview uses the browser's native PDF and image viewer. Downloads are generated through short-lived private URLs.

Primary file rule
If a contract has multiple files, keep exactly one file marked as primary. Set another file as primary before removing the current primary file.

CLI Workflows

The Songkeeper CLI includes JSON-first contract commands for local tools and agent workflows. Prefer the one-shot upload flow when attaching a file.

CommandUse it for
songkeeper contracts upload --dry-runPreview the planned metadata, links, and file upload before making changes.
songkeeper contracts uploadCreate or use a contract, upload one PDF or image through the one-shot storage flow, then confirm the file with the API.
songkeeper contracts files uploadAdd a primary or supporting file to an existing contract.
songkeeper contracts replace-partiesReplace the contact-party list for a contract.
songkeeper contracts add-linkLink a song, project, release, or artist to an existing contract.
songkeeper contracts upcomingReturn upcoming effective, expiration, renewal, termination notice, and custom dates.

Related Docs

  • Keep party records current in contacts.
  • Use files for recording and project file organization outside the contract vault.
  • Link contract records to artists when an agreement belongs to a specific performer profile.