> ## 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.

# Attach to the shared engine

> Counts your app as a live consumer so the reference-counted engine keeps serving while you are open — and returns the **capability** the People endpoints require. Registering is what proves you are a real app on this machine, which is why an app that attached to an engine somebody else spawned can still manage people. Idempotent.



## OpenAPI

````yaml /api-reference/openapi.json post /engine/register
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:
  /engine/register:
    post:
      tags:
        - Engine
      summary: Attach to the shared engine
      description: >-
        Counts your app as a live consumer so the reference-counted engine keeps
        serving while you are open — and returns the **capability** the People
        endpoints require. Registering is what proves you are a real app on this
        machine, which is why an app that attached to an engine somebody else
        spawned can still manage people. Idempotent.
      operationId: engineRegister
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - appId
              properties:
                appId:
                  type: string
                  example: com.example.myapp
                pid:
                  type: integer
      responses:
        '200':
          description: Attached
          content:
            application/json:
              schema:
                type: object
                properties:
                  ok:
                    type: boolean
                  appId:
                    type: string
                  protocol:
                    type: integer
                  registrants:
                    type: integer
                  capability:
                    type: string
                    description: Send as x-engine-capability on every People call.
      servers:
        - url: http://127.0.0.1:8765

````