Skip to content

Live concurrent viewer count

GET
/v1/artifacts/{id}/presence
curl --request GET \
--url https://shareout.site/v1/artifacts/example/presence \
--header 'Authorization: Bearer <token>'

Best-effort count of viewers with the artifact page open (visible tab). Owner or collaborator only — not shown on the public page.

id
required
string

Artifact ID (e.g. art_abc123).

Current viewer count

Media type application/json
object
count
integer
Example generated
{
"count": 1
}

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
}

Resource not found

Media type application/json
object
success
required
boolean
error
required

Human-readable message.

string
code
required

Machine-readable error code.

string
Example
{
"success": false
}