> ## Documentation Index
> Fetch the complete documentation index at: https://dev.tryno.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Events and meetups, most recent start time first. Scope: events:read.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/events
openapi: 3.1.0
info:
  title: Tryno API
  version: 1.0.0
  description: >-
    API pública da plataforma Tryno (comunidades, cursos, eventos, pagamentos,
    gamificação, mensageria e mais).


    API-first: todo o produto consome exatamente esta API — o frontend web,
    futuros clientes mobile e integrações de parceiros passam pelos mesmos
    endpoints documentados aqui, sem atalhos internos.


    Há DUAS superfícies, com autenticações distintas:


    1. **Platform API v1** (`/v1/*`, tag `platform`) — pública, estável e
    somente leitura, autenticada por chave de criador (`Authorization: Bearer
    tryno_sk_…`). É o contrato para integrações. Erros usam o envelope tipado `{
    "error": { "type", "message" } }`.

    2. **API da aplicação** (todo o resto) — autenticada por cookie de sessão
    (`__session`, gerenciado pelo Clerk, ou a ponte first-party
    `tryno_session`). É o que o app web consome; está documentada por
    transparência e pode mudar sem aviso. Erros usam o envelope `{ "error":
    "code" }` com o HTTP status apropriado.
servers:
  - url: https://tryno.io/api
    description: Produção
security: []
tags:
  - name: system
    description: Health and meta endpoints.
  - name: auth
    description: Signup, login, session, password/email management.
  - name: communities
    description: Community CRUD, membership, tiers, roles.
  - name: feed
    description: Posts, comments, reactions.
  - name: members
    description: Member directory, map, public profiles, follows.
  - name: courses
    description: Courses, modules, lessons, enrollment, certificates.
  - name: events
    description: Community events and RSVPs.
  - name: gamification
    description: Leaderboards, points, daily bonus, accepted answers.
  - name: payments
    description: Offers, checkout, payment intents, upsells, entitlements.
  - name: discover
    description: Public discovery feed and search.
  - name: messaging
    description: Direct messages, channels, typing indicators.
  - name: moderation
    description: Reports, moderation queue, admin settings.
  - name: notifications
    description: Notification inbox and preferences.
  - name: challenges
    description: Community challenges, check-ins, leaderboard.
  - name: media
    description: Media/object upload.
  - name: wins
    description: Member wins feed and celebrations.
  - name: videos
    description: Community video library (Mux-backed).
  - name: support
    description: Support tickets.
  - name: affiliate
    description: Affiliate tracking and referrals.
  - name: wallet
    description: Wallet summary and transaction history.
  - name: webhooks
    description: Inbound webhooks (Clerk, payment providers) — not for client use.
  - name: platform
    description: >-
      Platform API v1 — the stable, key-authenticated, READ-ONLY surface for
      creator integrations (Zapier/n8n/custom). Mounted at /v1. Bearer
      `tryno_sk_…`.
  - name: platform-admin
    description: >-
      Creator control plane for the Platform API: API keys, webhook endpoints
      and the delivery log. Session-authenticated, owner/admin of the tribe
      only.
paths:
  /v1/events:
    get:
      tags:
        - platform
      summary: 'Events and meetups, most recent start time first. Scope: events:read.'
      parameters:
        - name: page
          in: query
          required: false
          description: 1-indexed page number.
          schema:
            type: integer
            default: 1
            minimum: 1
        - name: pageSize
          in: query
          required: false
          description: Items per page, clamped to 100.
          schema:
            type: integer
            default: 25
            minimum: 1
            maximum: 100
      responses:
        '200':
          description: Page of event objects.
          content:
            application/json:
              schema:
                type: object
                properties:
                  object:
                    type: string
                    enum:
                      - list
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        object:
                          type: string
                          enum:
                            - event
                      additionalProperties: true
                  page:
                    type: integer
                  pageSize:
                    type: integer
                  hasMore:
                    type: boolean
                    description: True when the page was full; fetch page+1.
        '401':
          description: Missing, malformed, unknown or revoked API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V1Error'
        '403':
          description: Key lacks the events:read scope.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V1Error'
        '429':
          description: Per-key rate limit exceeded (120 requests / 60s). See `Retry-After`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/V1Error'
      security:
        - bearerAuth: []
components:
  schemas:
    V1Error:
      type: object
      properties:
        error:
          type: object
          properties:
            type:
              type: string
              enum:
                - unauthorized
                - forbidden
                - not_found
                - rate_limited
              description: >-
                Machine-readable class of failure. Branch on this, not on
                `message`.
            message:
              type: string
              description: Human-readable detail. May change; do not parse.
          required:
            - type
            - message
      required:
        - error
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Creator API key for the Platform API (`/v1/*`): `Authorization: Bearer
        tryno_sk_…`. Minted per tribe at POST /communities/{handle}/api-keys and
        shown exactly once. Every key is scoped to ONE tribe — there is no way
        to read another tribe with it.

````