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

# Give or withdraw one app

> Absence is denial, so publishing a new app never silently widens what people already invited can see. Withdrawing takes effect within one poll cycle.



## OpenAPI

````yaml /api-reference/openapi.json post /people/grant
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/grant:
    post:
      tags:
        - People
      summary: Give or withdraw one app
      description: >-
        Absence is denial, so publishing a new app never silently widens what
        people already invited can see. Withdrawing takes effect within one poll
        cycle.
      operationId: peopleGrant
      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.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
                - accountId
                - app
                - granted
              properties:
                accountId:
                  type: string
                app:
                  type: string
                granted:
                  type: boolean
      responses:
        '200':
          description: Updated
        '403':
          description: No (or wrong) capability. Register first.
        '404':
          description: No such person.
        '503':
          description: >-
            Not connected to an account yet, or the service could not be
            reached.
      servers:
        - url: http://127.0.0.1:8765

````