Skip to content

Who opened what in a shared folder

GET
/v1/workspaces/{workspaceId}/folders/{folderId}/activity
curl --request GET \
--url https://shareout.site/v1/workspaces/example/folders/example/activity \
--header 'Authorization: Bearer <token>'

External views on the folder and everything in its subtree, newest first (max 100). Admins, or the folder’s creator while members manage their folders.

workspaceId
required
string

Workspace ID or slug.

folderId
required
string

Activity

Media typeapplication/json
object
activity
Array<object>
object
user_email
string | null
resource_type
string
resource_id
string
resource_name
string | null
action
string
created_at
string
Examplegenerated
{
"activity": [
{
"user_email": "example",
"resource_type": "example",
"resource_id": "example",
"resource_name": "example",
"action": "example",
"created_at": "example"
}
]
}

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"
]
}
}