Change settings
PUT
/v1/settings
const url = 'https://stats.example.com/v1/settings';const options = { method: 'PUT', headers: { cookie: 'shardlens_session=<shardlens_session>', 'Content-Type': 'application/json' }, body: '{"timezone":"example","rawRetentionDays":1,"auditRetentionDays":1,"mode":"privacy","saltPeriod":"day","requiredPermissions":"example","skuPrices":{"additionalProperty":{"amount":1,"currency":"example"}},"sampling":{"additionalProperty":1},"badges":["servers"]}'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request PUT \ --url https://stats.example.com/v1/settings \ --header 'Content-Type: application/json' \ --cookie shardlens_session=<shardlens_session> \ --data '{ "timezone": "example", "rawRetentionDays": 1, "auditRetentionDays": 1, "mode": "privacy", "saltPeriod": "day", "requiredPermissions": "example", "skuPrices": { "additionalProperty": { "amount": 1, "currency": "example" } }, "sampling": { "additionalProperty": 1 }, "badges": [ "servers" ] }'Audit retention above 90 days is rejected. Audit mode needs SHARDLENS_AUDIT_KEY on the collector.
Authorizations
Section titled “Authorizations”Request Bodyrequired
Section titled “Request Bodyrequired”Media typeapplication/json
object
timezone
string
rawRetentionDays
integer
auditRetentionDays
integer
mode
string
saltPeriod
string
requiredPermissions
string
skuPrices
object
key
additional properties
object
amount
required
number
currency
required
string
sampling
object
key
additional properties
number
badges
Array<string>
Responses
Section titled “Responses”Updated settings
Invalid settings
Media typeapplication/json
object
error
required
string
message
string
rejected
Array<object>
object
index
required
integer
reason
required
string
Example generated
{ "error": "example", "message": "example", "rejected": [ { "index": 1, "reason": "example" } ]}Not signed in
Media typeapplication/json
object
error
required
string
message
string
rejected
Array<object>
object
index
required
integer
reason
required
string
Example generated
{ "error": "example", "message": "example", "rejected": [ { "index": 1, "reason": "example" } ]}Needs a Discord sign-in (owner or team) and, for changes, the CSRF header
Media typeapplication/json
object
error
required
string
message
string
rejected
Array<object>
object
index
required
integer
reason
required
string
Example generated
{ "error": "example", "message": "example", "rejected": [ { "index": 1, "reason": "example" } ]}