Skip to content

Which features are enabled

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

Feature introspection for agents. Scope: artifact_id (caller needs access) → that artifact’s workspace; else workspace_id (caller must be a member); else the host workspace on a workspace subdomain, else personal scope.

workspace_id
string
artifact_id
string

Effective flags

Media typeapplication/json
object
scope
object
workspace_id
string | null
features
object
key
additional properties
boolean
disabled
Array<string>
catalog
Array<object>
object
key
string
label
string
category
string
description
string
enabled
boolean
Examplegenerated
{
"scope": {
"workspace_id": "example"
},
"features": {
"additionalProperty": true
},
"disabled": [
"example"
],
"catalog": [
{
"key": "example",
"label": "example",
"category": "example",
"description": "example",
"enabled": true
}
]
}

Authentication required

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

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