Skip to content

Email a guest comment code

POST
/v1/data/{artifactId}/comments/_guest/code
curl --request POST \
--url https://shareout.site/v1/data/example/comments/_guest/code \
--header 'Content-Type: application/json' \
--data '{ "name": "example", "email": "hello@example.com" }'

Emails a 6-digit code (valid 10 minutes) so a person with no account can comment as a guest. Only when guest comments are on and the requester can already open the page without an account (public, or a password page whose access cookie the request carries). Must come from a page on this instance (Origin). Limits: 10 per hour per IP, 6 per hour per address, 30 s between sends.

artifactId
required
string

Artifact ID (e.g. art_abc123).

Media typeapplication/json
object
name
required
string
<= 80 characters
email
required
string format: email
Examplegenerated
{
"name": "example",
"email": "hello@example.com"
}

{ success: true, data: { sent: true } }

VALIDATION_ERROR

GUEST_COMMENTS_DISABLED, or FORBIDDEN (Origin)

RATE_LIMIT_EXCEEDED