Skip to content

Knowledge settings and counts

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

Returns {enabled:false, ...} when Knowledge is off. Any member.

workspaceId
required
string

Workspace ID or slug.

Settings

Media typeapplication/json
object
enabled
boolean
counts
object
key
additional properties
integer
lastUpdated
string | null
total
integer
Examplegenerated
{
"enabled": true,
"counts": {
"additionalProperty": 1
},
"lastUpdated": "example",
"total": 1
}

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