Matches in other apps
zpe-comments
mount /comments · base https://zpe.vc/comments · v2.0.0 · 9 operations · 5 write · 0 need no account · beta
archived: committed 2026-10-25, from dd3887f7. Contract: https://zpe.vc/comments/_/api/v1/openapi.json
GET
/_/api/v1/config
One site's comment settings, its Turnstile sitekey and the length limit
getConfig
One site's comment settings, its Turnstile sitekey and the length limit
Parameters
| name | in | required | type | notes |
|---|---|---|---|---|
site | query | yes | string | The site's slug — its address under this app's mount. |
Request body
None: this operation takes its arguments in the path and the query.
Responses
| status | meaning | body |
|---|---|---|
200 | The answer | object |
400 | The request could not be read | object |
401 | The credential is missing or does not open this account | object |
403 | This account may not do that | object |
404 | Nothing is here | object |
429 | Too many requests | object |
Example
One site's comment settings, its Turnstile sitekey and the length limit, with a token from the door.
curl -X GET 'https://zpe.vc/comments/_/api/v1/config?site=string' \ -H 'Authorization: Bearer $ZPE_TOKEN'
{}The example is generated from the schema in the contract: the shape is the document's, the values are placeholders.
GET
/_/api/v1/bootstrap
One post's comment tree, with the settings a composer needs
getBootstrap
One post's comment tree, with the settings a composer needs
Parameters
| name | in | required | type | notes |
|---|---|---|---|---|
site | query | yes | string | The site's slug — its address under this app's mount. |
slug | query | yes | string | The post's slug, as the site's own URLs spell it. |
Request body
None: this operation takes its arguments in the path and the query.
Responses
| status | meaning | body |
|---|---|---|
200 | The answer | object |
400 | The request could not be read | object |
401 | The credential is missing or does not open this account | object |
403 | This account may not do that | object |
404 | Nothing is here | object |
429 | Too many requests | object |
Example
One post's comment tree, with the settings a composer needs, with a token from the door.
curl -X GET 'https://zpe.vc/comments/_/api/v1/bootstrap?site=string&slug=string' \ -H 'Authorization: Bearer $ZPE_TOKEN'
{}The example is generated from the schema in the contract: the shape is the document's, the values are placeholders.
GET
/_/api/v1/comments
One post's comment tree
getComments
One post's comment tree
Parameters
| name | in | required | type | notes |
|---|---|---|---|---|
site | query | yes | string | The site's slug — its address under this app's mount. |
slug | query | yes | string | The post's slug, as the site's own URLs spell it. |
Request body
None: this operation takes its arguments in the path and the query.
Responses
| status | meaning | body |
|---|---|---|
200 | The answer | object |
400 | The request could not be read | object |
401 | The credential is missing or does not open this account | object |
403 | This account may not do that | object |
404 | Nothing is here | object |
429 | Too many requests | object |
Example
One post's comment tree, with a token from the door.
curl -X GET 'https://zpe.vc/comments/_/api/v1/comments?site=string&slug=string' \ -H 'Authorization: Bearer $ZPE_TOKEN'
{}The example is generated from the schema in the contract: the shape is the document's, the values are placeholders.
POST
/_/api/v1/comments
Post an anonymous comment behind a Turnstile answer
postComments
Post an anonymous comment behind a Turnstile answer
Parameters
No parameters.
Request body
None: this operation takes its arguments in the path and the query.
Responses
| status | meaning | body |
|---|---|---|
200 | The answer | object |
400 | The request could not be read | object |
401 | The credential is missing or does not open this account | object |
403 | This account may not do that | object |
404 | Nothing is here | object |
429 | Too many requests | object |
Example
Post an anonymous comment behind a Turnstile answer, with a token from the door.
curl -X POST 'https://zpe.vc/comments/_/api/v1/comments' \ -H 'Authorization: Bearer $ZPE_TOKEN'
{}The example is generated from the schema in the contract: the shape is the document's, the values are placeholders.
PATCH
/_/api/v1/comments/{id}
Edit your own comment inside the edit window
patchCommentsById
Edit your own comment inside the edit window
Parameters
| name | in | required | type | notes |
|---|---|---|---|---|
id | path | yes | string | The comment's id, as the tree answered it. |
Request body
None: this operation takes its arguments in the path and the query.
Responses
| status | meaning | body |
|---|---|---|
200 | The answer | object |
400 | The request could not be read | object |
401 | The credential is missing or does not open this account | object |
403 | This account may not do that | object |
404 | Nothing is here | object |
429 | Too many requests | object |
Example
Edit your own comment inside the edit window, with a token from the door.
curl -X PATCH 'https://zpe.vc/comments/_/api/v1/comments/string' \ -H 'Authorization: Bearer $ZPE_TOKEN'
{}The example is generated from the schema in the contract: the shape is the document's, the values are placeholders.
DELETE
/_/api/v1/comments/{id}
Delete your own comment, or any comment on a site you own
deleteCommentsById
Delete your own comment, or any comment on a site you own
Parameters
| name | in | required | type | notes |
|---|---|---|---|---|
id | path | yes | string | The comment's id, as the tree answered it. |
Request body
None: this operation takes its arguments in the path and the query.
Responses
| status | meaning | body |
|---|---|---|
200 | The answer | object |
400 | The request could not be read | object |
401 | The credential is missing or does not open this account | object |
403 | This account may not do that | object |
404 | Nothing is here | object |
429 | Too many requests | object |
Example
Delete your own comment, or any comment on a site you own, with a token from the door.
curl -X DELETE 'https://zpe.vc/comments/_/api/v1/comments/string' \ -H 'Authorization: Bearer $ZPE_TOKEN'
{}The example is generated from the schema in the contract: the shape is the document's, the values are placeholders.
POST
/_/api/v1/comments/{id}/report
Report a comment to the site's owner, once per reader
postCommentsByIdReport
Report a comment to the site's owner, once per reader
Parameters
| name | in | required | type | notes |
|---|---|---|---|---|
id | path | yes | string | The id of the comment being reported. |
Request body
None: this operation takes its arguments in the path and the query.
Responses
| status | meaning | body |
|---|---|---|
200 | The answer | object |
400 | The request could not be read | object |
401 | The credential is missing or does not open this account | object |
403 | This account may not do that | object |
404 | Nothing is here | object |
429 | Too many requests | object |
Example
Report a comment to the site's owner, once per reader, with a token from the door.
curl -X POST 'https://zpe.vc/comments/_/api/v1/comments/string/report' \ -H 'Authorization: Bearer $ZPE_TOKEN'
{}The example is generated from the schema in the contract: the shape is the document's, the values are placeholders.
GET
/_/api/v1/operator/queue
The moderation queue, with its open report counts
getOperatorQueue
The moderation queue, with its open report counts
Parameters
No parameters.
Request body
None: this operation takes its arguments in the path and the query.
Responses
| status | meaning | body |
|---|---|---|
200 | The answer | object |
400 | The request could not be read | object |
401 | The credential is missing or does not open this account | object |
403 | This account may not do that | object |
404 | Nothing is here | object |
429 | Too many requests | object |
Example
The moderation queue, with its open report counts, with a token from the door.
curl -X GET 'https://zpe.vc/comments/_/api/v1/operator/queue' \ -H 'Authorization: Bearer $ZPE_TOKEN'
{}The example is generated from the schema in the contract: the shape is the document's, the values are placeholders.
POST
/_/api/v1/operator/moderate
Moderate, ban or unban with a key instead of the console
postOperatorModerate
Moderate, ban or unban with a key instead of the console
Parameters
No parameters.
Request body
None: this operation takes its arguments in the path and the query.
Responses
| status | meaning | body |
|---|---|---|
200 | The answer | object |
400 | The request could not be read | object |
401 | The credential is missing or does not open this account | object |
403 | This account may not do that | object |
404 | Nothing is here | object |
429 | Too many requests | object |
Example
Moderate, ban or unban with a key instead of the console, with a token from the door.
curl -X POST 'https://zpe.vc/comments/_/api/v1/operator/moderate' \ -H 'Authorization: Bearer $ZPE_TOKEN'
{}The example is generated from the schema in the contract: the shape is the document's, the values are placeholders.