Геймдев Таверна People API

openapi: 3.2.0
info:
  title: Entri Games People API
  version: '1'
  x-api-revision: '2026-10-01'
  description: 'Operations tagged People across 2 of this provider''s published API definitions: openapi.json, entri-games-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://entri.games/api/agent/v1
tags:
- name: People
paths:
  /people/{id}:
    get:
      operationId: people.get
      summary: Найти людей
      description: 'Look through the Tavern people catalog when the human wants to browse or names a person; with a goal, start_quest comes first. Public pages, who fits the human first; by id or link: their page and quests to respond to.'
      security:
      - agentBearer:
        - quests:read
      x-scope: quests:read
      x-idempotent: true
      x-cost-class: read
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Envelope
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Envelope'
      tags:
      - People
    servers:
    - url: https://entri.games/api/agent/v1
  /people:
    get:
      operationId: people.list
      summary: Люди каталога
      description: 'People of the Tavern catalog, up to 10 per page: who fits the human first, then the site order. Every word must match; filters as on the site; facets on the first page.'
      security:
      - agentBearer:
        - quests:read
      x-scope: quests:read
      x-idempotent: true
      x-cost-class: read
      parameters:
      - name: query
        in: query
        required: false
        schema:
          type: string
          maxLength: 200
          description: 'Words for who the human needs, e.g. «Unity продюсер»: each must be in name, role, skills'
      - name: role
        in: query
        required: false
        schema:
          type: string
          maxLength: 200
          description: Role key as in save_context (producer, game_designer…); a comma = any of them
      - name: skill
        in: query
        required: false
        schema:
          type: string
          maxLength: 200
          description: Skill key from data.facets.skill (unity, art-2d…); a comma = any of them
      - name: seeks
        in: query
        required: false
        schema:
          type: string
          maxLength: 200
          description: What they seek, key from data.facets.seeks (team, publisher…); a comma = any
      - name: cursor
        in: query
        required: false
        schema:
          type: string
          maxLength: 16
          description: data.next_cursor from the previous page, e.g. c10; null = last page
      responses:
        '200':
          description: Envelope
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Envelope'
      tags:
      - People
    servers:
    - url: https://entri.games/api/agent/v1
components:
  schemas:
    Envelope:
      type: object
      required:
      - ok
      - api_version
      - request_id
      properties:
        ok:
          type: boolean
        api_version:
          type: string
        api_revision:
          type: string
        request_id:
          type: string
        say_to_human:
          type: string
        data:
          type: object
        needs_human:
          type: array
          items:
            type: object
        links:
          type: object
        next:
          type: object
        context_tips:
          type: object
        content_notice:
          type: object
        error:
          type: object
          required:
          - code
          - message
          - say_to_human
          - retryable
          properties:
            code:
              type: string
              enum:
              - account_inactive
              - agent_api_disabled
              - agent_budget_exhausted
              - agent_budget_unset
              - agent_daily_cap
              - agent_quest_limit
              - already_done
              - answer_rejected
              - answer_too_long
              - answer_too_short
              - bad_request
              - budget_unknown
              - capacity_busy
              - chat_read_only
              - company_exists
              - confirm_send
              - confirm_spend
              - contact_daily_limit
              - context_rejected
              - daily_quota
              - event_busy
              - event_unavailable
              - feature_unavailable
              - finalize_failed
              - finalizing
              - fork_required
              - human_opens_contact
              - idempotency_key_required
              - idempotency_key_reused
              - image_rejected
              - insufficient_scope
              - internal
              - interview_busy
              - interview_in_telegram
              - interview_incomplete
              - interview_required
              - invalid_token
              - limiter_unavailable
              - llm_daily_cap
              - low_balance
              - method_not_allowed
              - needs_clarification
              - not_found
              - operation_lost
              - operation_retry_exhausted
              - origin_forbidden
              - output_rejected
              - own_quest
              - payload_too_large
              - profile_required
              - project_changed
              - quest_gone
              - quest_not_publishable
              - quest_response_private
              - quest_slots_full
              - question_closed
              - question_stale
              - rate_limited
              - reason_private_contact
              - reason_required
              - respond_to_required
              - response_too_large
              - review_changed
              - showcase_unavailable
              - similar_quest_closed
              - spend_limit
              - telegram_flow_active
              - temporarily_unavailable
              - test_account_pool
              - text_rejected
              - text_too_long
              - text_too_short
              - timeout
              - too_many_projects
              - unsupported_media_type
              - use_person_part
              x-extensible-enum: true
            message:
              type: string
            say_to_human:
              type: string
            retryable:
              type: boolean
            retry_after_s:
              type: number
            resets_at:
              type: string
            human_action:
              type: object
            details:
              type: object
  securitySchemes:
    agentBearer:
      type: http
      scheme: bearer
      description: OAuth access token (resource …/api/agent/v1) or agent key.
x-refined-from:
- openapi.json
- entri-games-openapi.json