Skip to main content
Upload a file when the file itself is the original you want to keep available as evidence. Almanac stores the bytes and creates a source record for them. This differs from registering a provider object or web URL, which saves a locator without fetching the original.
The description is required; the title defaults to the filename unless you supply --title. The returned source ID is the citation target. Uploading the same file for the same owner resolves to its canonical source rather than creating another copy; it does not rename the existing source or generate a wiki article. Read the returned record before assuming which title and metadata won.
read returns provenance metadata. sources file returns a short-lived signed download URL and expiry for an uploaded source, not the file bytes on standard output. Request a fresh link if it expires. The file command does not apply to a provider or web locator; use the connected account or original URL for those. To attach this evidence to a claim, use the returned source ID in a citation binding during a revisioned record edit.