Skip to content
ShareOutShareOut Docs

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>'

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

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
workspaceId
required
string

Workspace ID or slug.

Responses

Section titled “Responses”

200

Section titled “200”

Asset library

Media typeapplication/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
sizeBytes
integer
createdAt
string format: date-time
bucketId
string
usedBytes
integer
Examplegenerated
{
  "deliverables": [
    {
      "id": "example",
      "name": "example",
      "latestVersion": 1,
      "versionCount": 1,
      "url": "https://example.com"
    }
  ],
  "loose": [
    {
      "id": "example",
      "filename": "example",
      "mimeType": "example",
      "sizeBytes": 1,
      "createdAt": "2026-04-15T12:00:00Z"
    }
  ],
  "bucketId": "example",
  "usedBytes": 1
}

403

Section titled “403”

Access denied

Media typeapplication/json
object
success
required
boolean
error
required

Human-readable message.

string
code
required

Machine-readable error code.

string
request_id

Correlation id (also the X-Request-Id header). Quote it in support tickets.

string
reason

Finer cause under code. For UNAUTHORIZED: missing, invalid, revoked or expired.

string
hint

What to do next, in plain words.

string
suggestion
string
param

The request field at fault.

string
docs

Doc page for this error.

string
redirect_url
string
support

Present on 5xx — how to reach a human.

object
how
string
include
Array<string>
Example
{
  "success": false,
  "support": {
    "how": "POST /v1/support/tickets",
    "include": [
      "request_id"
    ]
  }
}