Skip to content
Share2Us

Report an abusive public share.

POST
/{opaque-id}/report-abuse
curl --request POST \
  --url https://s.share2.us/example/report-abuse \
  --header 'Content-Type: application/json' \
  --data '{ "reason": "malware", "category": "csam", "details": "example", "reporter_contact": "example", "turnstile_token": "example" }'

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
opaque-id
required
string
>= 12 characters

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json

The whole body is capped at 32 KiB; a larger one is 413. Fields longer than their maxLength are truncated, not rejected. Reports are rate limited per client address, and when the deployment has a Turnstile secret configured a turnstile_token is required.

object
reason
required
string
<= 200 characters
Allowed values: malware phishing harassment illegal_content spam other
category

Report category (ADR-020). csam sorts the report to the top of the admin queue and restricts dismissal to a superadmin. Any other/unknown value is stored as other.

string
default: other
Allowed values: csam other
details
string
<= 5000 characters
reporter_contact
string | null
<= 320 characters
turnstile_token

Cloudflare Turnstile token. Required when the deployment is configured with a Turnstile secret; omit otherwise.

string

Responses

Section titled “Responses”

202

Section titled “202”

Abuse report accepted. Returned whether or not the share id exists: answering differently would turn this endpoint into a share-id oracle.

Media typeapplication/json
object
status
required
string
Example
{
  "status": "ok"
}

413

Section titled “413”

The report body exceeded 32 KiB.

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
request_id
required
string
Example
{
  "error": {
    "code": "quota_exceeded"
  }
}

429

Section titled “429”

Too many reports from this address.

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
request_id
required
string
Example
{
  "error": {
    "code": "quota_exceeded"
  }
}

default

Section titled “default”

Standard error envelope.

Media typeapplication/json
object
error
required
object
code
required
string
message
required
string
request_id
required
string
Example
{
  "error": {
    "code": "quota_exceeded"
  }
}