assets

Read one file and its version history

One live asset plus every version stored for it, newest first. Answers 404 when the file does not exist, has been deleted, or belongs to another workspace.

get/v1/assets/{asset_id}

Request

  • Base URL: https://api.patricia.app (the document declares no server; this is the origin it was published from)
  • URL: https://api.patricia.app/v1/assets/{asset_id}
  • Auth: HTTP bearer

Path parameters

asset_idstring uuid required

The asset's id.

Query parameters

access_acknowledgementstring uuid nullable

A UUID for one deliberate private-file opening. Reuse across requests for the same opening.

Headers

X-Tenant-Idstring nullable

Response

Successful Response

can_change_visibilityboolean

Whether YOU may change this file's visibility: your role carries assets:edit, AND you added the file or are a workspace admin. Both halves are what the PUT /assets/{id}/visibility route checks for itself, so a picker enabled by this flag is never refused by that request.

can_shareboolean

Whether YOU may create this file's link. Requires assets:edit. A link is the file's ADDRESS and publishes nothing: who can open it stays the file's own visibility, tested against whoever asks, so a file set to 'Only me' has a link too and only you can open it. Changing who can see a file is a separate act with its own permission, can_change_visibility. Computed server-side from the same rules POST /assets/{id}/share-links enforces, so a button enabled by this flag is never refused by that request.

Changes

No recorded changes to this operation across all 1 revision of this API.