List deliverables and loose files

GET

/v1/workspaces/{workspaceId}/assets

curl --request GET \
  --url https://shareout.site/v1/workspaces/example/assets \
  --header 'Authorization: Bearer <token>'

• Production

Returns the scope’s asset bucket — deliverables at their latest version, loose uploads, bucketId, and usedBytes. Personal scope uses /v1/assets without a workspace prefix.

Authorizations

• bearerAuth

Parameters

Path Parameters

workspaceId

required

string

Workspace ID or slug.

Responses

200

Asset library

Media type application/json

object

deliverables

Array<object>

object

id

string

name

string

latestVersion

integer

versionCount

integer

url

string format: uri

loose

Array<object>

object

id

string

filename

string

mimeType

string

size

integer

url

string format: uri

createdAt

string format: date-time

bucketId

string

usedBytes

integer

Example ^generated

{
  "deliverables": [
    {
      "id": "example",
      "name": "example",
      "latestVersion": 1,
      "versionCount": 1,
      "url": "https://example.com"
    }
  ],
  "loose": [
    {
      "id": "example",
      "filename": "example",
      "mimeType": "example",
      "size": 1,
      "url": "https://example.com",
      "createdAt": "2026-04-15T12:00:00Z"
    }
  ],
  "bucketId": "example",
  "usedBytes": 1
}

403

Access denied

Media type application/json

object

success

required

boolean

error

required

Human-readable message.

string

code

required

Machine-readable error code.

string

Example

{
  "success": false
}