Waitlist

Claim the shoutout-on-X reward

In the default oembed mode the caller pastes the URL of their post and the backend verifies via X's public oEmbed endpoint that it exists and mentions us. Any given post can be redeemed once across the entire waitlist. When X cannot be reached the claim is accepted as pending (HTTP 200, awarded: false) and a retry job finishes it — a third-party outage never costs the user the reward.

post/waitlist/tasks/shoutout

Request

  • Base URL: https://api.tinyhumans.ai
  • URL: https://api.tinyhumans.ai/waitlist/tasks/shoutout
  • Auth: none declared. Required headers: x-waitlist-token

Headers

x-waitlist-tokenstring required

Request body

tweetUrlstring

Required in oembed mode; ignored in honor mode.

Response

Awarded, already awarded, or pending verification

successboolean

Example response

{
  "data": {
    "totalSpots": 10000,
    "pointsConfig": {
      "referral": 100,
      "shoutout": 50,
      "download": 75,
      "referralCap": 20
    }
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.