Skip to documentation
SparkGlimSparkGlim Developer
Search all documentation

Try a topic in your language or an exact API path.

    API reference

    Submit moderated comment

    Submits a comment from an existing verified community profile, respecting article comments settings and moderation policy.

    POSThttps://api.sparkglim.net/api/public/blog/:slug/comments

    Access model

    Access model
    Public access with validation
    Documented availability
    Implemented in source

    Availability is verified from source, not a live production guarantee.

    Existing verified profile required; comments may remain pending. No public identity-creation API is implied.

    Parameters

    NameTypeValidation
    slugRequired

    URL-friendly identifier for the existing campaign or published article.

    stringValidation: public slug.

    Request

    NameTypeValidation
    contentRequired

    Article comment text submitted by an existing verified community profile; moderation still applies.

    stringValidation: 2–4000.
    profileTokenRequired

    Token of an existing verified community profile; this endpoint does not create that identity.

    stringValidation: existing verified community profile required by handler.

    Request

    Examples describe the contract and are not executed. Use authorized test records; never paste a real secret into these pages.

    POST /api/public/blog/:slug/comments
    http
    POST /api/public/blog/example-campaign/comments HTTP/1.1
    Host: api.sparkglim.net
    Content-Type: application/json
    
    {
      "content": "Example comment text.",
      "profileToken": "<VERIFIED_COMMUNITY_PROFILE_TOKEN>"
    }

    Response

    Success response · HTTP 200
    json
    {
      "success": true,
      "moderated": true,
      "message": "Your comment is awaiting moderation."
    }
    Error response · HTTP 400
    json
    {
      "success": false,
      "error": "<ERROR_MESSAGE>"
    }

    Validation, permissions, unavailable records and temporary service failures use the handler’s HTTP status and error payload.

    Limits & retries

    Default Server limit: 100 requests per IP per 60 seconds. Resource-specific controls also apply.

    Source compatibility

    Authorized operations require account-specific testing.

    • server/src/api/router.ts
    • server/src/api/routes/public.ts