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

# Who can reach this computer

> Everyone with access, plus `publishedApps` — the labels an invitation may hand over. Filter to the apps you actually serve: listing everybody with access to the computer would tell the owner that somebody who cannot open your app has access to it.



## OpenAPI

````yaml /api-reference/openapi.json get /people
openapi: 3.1.0
info:
  title: Meradomo Public API
  version: 1.0.0
  description: >-
    Two surfaces: the local management API on 127.0.0.1:8765 (Publish) and the
    OAuth endpoints on account.meradomo.com (Connect). No SDK — these HTTP
    endpoints are the integration surface.
  license:
    name: MIT
servers:
  - url: http://127.0.0.1:8765
    description: Local management API (Publish)
  - url: https://account.meradomo.com
    description: Control plane (Connect / OAuth)
security: []
paths:
  /people:
    get:
      tags:
        - People
      summary: Who can reach this computer
      description: >-
        Everyone with access, plus `publishedApps` — the labels an invitation
        may hand over. Filter to the apps you actually serve: listing everybody
        with access to the computer would tell the owner that somebody who
        cannot open your app has access to it.
      operationId: people
      parameters:
        - name: x-engine-capability
          in: header
          required: true
          schema:
            type: string
          description: >-
            The capability returned by POST /engine/register. Minted per engine
            run; one from a previous run is worthless.
      responses:
        '200':
          description: The people
          content:
            application/json:
              schema:
                type: object
                properties:
                  name:
                    type: string
                  members:
                    type: array
                    items:
                      type: object
                      properties:
                        email:
                          type: string
                        accountId:
                          type: string
                          description: >-
                            Opaque id. Use this to grant or remove, never the
                            address.
                        role:
                          type: string
                          enum:
                            - owner
                            - member
                        status:
                          type: string
                          enum:
                            - active
                            - pending
                            - revoked
                          description: >-
                            active = accepted; pending = invited; revoked =
                            removed.
                        apps:
                          type: array
                          items:
                            type: string
                          description: App labels this person may open.
                  publishedApps:
                    type: array
                    items:
                      type: string
        '403':
          description: No (or wrong) capability. Register first.
        '503':
          description: >-
            Not connected to an account yet, or the service could not be
            reached.
      servers:
        - url: http://127.0.0.1:8765

````