# Tryno

> Documentação para desenvolvedores da Tryno — a plataforma de comunidades. API-first: tudo o que o produto faz é um endpoint HTTP.

## Docs

- [Get the current user's affiliate profile (code, stats).](https://dev.tryno.io/api-reference/affiliate/get-the-current-users-affiliate-profile-code-stats.md)
- [List the current user's affiliate referrals.](https://dev.tryno.io/api-reference/affiliate/list-the-current-users-affiliate-referrals.md)
- [Record an affiliate click/attribution event. Public — called from landing pages.](https://dev.tryno.io/api-reference/affiliate/record-an-affiliate-clickattribution-event-public-—-called-from-landing-pages.md)
- [Confirm an email-change token.](https://dev.tryno.io/api-reference/auth/confirm-an-email-change-token.md)
- [Confirm an email-verification token.](https://dev.tryno.io/api-reference/auth/confirm-an-email-verification-token.md)
- [Create an account with email + password.](https://dev.tryno.io/api-reference/auth/create-an-account-with-email-+-password.md)
- [Current session/auth debug info.](https://dev.tryno.io/api-reference/auth/current-sessionauth-debug-info.md)
- [Get the current authenticated user's identity + profile.](https://dev.tryno.io/api-reference/auth/get-the-current-authenticated-users-identity-+-profile.md)
- [Log in with email + password; sets session cookie.](https://dev.tryno.io/api-reference/auth/log-in-with-email-+-password;-sets-session-cookie.md)
- [Log out and invalidate the current session.](https://dev.tryno.io/api-reference/auth/log-out-and-invalidate-the-current-session.md)
- [Request a password-reset email.](https://dev.tryno.io/api-reference/auth/request-a-password-reset-email.md)
- [Request an email-change confirmation link (verified users only).](https://dev.tryno.io/api-reference/auth/request-an-email-change-confirmation-link-verified-users-only.md)
- [Reset password using a reset token.](https://dev.tryno.io/api-reference/auth/reset-password-using-a-reset-token.md)
- [Create a community challenge.](https://dev.tryno.io/api-reference/challenges/create-a-community-challenge.md)
- [Get challenge detail (participants, check-in leaderboard).](https://dev.tryno.io/api-reference/challenges/get-challenge-detail-participants-check-in-leaderboard.md)
- [Join a challenge.](https://dev.tryno.io/api-reference/challenges/join-a-challenge.md)
- [Leave a challenge.](https://dev.tryno.io/api-reference/challenges/leave-a-challenge.md)
- [List community challenges (with participant counts + viewer progress).](https://dev.tryno.io/api-reference/challenges/list-community-challenges-with-participant-counts-+-viewer-progress.md)
- [Log a daily check-in for a challenge (awards XP).](https://dev.tryno.io/api-reference/challenges/log-a-daily-check-in-for-a-challenge-awards-xp.md)
- [Approve or reject a pending join request.](https://dev.tryno.io/api-reference/communities/approve-or-reject-a-pending-join-request.md)
- [Change a member's role.](https://dev.tryno.io/api-reference/communities/change-a-members-role.md)
- [Change the current user's membership tier.](https://dev.tryno.io/api-reference/communities/change-the-current-users-membership-tier.md)
- [Create a community.](https://dev.tryno.io/api-reference/communities/create-a-community.md)
- [Create a membership tier (admin+).](https://dev.tryno.io/api-reference/communities/create-a-membership-tier-admin+.md)
- [Get a community by handle.](https://dev.tryno.io/api-reference/communities/get-a-community-by-handle.md)
- [Get a community's public about page (stats, tiers).](https://dev.tryno.io/api-reference/communities/get-a-communitys-public-about-page-stats-tiers.md)
- [Join a community (or request to join if gated).](https://dev.tryno.io/api-reference/communities/join-a-community-or-request-to-join-if-gated.md)
- [List communities the current user is an active member of.](https://dev.tryno.io/api-reference/communities/list-communities-the-current-user-is-an-active-member-of.md)
- [Add a lesson to a module.](https://dev.tryno.io/api-reference/courses/add-a-lesson-to-a-module.md)
- [Add a module to a course.](https://dev.tryno.io/api-reference/courses/add-a-module-to-a-course.md)
- [Create a course in a community.](https://dev.tryno.io/api-reference/courses/create-a-course-in-a-community.md)
- [Enroll the current user in a course.](https://dev.tryno.io/api-reference/courses/enroll-the-current-user-in-a-course.md)
- [Get course detail (modules, lessons, progress).](https://dev.tryno.io/api-reference/courses/get-course-detail-modules-lessons-progress.md)
- [Get lesson detail (content, adjacent lessons).](https://dev.tryno.io/api-reference/courses/get-lesson-detail-content-adjacent-lessons.md)
- [Leave a course review.](https://dev.tryno.io/api-reference/courses/leave-a-course-review.md)
- [List course reviews.](https://dev.tryno.io/api-reference/courses/list-course-reviews.md)
- [List courses in a community (member-visible; drafts for staff).](https://dev.tryno.io/api-reference/courses/list-courses-in-a-community-member-visible;-drafts-for-staff.md)
- [Look up a course-completion certificate by its public number.](https://dev.tryno.io/api-reference/courses/look-up-a-course-completion-certificate-by-its-public-number.md)
- [Mark a lesson complete for the current user.](https://dev.tryno.io/api-reference/courses/mark-a-lesson-complete-for-the-current-user.md)
- [Publish a course (admin+).](https://dev.tryno.io/api-reference/courses/publish-a-course-admin+.md)
- [Update a course (admin+).](https://dev.tryno.io/api-reference/courses/update-a-course-admin+.md)
- [Update a lesson (admin+).](https://dev.tryno.io/api-reference/courses/update-a-lesson-admin+.md)
- [Authenticated cross-entity search.](https://dev.tryno.io/api-reference/discover/authenticated-cross-entity-search.md)
- [Discovery-readiness checklist for a community (admin+).](https://dev.tryno.io/api-reference/discover/discovery-readiness-checklist-for-a-community-admin+.md)
- [Public discovery feed of discoverable communities.](https://dev.tryno.io/api-reference/discover/public-discovery-feed-of-discoverable-communities.md)
- [Toggle a community's public discoverability (admin+).](https://dev.tryno.io/api-reference/discover/toggle-a-communitys-public-discoverability-admin+.md)
- [Create an event.](https://dev.tryno.io/api-reference/events/create-an-event.md)
- [Delete an event (organizer/admin+).](https://dev.tryno.io/api-reference/events/delete-an-event-organizeradmin+.md)
- [List community events (with RSVP counts + viewer status).](https://dev.tryno.io/api-reference/events/list-community-events-with-rsvp-counts-+-viewer-status.md)
- [RSVP to an event.](https://dev.tryno.io/api-reference/events/rsvp-to-an-event.md)
- [Comment on a post.](https://dev.tryno.io/api-reference/feed/comment-on-a-post.md)
- [Create a post in a community.](https://dev.tryno.io/api-reference/feed/create-a-post-in-a-community.md)
- [Delete a comment (author or moderator).](https://dev.tryno.io/api-reference/feed/delete-a-comment-author-or-moderator.md)
- [Delete a post (author or moderator).](https://dev.tryno.io/api-reference/feed/delete-a-post-author-or-moderator.md)
- [Edit a post (author only).](https://dev.tryno.io/api-reference/feed/edit-a-post-author-only.md)
- [Get a single post.](https://dev.tryno.io/api-reference/feed/get-a-single-post.md)
- [List posts in a community feed (paginated).](https://dev.tryno.io/api-reference/feed/list-posts-in-a-community-feed-paginated.md)
- [List the current user's draft posts in a community.](https://dev.tryno.io/api-reference/feed/list-the-current-users-draft-posts-in-a-community.md)
- [Pin a post.](https://dev.tryno.io/api-reference/feed/pin-a-post.md)
- [Toggle a reaction on a post.](https://dev.tryno.io/api-reference/feed/toggle-a-reaction-on-a-post.md)
- [Unpin a post.](https://dev.tryno.io/api-reference/feed/unpin-a-post.md)
- [Claim the daily login bonus.](https://dev.tryno.io/api-reference/gamification/claim-the-daily-login-bonus.md)
- [Community points leaderboard.](https://dev.tryno.io/api-reference/gamification/community-points-leaderboard.md)
- [Current user's points in a community.](https://dev.tryno.io/api-reference/gamification/current-users-points-in-a-community.md)
- [Mark a comment as the accepted answer (awards points).](https://dev.tryno.io/api-reference/gamification/mark-a-comment-as-the-accepted-answer-awards-points.md)
- [Upload a media object (image/attachment) to R2-backed storage.](https://dev.tryno.io/api-reference/media/upload-a-media-object-imageattachment-to-r2-backed-storage.md)
- [Follow a user.](https://dev.tryno.io/api-reference/members/follow-a-user.md)
- [List community members (with post counts).](https://dev.tryno.io/api-reference/members/list-community-members-with-post-counts.md)
- [Member map (location-based directory) + upcoming events.](https://dev.tryno.io/api-reference/members/member-map-location-based-directory-+-upcoming-events.md)
- [Public profile by username (viewer-aware follow state).](https://dev.tryno.io/api-reference/members/public-profile-by-username-viewer-aware-follow-state.md)
- [Unfollow a user.](https://dev.tryno.io/api-reference/members/unfollow-a-user.md)
- [Update the current user's profile.](https://dev.tryno.io/api-reference/members/update-the-current-users-profile.md)
- [Add a member to a channel.](https://dev.tryno.io/api-reference/messaging/add-a-member-to-a-channel.md)
- [Create a channel in a community.](https://dev.tryno.io/api-reference/messaging/create-a-channel-in-a-community.md)
- [List messages in a channel.](https://dev.tryno.io/api-reference/messaging/list-messages-in-a-channel.md)
- [List messages in a DM thread.](https://dev.tryno.io/api-reference/messaging/list-messages-in-a-dm-thread.md)
- [List the current user's DM threads.](https://dev.tryno.io/api-reference/messaging/list-the-current-users-dm-threads.md)
- [Mark a DM thread as read.](https://dev.tryno.io/api-reference/messaging/mark-a-dm-thread-as-read.md)
- [Send a message in a channel.](https://dev.tryno.io/api-reference/messaging/send-a-message-in-a-channel.md)
- [Send a message in a DM thread.](https://dev.tryno.io/api-reference/messaging/send-a-message-in-a-dm-thread.md)
- [Send a typing indicator in a DM thread.](https://dev.tryno.io/api-reference/messaging/send-a-typing-indicator-in-a-dm-thread.md)
- [Start (or fetch) a direct-message thread with a user.](https://dev.tryno.io/api-reference/messaging/start-or-fetch-a-direct-message-thread-with-a-user.md)
- [Dismiss a moderation report (mod+).](https://dev.tryno.io/api-reference/moderation/dismiss-a-moderation-report-mod+.md)
- [Get a platform admin setting (super-admin only).](https://dev.tryno.io/api-reference/moderation/get-a-platform-admin-setting-super-admin-only.md)
- [List pending moderation reports (mod+).](https://dev.tryno.io/api-reference/moderation/list-pending-moderation-reports-mod+.md)
- [Re-publish the flag rules from Postgres to the SETTINGS KV snapshot (super-admin only). Writes no flag values; 503 when the snapshot cannot be written.](https://dev.tryno.io/api-reference/moderation/re-publish-the-flag-rules-from-postgres-to-the-settings-kv-snapshot-super-admin-only-writes-no-flag-values;-503-when-the-snapshot-cannot-be-written.md)
- [Read every registered feature flag: kind, owner, default, stored rule, and the value it resolves to now (optionally for one tribe via ?tribeId).](https://dev.tryno.io/api-reference/moderation/read-every-registered-feature-flag:-kind-owner-default-stored-rule-and-the-value-it-resolves-to-now-optionally-for-one-tribe-via-?tribeid.md)
- [Remove the reported content (mod+).](https://dev.tryno.io/api-reference/moderation/remove-the-reported-content-mod+.md)
- [Report a post for moderation review.](https://dev.tryno.io/api-reference/moderation/report-a-post-for-moderation-review.md)
- [Set a platform admin setting (super-admin only).](https://dev.tryno.io/api-reference/moderation/set-a-platform-admin-setting-super-admin-only.md)
- [Get the current user's notification preferences by type.](https://dev.tryno.io/api-reference/notifications/get-the-current-users-notification-preferences-by-type.md)
- [List the current user's notifications.](https://dev.tryno.io/api-reference/notifications/list-the-current-users-notifications.md)
- [Mark a notification as read.](https://dev.tryno.io/api-reference/notifications/mark-a-notification-as-read.md)
- [Mark all notifications as read.](https://dev.tryno.io/api-reference/notifications/mark-all-notifications-as-read.md)
- [Update a notification preference for a type.](https://dev.tryno.io/api-reference/notifications/update-a-notification-preference-for-a-type.md)
- [Visão geral](https://dev.tryno.io/api-reference/overview.md): Como ler esta referência: o que é contrato público e o que é superfície interna documentada.
- [Charge a one-click upsell off-session using the signed upsell token. Idempotent per order+offer.](https://dev.tryno.io/api-reference/payments/charge-a-one-click-upsell-off-session-using-the-signed-upsell-token-idempotent-per-order+offer.md)
- [Charge via Mercado Pago (card token flow).](https://dev.tryno.io/api-reference/payments/charge-via-mercado-pago-card-token-flow.md)
- [Create a paid offer (admin+). The offer price is the only price source.](https://dev.tryno.io/api-reference/payments/create-a-paid-offer-admin+-the-offer-price-is-the-only-price-source.md)
- [Create a Stripe PaymentIntent for embedded/in-page checkout.](https://dev.tryno.io/api-reference/payments/create-a-stripe-paymentintent-for-embeddedin-page-checkout.md)
- [Create an order for an offer (redirect-based checkout, e.g. Stripe Checkout).](https://dev.tryno.io/api-reference/payments/create-an-order-for-an-offer-redirect-based-checkout-eg-stripe-checkout.md)
- [Current user's active entitlements (purchased offers/tiers) in a community.](https://dev.tryno.io/api-reference/payments/current-users-active-entitlements-purchased-offerstiers-in-a-community.md)
- [List offers for a community (admin+).](https://dev.tryno.io/api-reference/payments/list-offers-for-a-community-admin+.md)
- [Mint a short-lived signed token authorizing a post-purchase upsell charge.](https://dev.tryno.io/api-reference/payments/mint-a-short-lived-signed-token-authorizing-a-post-purchase-upsell-charge.md)
- [Public checkout page data for an offer (+ configured upsell/bump chain).](https://dev.tryno.io/api-reference/payments/public-checkout-page-data-for-an-offer-+-configured-upsellbump-chain.md)
- [Update an offer (admin+).](https://dev.tryno.io/api-reference/payments/update-an-offer-admin+.md)
- [Delete an endpoint (cascades its deliveries).](https://dev.tryno.io/api-reference/platform-admin/delete-an-endpoint-cascades-its-deliveries.md)
- [List this tribe's API keys (prefix only — the plaintext is never re-exposed).](https://dev.tryno.io/api-reference/platform-admin/list-this-tribes-api-keys-prefix-only-—-the-plaintext-is-never-re-exposed.md)
- [List webhook endpoints, including their signing secrets (the creator owns them).](https://dev.tryno.io/api-reference/platform-admin/list-webhook-endpoints-including-their-signing-secrets-the-creator-owns-them.md)
- [Mint an API key. The plaintext `key` is returned HERE AND NOWHERE ELSE.](https://dev.tryno.io/api-reference/platform-admin/mint-an-api-key-the-plaintext-`key`-is-returned-here-and-nowhere-else.md)
- [Queue a test delivery (event `ping`) so a receiver can be verified end to end.](https://dev.tryno.io/api-reference/platform-admin/queue-a-test-delivery-event-`ping`-so-a-receiver-can-be-verified-end-to-end.md)
- [Register an endpoint. HTTPS only; private/loopback hosts are rejected (SSRF guard).](https://dev.tryno.io/api-reference/platform-admin/register-an-endpoint-https-only;-privateloopback-hosts-are-rejected-ssrf-guard.md)
- [Revoke a key (soft — the row is kept for audit; auth lookups exclude it).](https://dev.tryno.io/api-reference/platform-admin/revoke-a-key-soft-—-the-row-is-kept-for-audit;-auth-lookups-exclude-it.md)
- [The endpoint's 50 most recent delivery attempts (status, attempts, last error).](https://dev.tryno.io/api-reference/platform-admin/the-endpoints-50-most-recent-delivery-attempts-status-attempts-last-error.md)
- [Update an endpoint's url / events / enabled / description.](https://dev.tryno.io/api-reference/platform-admin/update-an-endpoints-url-events-enabled-description.md)
- [Events and meetups, most recent start time first. Scope: events:read.](https://dev.tryno.io/api-reference/platform/events-and-meetups-most-recent-start-time-first-scope:-events:read.md)
- [Identify the calling key: which tribe it belongs to and which scopes it holds.](https://dev.tryno.io/api-reference/platform/identify-the-calling-key:-which-tribe-it-belongs-to-and-which-scopes-it-holds.md)
- [List active members of the key's tribe, newest first. Scope: members:read.](https://dev.tryno.io/api-reference/platform/list-active-members-of-the-keys-tribe-newest-first-scope:-members:read.md)
- [One member of the key's tribe by username. Scope: members:read.](https://dev.tryno.io/api-reference/platform/one-member-of-the-keys-tribe-by-username-scope:-members:read.md)
- [Orders, newest first. Money is integer cents. Scope: orders:read.](https://dev.tryno.io/api-reference/platform/orders-newest-first-money-is-integer-cents-scope:-orders:read.md)
- [Published PUBLIC posts, newest first. Members-only and paid post bodies are NEVER exposed over a key. Scope: posts:read.](https://dev.tryno.io/api-reference/platform/published-public-posts-newest-first-members-only-and-paid-post-bodies-are-never-exposed-over-a-key-scope:-posts:read.md)
- [Add a message to a ticket (owner or staff).](https://dev.tryno.io/api-reference/support/add-a-message-to-a-ticket-owner-or-staff.md)
- [Get a ticket's detail (owner or staff).](https://dev.tryno.io/api-reference/support/get-a-tickets-detail-owner-or-staff.md)
- [List the current user's support tickets.](https://dev.tryno.io/api-reference/support/list-the-current-users-support-tickets.md)
- [Open a support ticket.](https://dev.tryno.io/api-reference/support/open-a-support-ticket.md)
- [Update ticket status/fields (staff only).](https://dev.tryno.io/api-reference/support/update-ticket-statusfields-staff-only.md)
- [Liveness check.](https://dev.tryno.io/api-reference/system/liveness-check.md)
- [Delete a video (admin+).](https://dev.tryno.io/api-reference/videos/delete-a-video-admin+.md)
- [Force a sync with Mux for a video's processing status (admin+).](https://dev.tryno.io/api-reference/videos/force-a-sync-with-mux-for-a-videos-processing-status-admin+.md)
- [Get video detail (playback token if gated).](https://dev.tryno.io/api-reference/videos/get-video-detail-playback-token-if-gated.md)
- [Ingest a video from a remote URL (admin+).](https://dev.tryno.io/api-reference/videos/ingest-a-video-from-a-remote-url-admin+.md)
- [List a community's video library.](https://dev.tryno.io/api-reference/videos/list-a-communitys-video-library.md)
- [Update video metadata (admin+).](https://dev.tryno.io/api-reference/videos/update-video-metadata-admin+.md)
- [Upload a video (admin+, Mux-backed).](https://dev.tryno.io/api-reference/videos/upload-a-video-admin+-mux-backed.md)
- [Paginated wallet transaction history (purchases + earnings, merged).](https://dev.tryno.io/api-reference/wallet/paginated-wallet-transaction-history-purchases-+-earnings-merged.md)
- [Wallet summary: balance, entitlements, first page of transactions.](https://dev.tryno.io/api-reference/wallet/wallet-summary:-balance-entitlements-first-page-of-transactions.md)
- [Approve or reject a pending win (moderation decision).](https://dev.tryno.io/api-reference/wins/approve-or-reject-a-pending-win-moderation-decision.md)
- [Decline a detected win. The record is kept so the same achievement is never proposed again.](https://dev.tryno.io/api-reference/wins/decline-a-detected-win-the-record-is-kept-so-the-same-achievement-is-never-proposed-again.md)
- [List wins in a community (with celebrate counts).](https://dev.tryno.io/api-reference/wins/list-wins-in-a-community-with-celebrate-counts.md)
- [Post a win to the community wins feed.](https://dev.tryno.io/api-reference/wins/post-a-win-to-the-community-wins-feed.md)
- [Publish a detected win to the wall in the member's own words (title required; idempotent — a replay returns the same winId with 200).](https://dev.tryno.io/api-reference/wins/publish-a-detected-win-to-the-wall-in-the-members-own-words-title-required;-idempotent-—-a-replay-returns-the-same-winid-with-200.md)
- [Toggle a celebration reaction on a win.](https://dev.tryno.io/api-reference/wins/toggle-a-celebration-reaction-on-a-win.md)
- [Wins the platform detected and offered to the calling member (own only).](https://dev.tryno.io/api-reference/wins/wins-the-platform-detected-and-offered-to-the-calling-member-own-only.md)
- [Changelog e depreciação](https://dev.tryno.io/changelog.md): Como a API da Tryno evolui, o que consideramos uma mudança incompatível, e o que já foi ao ar.
- [Como criar uma API key](https://dev.tryno.io/guides/api-keys.md): Crie uma credencial para a Platform API v1, limite seus escopos, use-a com segurança e rotacione sem downtime.
- [Erros e limites](https://dev.tryno.io/guides/errors.md): Os dois envelopes de erro da API da Tryno, os status que você precisa tratar, o teto de requisições por chave e código pronto de retentativa com backoff.
- [Paginação](https://dev.tryno.io/guides/pagination.md): Como percorrer listas em /api/v1: page, pageSize, o envelope com hasMore e um laço completo de varredura.
- [Receitas de integração](https://dev.tryno.io/guides/recipes.md): Fluxos completos ponta a ponta: webhook entra, você enriquece com a leitura de /v1 e empurra para planilha, Zapier ou n8n.
- [Como configurar webhooks](https://dev.tryno.io/guides/webhooks.md): Receba eventos da sua tribo em tempo quase real, com entrega assinada por HMAC-SHA256 — registro, verificação de assinatura, idempotência e política de reentrega.
- [Comece por aqui](https://dev.tryno.io/introduction.md): Entenda como a Tryno se encaixa na sua operação e escolha a forma mais simples de integrar seu sistema ou suas automações.

## OpenAPI Specs

- [openapi](https://dev.tryno.io/api-reference/openapi.json)