**API versions** · **V2 (Latest)** · [V1](/integrations/v1/docs?lang=en)

# Members

OpenAPI 3.0.3 · API 2.0.0

```json
[
  {
    "url": "https://api.unisoft.world/integrations/v2",
    "description": "API"
  }
]
```

## Operations

## GET /members/capabilities

Check member account administration and delegated application availability

`get_member_capabilities`

Requires explicitly granted members:read. Static capability discovery; accepts no query parameters or non-empty request body and reads no business records. Account and family-request reads are implemented subject to current organisation/scopes; campaign-restricted keys can discover this same static result but cannot read accounts. APPROVE_ACCOUNT and REJECT_ACCOUNT are implemented with separate opt-in members:approve and members:reject scopes, admission revision, an existing exact CRM target for approval, durable decision journal and external serialization. Internal writers do not share that lock and CRM synchronisation is not fully observable; inspect decision status and do not promise atomicity or complete profile sync. Family approval/refusal are implemented with those same explicit action scopes: parent, spouse, existing target, direct/reverse CRM relations and chef-family identities are admitted before effects. Each family revision covers its request, parent and spouse candidates; relatedContactIds is an observation, never an independent access grant. memberApplication.supported=false with DEFERRED_BY_PRODUCT_DECISION: member access from an external application is deferred by product decision and is not part of this delivery. Organisation API keys and OAuth grants remain organisation principals and must not impersonate a member. No member login/consent/session/credential exchange is offered. Report the deferral and stop that application workflow; do not propose credentials or a bypass. No email, provider or business mutation occurs; authentication may update API-key usage telemetry.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "members:read",
  "additional": []
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Current observed account-space data or explicit capability limits.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/MemberCapabilities"
          }
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_MEMBER_QUERY, INVALID_MEMBER_CURSOR, INVALID_MEMBER_ID or UNEXPECTED_REQUEST_BODY: correct only the declared request arguments.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Missing or invalid authentication.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE, INVALID_ORGANISATION_CONTEXT or CAMPAIGN_RESTRICTED_KEY: no account data was returned.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "MEMBER_READ_UNAVAILABLE: temporary read failure; no business mutation was attempted.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "members:read",
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /members/accounts

List member account access requests and recorded approval states

`list_member_accounts`

Requires the explicitly granted members:read scope; contacts:read and an admin CRM role do not replace it. This is organisation-level account administration read access, not the current member's delegated identity. MEMBER_ACCOUNT, ACCOUNT_FAMILY_MEMBER, CRM contact and admin access are different objects and IDs. A CRM family link, matching email or #ACCOUNT tag never grants member access. SUBMIT means awaiting account-space approval, VALIDE means its recorded approval/binding, REJECTED means refused and can be approved again; these are not payment or registration states. Email verification alone is not approval. Profile is only the mirrored first/last name, email and phone; it can differ from current CRM identity. linkedContactId, when present, is freshly admitted in the same organisation, without returning CRM fields; use CRM tools and their own rights for CRM data. Null boolean, identity or date means unknown/absent, never an inferred false or zero. Dates are ISO 8601 UTC or null. No passwords, OTP, reset links, sessions, reusable credentials, raw CRM, profile extras, private settings or provider data are returned. Read-only: no binding, approval, rejection, session issuance/revocation, profile sync, email, provider call or business write. Authentication may update API-key usage telemetry. Campaign-restricted keys are refused with 403 CAMPAIGN_RESTRICTED_KEY because account access has no independently established campaign membership. Missing, deleted, foreign or invalidly related objects return 404 MEMBER_NOT_FOUND; ambiguous duplicate IDs, malformed history or a changed page return 409. Stop on these errors; do not infer access or repair through contact edits. Account reads return an opaque revision for conditional account approval/refusal; it is checked at admission, not an atomic CAS with internal writers. Account and family decisions require their exact action scopes; member application access is deferred by product decision: inspect get_member_capabilities. state defaults to SUBMIT; use ALL for every recorded state. Pages sort by exact ID ascending, with limit default 50 and maximum 100. nextCursor is opaque and bound to the organisation, resource, state and accountId filter; preserve filters and follow it until hasMore=false only when a complete list is needed. count is this page's count, never a total. Pages are separate live reads, without a transaction or stable historical snapshot; concurrent changes can affect traversal. A list without all pages is partial. Only declared query parameters are accepted; repeated/scalar type errors, unknown parameters and any non-empty request body are refused.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "members:read",
  "additional": []
}
```

### Parameters

```json
{
  "name": "state",
  "in": "query",
  "schema": {
    "type": "string",
    "enum": [
      "SUBMIT",
      "VALIDE",
      "REJECTED",
      "ALL"
    ],
    "default": "SUBMIT"
  }
}
```

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 100,
    "default": 50
  }
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string",
    "maxLength": 400,
    "pattern": "^[A-Za-z0-9_-]+$"
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Current bounded page; count is the page size, not an organisation total.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data",
          "meta"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "$ref": "#/components/schemas/MemberAccount"
            }
          },
          "meta": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "count",
              "hasMore",
              "nextCursor"
            ],
            "properties": {
              "count": {
                "type": "integer",
                "minimum": 0,
                "maximum": 100
              },
              "hasMore": {
                "type": "boolean"
              },
              "nextCursor": {
                "type": "string",
                "nullable": true
              }
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_MEMBER_QUERY, INVALID_MEMBER_CURSOR, INVALID_MEMBER_ID or UNEXPECTED_REQUEST_BODY: correct only the declared request arguments.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Missing or invalid authentication.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE, INVALID_ORGANISATION_CONTEXT or CAMPAIGN_RESTRICTED_KEY: no account data was returned.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "MEMBER_NOT_FOUND: absent, deleted, foreign or inadmissible object/relation.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "INVALID_MEMBER_HISTORY: ambiguous or malformed history; no mutation or automatic repair.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "MEMBER_READ_UNAVAILABLE: temporary read failure; no business mutation was attempted.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "members:read",
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /members/accounts/{id}

Read one member account access request

`get_member_account`

Requires the explicitly granted members:read scope; contacts:read and an admin CRM role do not replace it. This is organisation-level account administration read access, not the current member's delegated identity. MEMBER_ACCOUNT, ACCOUNT_FAMILY_MEMBER, CRM contact and admin access are different objects and IDs. A CRM family link, matching email or #ACCOUNT tag never grants member access. SUBMIT means awaiting account-space approval, VALIDE means its recorded approval/binding, REJECTED means refused and can be approved again; these are not payment or registration states. Email verification alone is not approval. Profile is only the mirrored first/last name, email and phone; it can differ from current CRM identity. linkedContactId, when present, is freshly admitted in the same organisation, without returning CRM fields; use CRM tools and their own rights for CRM data. Null boolean, identity or date means unknown/absent, never an inferred false or zero. Dates are ISO 8601 UTC or null. No passwords, OTP, reset links, sessions, reusable credentials, raw CRM, profile extras, private settings or provider data are returned. Read-only: no binding, approval, rejection, session issuance/revocation, profile sync, email, provider call or business write. Authentication may update API-key usage telemetry. Campaign-restricted keys are refused with 403 CAMPAIGN_RESTRICTED_KEY because account access has no independently established campaign membership. Missing, deleted, foreign or invalidly related objects return 404 MEMBER_NOT_FOUND; ambiguous duplicate IDs, malformed history or a changed page return 409. Stop on these errors; do not infer access or repair through contact edits. Account reads return an opaque revision for conditional account approval/refusal; it is checked at admission, not an atomic CAS with internal writers. Account and family decisions require their exact action scopes; member application access is deferred by product decision: inspect get_member_capabilities. Supply an account UUID returned by list_member_accounts, never a CRM contact UUID or admin access ID. No query parameters or non-empty request body are accepted. The result includes the current opaque revision; a decision still requires the exact action scope and intention.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "members:read",
  "additional": []
}
```

### Parameters

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Current observed account-space data or explicit capability limits.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/MemberAccount"
          }
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_MEMBER_QUERY, INVALID_MEMBER_CURSOR, INVALID_MEMBER_ID or UNEXPECTED_REQUEST_BODY: correct only the declared request arguments.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Missing or invalid authentication.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE, INVALID_ORGANISATION_CONTEXT or CAMPAIGN_RESTRICTED_KEY: no account data was returned.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "MEMBER_NOT_FOUND: absent, deleted, foreign or inadmissible object/relation.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "INVALID_MEMBER_HISTORY: ambiguous or malformed history; no mutation or automatic repair.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "MEMBER_READ_UNAVAILABLE: temporary read failure; no business mutation was attempted.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "members:read",
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /members/family-requests

List account family access requests and their approval states

`list_member_family_requests`

Requires the explicitly granted members:read scope; contacts:read and an admin CRM role do not replace it. This is organisation-level account administration read access, not the current member's delegated identity. MEMBER_ACCOUNT, ACCOUNT_FAMILY_MEMBER, CRM contact and admin access are different objects and IDs. A CRM family link, matching email or #ACCOUNT tag never grants member access. SUBMIT means awaiting account-space approval, VALIDE means its recorded approval/binding, REJECTED means refused and can be approved again; these are not payment or registration states. Email verification alone is not approval. Profile is only the mirrored first/last name, email and phone; it can differ from current CRM identity. linkedContactId, when present, is freshly admitted in the same organisation, without returning CRM fields; use CRM tools and their own rights for CRM data. Null boolean, identity or date means unknown/absent, never an inferred false or zero. Dates are ISO 8601 UTC or null. No passwords, OTP, reset links, sessions, reusable credentials, raw CRM, profile extras, private settings or provider data are returned. Read-only: no binding, approval, rejection, session issuance/revocation, profile sync, email, provider call or business write. Authentication may update API-key usage telemetry. Campaign-restricted keys are refused with 403 CAMPAIGN_RESTRICTED_KEY because account access has no independently established campaign membership. Missing, deleted, foreign or invalidly related objects return 404 MEMBER_NOT_FOUND; ambiguous duplicate IDs, malformed history or a changed page return 409. Stop on these errors; do not infer access or repair through contact edits. Account reads return an opaque revision for conditional account approval/refusal; it is checked at admission, not an atomic CAS with internal writers. Account and family decisions require their exact action scopes; member application access is deferred by product decision: inspect get_member_capabilities. Each family request's accountId is freshly admitted in the same organisation. The holder's approval does not approve every relative. CONJOINT is spouse/partner and ENFANT is child; this relation is the request's recorded account-space relation, not independent CRM proof. A backend family request can exist while family display is disabled; this read does not prove the feature is currently enabled. state defaults to SUBMIT; use ALL for every recorded state. Pages sort by exact ID ascending, with limit default 50 and maximum 100. nextCursor is opaque and bound to the organisation, resource, state and accountId filter; preserve filters and follow it until hasMore=false only when a complete list is needed. count is this page's count, never a total. Pages are separate live reads, without a transaction or stable historical snapshot; concurrent changes can affect traversal. A list without all pages is partial. Only declared query parameters are accepted; repeated/scalar type errors, unknown parameters and any non-empty request body are refused.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "members:read",
  "additional": []
}
```

### Parameters

```json
{
  "name": "state",
  "in": "query",
  "schema": {
    "type": "string",
    "enum": [
      "SUBMIT",
      "VALIDE",
      "REJECTED",
      "ALL"
    ],
    "default": "SUBMIT"
  }
}
```

```json
{
  "name": "limit",
  "in": "query",
  "schema": {
    "type": "integer",
    "minimum": 1,
    "maximum": 100,
    "default": 50
  }
}
```

```json
{
  "name": "cursor",
  "in": "query",
  "schema": {
    "type": "string",
    "maxLength": 400,
    "pattern": "^[A-Za-z0-9_-]+$"
  }
}
```

```json
{
  "name": "accountId",
  "in": "query",
  "schema": {
    "type": "string",
    "format": "uuid"
  },
  "description": "Optional exact parent member account UUID, independently admitted in the current organisation."
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Current bounded page; count is the page size, not an organisation total.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data",
          "meta"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "type": "array",
            "maxItems": 100,
            "items": {
              "$ref": "#/components/schemas/MemberFamilyRequest"
            }
          },
          "meta": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "count",
              "hasMore",
              "nextCursor"
            ],
            "properties": {
              "count": {
                "type": "integer",
                "minimum": 0,
                "maximum": 100
              },
              "hasMore": {
                "type": "boolean"
              },
              "nextCursor": {
                "type": "string",
                "nullable": true
              }
            }
          }
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_MEMBER_QUERY, INVALID_MEMBER_CURSOR, INVALID_MEMBER_ID or UNEXPECTED_REQUEST_BODY: correct only the declared request arguments.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Missing or invalid authentication.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE, INVALID_ORGANISATION_CONTEXT or CAMPAIGN_RESTRICTED_KEY: no account data was returned.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "MEMBER_NOT_FOUND: absent, deleted, foreign or inadmissible object/relation.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "INVALID_MEMBER_HISTORY: ambiguous or malformed history; no mutation or automatic repair.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "MEMBER_READ_UNAVAILABLE: temporary read failure; no business mutation was attempted.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "members:read",
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## GET /members/family-requests/{id}

Read one account family access request

`get_member_family_request`

Requires the explicitly granted members:read scope; contacts:read and an admin CRM role do not replace it. This is organisation-level account administration read access, not the current member's delegated identity. MEMBER_ACCOUNT, ACCOUNT_FAMILY_MEMBER, CRM contact and admin access are different objects and IDs. A CRM family link, matching email or #ACCOUNT tag never grants member access. SUBMIT means awaiting account-space approval, VALIDE means its recorded approval/binding, REJECTED means refused and can be approved again; these are not payment or registration states. Email verification alone is not approval. Profile is only the mirrored first/last name, email and phone; it can differ from current CRM identity. linkedContactId, when present, is freshly admitted in the same organisation, without returning CRM fields; use CRM tools and their own rights for CRM data. Null boolean, identity or date means unknown/absent, never an inferred false or zero. Dates are ISO 8601 UTC or null. No passwords, OTP, reset links, sessions, reusable credentials, raw CRM, profile extras, private settings or provider data are returned. Read-only: no binding, approval, rejection, session issuance/revocation, profile sync, email, provider call or business write. Authentication may update API-key usage telemetry. Campaign-restricted keys are refused with 403 CAMPAIGN_RESTRICTED_KEY because account access has no independently established campaign membership. Missing, deleted, foreign or invalidly related objects return 404 MEMBER_NOT_FOUND; ambiguous duplicate IDs, malformed history or a changed page return 409. Stop on these errors; do not infer access or repair through contact edits. Account reads return an opaque revision for conditional account approval/refusal; it is checked at admission, not an atomic CAS with internal writers. Account and family decisions require their exact action scopes; member application access is deferred by product decision: inspect get_member_capabilities. Supply an account-family-member UUID from list_member_family_requests, never its parent accountId or CRM contact UUID. The parent accountId is freshly admitted in the same organisation. CONJOINT is spouse/partner and ENFANT is child; neither a recorded relation nor the holder's approval proves this relative has access. No query parameters or non-empty request body are accepted. Family feature settings are not exposed and may hide existing requests in the product UI.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "members:read",
  "additional": []
}
```

### Parameters

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Current observed account-space data or explicit capability limits.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "data": {
            "$ref": "#/components/schemas/MemberFamilyRequest"
          }
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_MEMBER_QUERY, INVALID_MEMBER_CURSOR, INVALID_MEMBER_ID or UNEXPECTED_REQUEST_BODY: correct only the declared request arguments.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Missing or invalid authentication.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE, INVALID_ORGANISATION_CONTEXT or CAMPAIGN_RESTRICTED_KEY: no account data was returned.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "MEMBER_NOT_FOUND: absent, deleted, foreign or inadmissible object/relation.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "INVALID_MEMBER_HISTORY: ambiguous or malformed history; no mutation or automatic repair.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "MEMBER_READ_UNAVAILABLE: temporary read failure; no business mutation was attempted.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "members:read",
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "read",
    "readOnly": true,
    "destructive": false,
    "idempotent": true,
    "warn": false
  }
}
```

## POST /members/accounts/{id}/approve

Approve a member account against an exact existing CRM contact

`approve_member_account`

Requires members:approve. An account administration command, never member impersonation or an admin-role grant. Requires members:read AND the action's explicit opt-in scope. Read the matching get_member_account or get_member_family_request first and pass its exact revision as expectedRevision; provide a new UUID idempotencyKey for that exact intention and preserve both values on a lost response. No query parameters or unknown body fields are accepted. Global native account/contact IDs and exact organisation tuples are checked before calling the existing account owner. Every lock/journal reservation requires acknowledged:true and its exact insertedId with writeConcern:{w:1,j:true} before owner execution; inline CAS and terminal confirmation require a positive durable ACK. A durable journal and non-expiring account/contact locks serialize external commands; internal product writers do not share this lock. The revision is checked at admission immediately before the owner, not atomically with its writes: concurrent internal changes remain possible and are explicitly reported. APPLIED means the owner returned and the requested account state/binding was observed, not complete CRM synchronisation, email delivery, credential issuance, payment or registration. crmSynchronization is always NOT_VERIFIED because the CRM owner catches some errors internally. account is the current read-back and may differ on a later replay; resultRevision identifies the initial confirmed observation. UNKNOWN means the owner may have partially or fully applied the decision or durable confirmation failed; retain the same decision identity, inspect current state and seek reconciliation in the existing product workflow. Never retry with a new idempotencyKey, expectedRevision or different target to bypass UNKNOWN. A same-key replay never invokes the owner again; an apparently APPLIED journal with a retained command lock remains UNKNOWN; changing its intention returns 409 MEMBER_IDEMPOTENCY_CONFLICT. A lock without recoverable result returns 409 MEMBER_DECISION_IN_PROGRESS; no timeout unlock or automatic owner replay occurs. NOT_APPLIED means a second admission failed before the owner was invoked; its reason identifies the failed precondition. After second admission, the common external contact fence checks the exact admitted resources before any owner or inline CAS. CONTACT_MUTATION_BLOCKED or CONTACT_MUTATION_FENCE_UNAVAILABLE records NOT_APPLIED before effects; replay does not retry the refused intention. If the owner result and terminal journal were positively confirmed in this request, a failed lock cleanup preserves APPLIED with reason MEMBER_DECISION_CLEANUP_UNCONFIRMED; locks may remain, so do not submit another command. A later replay with retained locks remains UNKNOWN without a fresh durable proof of terminal confirmation. 409 revision/state/identity/target errors mean no new owner call occurred. Missing/foreign/deleted references return 404. Campaign-restricted keys return 403. No password, reset, OTP, session, token, secret or raw owner error is accepted or returned. No activation email is sent by these endpoints. Approval accepts only SUBMIT or REJECTED accounts with emailVerified=true and active absent or a proper boolean other than false. targetContactId is mandatory and identifies a globally unique existing contact in this organisation, selected by the administrator's actual intention; the target must not belong to another active account/family link. No email/name/family matching, new contact creation or rebinding to a different former contact is performed. The existing owner seeds the profile mirror, marks VALIDE and attempts its normal CRM synchronisation. Source and target identity/address structure must be valid. Missing verification, invalid profile, current VALIDE state, conflicting target or rebind returns 409; resolve the actual ambiguity instead of fabricating a contact or tag.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "members:approve",
  "additional": [
    "members:read"
  ]
}
```

### Parameters

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Request body

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "targetContactId": {
            "type": "string",
            "format": "uuid"
          }
        },
        "required": [
          "idempotencyKey",
          "expectedRevision",
          "targetContactId"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Recorded outcome: inspect APPLIED, NOT_APPLIED or UNKNOWN before concluding that access changed.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "replayed",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "replayed": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/MemberDecision"
          }
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_MEMBER_DECISION, INVALID_MEMBER_QUERY or INVALID_MEMBER_ID: supply only the exact declared command arguments.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Missing or invalid authentication.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE, INVALID_ORGANISATION_CONTEXT or CAMPAIGN_RESTRICTED_KEY: no account data was returned.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "MEMBER_NOT_FOUND: account or reference is not currently admissible. A lost response or failed post-read must not trigger a new decision identity.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "MEMBER_REVISION_CONFLICT, AMBIGUOUS_MEMBER_IDENTITY, MEMBER_APPROVAL_PRECONDITION, MEMBER_REJECTION_PRECONDITION, MEMBER_REBIND_UNAVAILABLE, MEMBER_TARGET_CONFLICT, MEMBER_IDEMPOTENCY_CONFLICT, MEMBER_DECISION_IN_PROGRESS, MEMBER_FAMILY_CONFLICT, MEMBER_FAMILY_LIMIT or INVALID_MEMBER_HISTORY: inspect the exact reason; never bypass a pending or unknown decision with another key.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "MEMBER_DECISION_UNAVAILABLE: no confirmed result is available. Preserve the original idempotencyKey and intention, inspect current state and replay only that same intention; never infer that no effect occurred.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "members:approve",
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "action",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": true
  },
  "x-unisoft-additional-scopes": [
    "members:read"
  ]
}
```

## POST /members/accounts/{id}/reject

Reject a member account access request

`reject_member_account`

Requires members:reject. An account administration command, never member impersonation or an admin-role grant. Requires members:read AND the action's explicit opt-in scope. Read the matching get_member_account or get_member_family_request first and pass its exact revision as expectedRevision; provide a new UUID idempotencyKey for that exact intention and preserve both values on a lost response. No query parameters or unknown body fields are accepted. Global native account/contact IDs and exact organisation tuples are checked before calling the existing account owner. Every lock/journal reservation requires acknowledged:true and its exact insertedId with writeConcern:{w:1,j:true} before owner execution; inline CAS and terminal confirmation require a positive durable ACK. A durable journal and non-expiring account/contact locks serialize external commands; internal product writers do not share this lock. The revision is checked at admission immediately before the owner, not atomically with its writes: concurrent internal changes remain possible and are explicitly reported. APPLIED means the owner returned and the requested account state/binding was observed, not complete CRM synchronisation, email delivery, credential issuance, payment or registration. crmSynchronization is always NOT_VERIFIED because the CRM owner catches some errors internally. account is the current read-back and may differ on a later replay; resultRevision identifies the initial confirmed observation. UNKNOWN means the owner may have partially or fully applied the decision or durable confirmation failed; retain the same decision identity, inspect current state and seek reconciliation in the existing product workflow. Never retry with a new idempotencyKey, expectedRevision or different target to bypass UNKNOWN. A same-key replay never invokes the owner again; an apparently APPLIED journal with a retained command lock remains UNKNOWN; changing its intention returns 409 MEMBER_IDEMPOTENCY_CONFLICT. A lock without recoverable result returns 409 MEMBER_DECISION_IN_PROGRESS; no timeout unlock or automatic owner replay occurs. NOT_APPLIED means a second admission failed before the owner was invoked; its reason identifies the failed precondition. After second admission, the common external contact fence checks the exact admitted resources before any owner or inline CAS. CONTACT_MUTATION_BLOCKED or CONTACT_MUTATION_FENCE_UNAVAILABLE records NOT_APPLIED before effects; replay does not retry the refused intention. If the owner result and terminal journal were positively confirmed in this request, a failed lock cleanup preserves APPLIED with reason MEMBER_DECISION_CLEANUP_UNCONFIRMED; locks may remain, so do not submit another command. A later replay with retained locks remains UNKNOWN without a fresh durable proof of terminal confirmation. 409 revision/state/identity/target errors mean no new owner call occurred. Missing/foreign/deleted references return 404. Campaign-restricted keys return 403. No password, reset, OTP, session, token, secret or raw owner error is accepted or returned. No activation email is sent by these endpoints. Refusal accepts SUBMIT or VALIDE accounts and marks REJECTED through the existing owner. It clears the matching denormalised CRM account pointer when present; it does not delete the contact, remove family relations, revoke existing sessions or change financial/registration records. The retained selfContact is historical linkage, not proof of current access. Already REJECTED returns 409 for a new command; replay the original key for the original outcome.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "members:reject",
  "additional": [
    "members:read"
  ]
}
```

### Parameters

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Request body

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          }
        },
        "required": [
          "idempotencyKey",
          "expectedRevision"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Recorded outcome: inspect APPLIED, NOT_APPLIED or UNKNOWN before concluding that access changed.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "replayed",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "replayed": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/MemberDecision"
          }
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_MEMBER_DECISION, INVALID_MEMBER_QUERY or INVALID_MEMBER_ID: supply only the exact declared command arguments.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Missing or invalid authentication.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE, INVALID_ORGANISATION_CONTEXT or CAMPAIGN_RESTRICTED_KEY: no account data was returned.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "MEMBER_NOT_FOUND: account or reference is not currently admissible. A lost response or failed post-read must not trigger a new decision identity.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "MEMBER_REVISION_CONFLICT, AMBIGUOUS_MEMBER_IDENTITY, MEMBER_APPROVAL_PRECONDITION, MEMBER_REJECTION_PRECONDITION, MEMBER_REBIND_UNAVAILABLE, MEMBER_TARGET_CONFLICT, MEMBER_IDEMPOTENCY_CONFLICT, MEMBER_DECISION_IN_PROGRESS, MEMBER_FAMILY_CONFLICT, MEMBER_FAMILY_LIMIT or INVALID_MEMBER_HISTORY: inspect the exact reason; never bypass a pending or unknown decision with another key.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "MEMBER_DECISION_UNAVAILABLE: no confirmed result is available. Preserve the original idempotencyKey and intention, inspect current state and replay only that same intention; never infer that no effect occurred.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "members:reject",
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "action",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": true
  },
  "x-unisoft-additional-scopes": [
    "members:read"
  ]
}
```

## POST /members/family-requests/{id}/approve

Approve a family access request against an exact existing CRM contact

`approve_member_family_request`

Requires members:approve. An account administration command, never member impersonation or an admin-role grant. Requires members:read AND the action's explicit opt-in scope. Read the matching get_member_account or get_member_family_request first and pass its exact revision as expectedRevision; provide a new UUID idempotencyKey for that exact intention and preserve both values on a lost response. No query parameters or unknown body fields are accepted. Global native account/contact IDs and exact organisation tuples are checked before calling the existing account owner. Every lock/journal reservation requires acknowledged:true and its exact insertedId with writeConcern:{w:1,j:true} before owner execution; inline CAS and terminal confirmation require a positive durable ACK. A durable journal and non-expiring account/contact locks serialize external commands; internal product writers do not share this lock. The revision is checked at admission immediately before the owner, not atomically with its writes: concurrent internal changes remain possible and are explicitly reported. APPLIED means the owner returned and the requested account state/binding was observed, not complete CRM synchronisation, email delivery, credential issuance, payment or registration. crmSynchronization is always NOT_VERIFIED because the CRM owner catches some errors internally. account is the current read-back and may differ on a later replay; resultRevision identifies the initial confirmed observation. UNKNOWN means the owner may have partially or fully applied the decision or durable confirmation failed; retain the same decision identity, inspect current state and seek reconciliation in the existing product workflow. Never retry with a new idempotencyKey, expectedRevision or different target to bypass UNKNOWN. A same-key replay never invokes the owner again; an apparently APPLIED journal with a retained command lock remains UNKNOWN; changing its intention returns 409 MEMBER_IDEMPOTENCY_CONFLICT. A lock without recoverable result returns 409 MEMBER_DECISION_IN_PROGRESS; no timeout unlock or automatic owner replay occurs. NOT_APPLIED means a second admission failed before the owner was invoked; its reason identifies the failed precondition. After second admission, the common external contact fence checks the exact admitted resources before any owner or inline CAS. CONTACT_MUTATION_BLOCKED or CONTACT_MUTATION_FENCE_UNAVAILABLE records NOT_APPLIED before effects; replay does not retry the refused intention. If the owner result and terminal journal were positively confirmed in this request, a failed lock cleanup preserves APPLIED with reason MEMBER_DECISION_CLEANUP_UNCONFIRMED; locks may remain, so do not submit another command. A later replay with retained locks remains UNKNOWN without a fresh durable proof of terminal confirmation. 409 revision/state/identity/target errors mean no new owner call occurred. Missing/foreign/deleted references return 404. Campaign-restricted keys return 403. No password, reset, OTP, session, token, secret or raw owner error is accepted or returned. No activation email is sent by these endpoints. Supply the family request UUID, not its parent accountId or CRM contact ID. Read get_member_family_request first: its revision covers the request, current parent account and recorded spouse candidates; relatedContactIds lists the holder and, for a child, the currently validated spouse when present. Those IDs are a current observation, never independent authority. Every family decision locks its parent account, request and touched CRM contacts. At most 200 spouse candidates and 2000 CRM relation entries per touched contact are admitted; ambiguous, foreign, duplicate or malformed parent/spouse/chef-family records return 409 or 404 before effects.  Approval accepts SUBMIT or REJECTED requests with a valid profile and a current VALIDE, email-verified, non-inactive holder bound to a CRM contact. targetContactId must be an existing globally unique contact in the same organisation, distinct from the holder/validated spouse and unbound to another validated holder/family request. Rebinding to a different former contact is refused. CONJOINT allows no other non-rejected spouse request. ENFANT uses the holder and at most one current validated spouse as parents; all native inferred identities are admitted globally before the existing bindMember owner is called. Both directions of each relation are preflighted against conflicting types and checked after the owner. The native chef-family propagation is also admitted. Existing target selection bypasses matching/creation, even for a child without contact means. APPLIED confirms the recorded family state/binding and required direct/reverse relation observations; profile sync is still NOT_VERIFIED. Adding a spouse does not retroactively link already registered children to that spouse.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "members:approve",
  "additional": [
    "members:read"
  ]
}
```

### Parameters

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Request body

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "targetContactId": {
            "type": "string",
            "format": "uuid"
          }
        },
        "required": [
          "idempotencyKey",
          "expectedRevision",
          "targetContactId"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Recorded outcome: inspect APPLIED, NOT_APPLIED or UNKNOWN before concluding that access changed.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "replayed",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "replayed": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/MemberFamilyDecision"
          }
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_MEMBER_DECISION, INVALID_MEMBER_QUERY or INVALID_MEMBER_ID: supply only the exact declared command arguments.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Missing or invalid authentication.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE, INVALID_ORGANISATION_CONTEXT or CAMPAIGN_RESTRICTED_KEY: no account data was returned.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "MEMBER_NOT_FOUND: account or reference is not currently admissible. A lost response or failed post-read must not trigger a new decision identity.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "MEMBER_REVISION_CONFLICT, AMBIGUOUS_MEMBER_IDENTITY, MEMBER_APPROVAL_PRECONDITION, MEMBER_REJECTION_PRECONDITION, MEMBER_REBIND_UNAVAILABLE, MEMBER_TARGET_CONFLICT, MEMBER_IDEMPOTENCY_CONFLICT, MEMBER_DECISION_IN_PROGRESS, MEMBER_FAMILY_CONFLICT, MEMBER_FAMILY_LIMIT or INVALID_MEMBER_HISTORY: inspect the exact reason; never bypass a pending or unknown decision with another key.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "MEMBER_DECISION_UNAVAILABLE: no confirmed result is available. Preserve the original idempotencyKey and intention, inspect current state and replay only that same intention; never infer that no effect occurred.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "members:approve",
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "action",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": true
  },
  "x-unisoft-additional-scopes": [
    "members:read"
  ]
}
```

## POST /members/family-requests/{id}/reject

Reject a family access request

`reject_member_family_request`

Requires members:reject. An account administration command, never member impersonation or an admin-role grant. Requires members:read AND the action's explicit opt-in scope. Read the matching get_member_account or get_member_family_request first and pass its exact revision as expectedRevision; provide a new UUID idempotencyKey for that exact intention and preserve both values on a lost response. No query parameters or unknown body fields are accepted. Global native account/contact IDs and exact organisation tuples are checked before calling the existing account owner. Every lock/journal reservation requires acknowledged:true and its exact insertedId with writeConcern:{w:1,j:true} before owner execution; inline CAS and terminal confirmation require a positive durable ACK. A durable journal and non-expiring account/contact locks serialize external commands; internal product writers do not share this lock. The revision is checked at admission immediately before the owner, not atomically with its writes: concurrent internal changes remain possible and are explicitly reported. APPLIED means the owner returned and the requested account state/binding was observed, not complete CRM synchronisation, email delivery, credential issuance, payment or registration. crmSynchronization is always NOT_VERIFIED because the CRM owner catches some errors internally. account is the current read-back and may differ on a later replay; resultRevision identifies the initial confirmed observation. UNKNOWN means the owner may have partially or fully applied the decision or durable confirmation failed; retain the same decision identity, inspect current state and seek reconciliation in the existing product workflow. Never retry with a new idempotencyKey, expectedRevision or different target to bypass UNKNOWN. A same-key replay never invokes the owner again; an apparently APPLIED journal with a retained command lock remains UNKNOWN; changing its intention returns 409 MEMBER_IDEMPOTENCY_CONFLICT. A lock without recoverable result returns 409 MEMBER_DECISION_IN_PROGRESS; no timeout unlock or automatic owner replay occurs. NOT_APPLIED means a second admission failed before the owner was invoked; its reason identifies the failed precondition. After second admission, the common external contact fence checks the exact admitted resources before any owner or inline CAS. CONTACT_MUTATION_BLOCKED or CONTACT_MUTATION_FENCE_UNAVAILABLE records NOT_APPLIED before effects; replay does not retry the refused intention. If the owner result and terminal journal were positively confirmed in this request, a failed lock cleanup preserves APPLIED with reason MEMBER_DECISION_CLEANUP_UNCONFIRMED; locks may remain, so do not submit another command. A later replay with retained locks remains UNKNOWN without a fresh durable proof of terminal confirmation. 409 revision/state/identity/target errors mean no new owner call occurred. Missing/foreign/deleted references return 404. Campaign-restricted keys return 403. No password, reset, OTP, session, token, secret or raw owner error is accepted or returned. No activation email is sent by these endpoints. Supply the family request UUID, not its parent accountId or CRM contact ID. Read get_member_family_request first: its revision covers the request, current parent account and recorded spouse candidates; relatedContactIds lists the holder and, for a child, the currently validated spouse when present. Those IDs are a current observation, never independent authority. Every family decision locks its parent account, request and touched CRM contacts. At most 200 spouse candidates and 2000 CRM relation entries per touched contact are admitted; ambiguous, foreign, duplicate or malformed parent/spouse/chef-family records return 409 or 404 before effects.  Refusal accepts SUBMIT or VALIDE requests and conditionally records the native REJECTED state, which removes this request from validated account membership. It retains contactId and all CRM family relations. A matching accountRole:MEMBER CRM pointer is cleared only when no other current validated holder/family binding depends on it; SELF or another account's pointer is preserved. No contact/request deletion, session revocation or email occurs. Already REJECTED needs the original decision key to replay its original outcome.

### Authentication

```json
[
  {
    "bearerAuth": []
  },
  {
    "apiKeyHeader": []
  }
]
```

### Required permissions

```json
{
  "accepted": "members:reject",
  "additional": [
    "members:read"
  ]
}
```

### Parameters

```json
{
  "name": "id",
  "in": "path",
  "required": true,
  "schema": {
    "type": "string",
    "format": "uuid"
  }
}
```

### Request body

```json
{
  "required": true,
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "properties": {
          "idempotencyKey": {
            "type": "string",
            "format": "uuid"
          },
          "expectedRevision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          }
        },
        "required": [
          "idempotencyKey",
          "expectedRevision"
        ],
        "additionalProperties": false
      }
    }
  }
}
```

### Responses

#### HTTP 200

```json
{
  "description": "Recorded outcome: inspect APPLIED, NOT_APPLIED or UNKNOWN before concluding that access changed.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "replayed",
          "data"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "replayed": {
            "type": "boolean"
          },
          "data": {
            "$ref": "#/components/schemas/MemberFamilyDecision"
          }
        }
      }
    }
  }
}
```

#### HTTP 400

```json
{
  "description": "INVALID_MEMBER_DECISION, INVALID_MEMBER_QUERY or INVALID_MEMBER_ID: supply only the exact declared command arguments.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 401

```json
{
  "description": "Missing or invalid authentication.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 403

```json
{
  "description": "INSUFFICIENT_SCOPE, INVALID_ORGANISATION_CONTEXT or CAMPAIGN_RESTRICTED_KEY: no account data was returned.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 404

```json
{
  "description": "MEMBER_NOT_FOUND: account or reference is not currently admissible. A lost response or failed post-read must not trigger a new decision identity.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 409

```json
{
  "description": "MEMBER_REVISION_CONFLICT, AMBIGUOUS_MEMBER_IDENTITY, MEMBER_APPROVAL_PRECONDITION, MEMBER_REJECTION_PRECONDITION, MEMBER_REBIND_UNAVAILABLE, MEMBER_TARGET_CONFLICT, MEMBER_IDEMPOTENCY_CONFLICT, MEMBER_DECISION_IN_PROGRESS, MEMBER_FAMILY_CONFLICT, MEMBER_FAMILY_LIMIT or INVALID_MEMBER_HISTORY: inspect the exact reason; never bypass a pending or unknown decision with another key.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

#### HTTP 500

```json
{
  "description": "MEMBER_DECISION_UNAVAILABLE: no confirmed result is available. Preserve the original idempotencyKey and intention, inspect current state and replay only that same intention; never infer that no effect occurred.",
  "content": {
    "application/json": {
      "schema": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "success",
          "error"
        ],
        "properties": {
          "success": {
            "type": "boolean",
            "enum": [
              false
            ]
          },
          "error": {
            "type": "string"
          }
        }
      }
    }
  }
}
```

### OpenAPI

```json
{
  "x-unisoft-scope": "members:reject",
  "x-unisoft-mcp-output-schema": true,
  "x-unisoft-mcp": {
    "category": "action",
    "readOnly": false,
    "destructive": true,
    "idempotent": true,
    "warn": true
  },
  "x-unisoft-additional-scopes": [
    "members:read"
  ]
}
```

## Schemas

```json
{
  "components": {
    "schemas": {
      "MemberCapabilities": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "resource",
          "accountsRead",
          "familyRequestsRead",
          "decisions",
          "memberApplication"
        ],
        "properties": {
          "resource": {
            "type": "string",
            "enum": [
              "MEMBER_ACCOUNT_SPACE"
            ]
          },
          "accountsRead": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "familyRequestsRead": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "decisions": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "supported",
              "actions",
              "existingContactRequired",
              "familyApproval",
              "familyRejection"
            ],
            "properties": {
              "supported": {
                "type": "boolean",
                "enum": [
                  true
                ]
              },
              "actions": {
                "type": "array",
                "minItems": 4,
                "maxItems": 4,
                "uniqueItems": true,
                "items": {
                  "type": "string",
                  "enum": [
                    "APPROVE_ACCOUNT",
                    "REJECT_ACCOUNT",
                    "APPROVE_FAMILY_MEMBER",
                    "REJECT_FAMILY_MEMBER"
                  ]
                }
              },
              "existingContactRequired": {
                "type": "boolean",
                "enum": [
                  true
                ]
              },
              "familyApproval": {
                "type": "boolean",
                "enum": [
                  true
                ]
              },
              "familyRejection": {
                "type": "boolean",
                "enum": [
                  true
                ]
              }
            }
          },
          "memberApplication": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "supported",
              "reason"
            ],
            "properties": {
              "supported": {
                "type": "boolean",
                "enum": [
                  false
                ]
              },
              "reason": {
                "type": "string",
                "enum": [
                  "DEFERRED_BY_PRODUCT_DECISION"
                ]
              }
            }
          }
        }
      },
      "MemberAccount": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "kind",
          "revision",
          "state",
          "email",
          "emailVerified",
          "active",
          "profile",
          "linkedContactId",
          "createdAt",
          "validatedAt",
          "rejectedAt"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "kind": {
            "type": "string",
            "enum": [
              "MEMBER_ACCOUNT"
            ]
          },
          "revision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "state": {
            "type": "string",
            "enum": [
              "SUBMIT",
              "VALIDE",
              "REJECTED"
            ]
          },
          "email": {
            "type": "string",
            "nullable": true
          },
          "emailVerified": {
            "type": "boolean",
            "nullable": true
          },
          "active": {
            "type": "boolean",
            "nullable": true
          },
          "profile": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "firstName",
              "lastName",
              "email",
              "phone"
            ],
            "properties": {
              "firstName": {
                "type": "string",
                "nullable": true
              },
              "lastName": {
                "type": "string",
                "nullable": true
              },
              "email": {
                "type": "string",
                "nullable": true
              },
              "phone": {
                "type": "string",
                "nullable": true
              }
            }
          },
          "linkedContactId": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "validatedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "rejectedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          }
        }
      },
      "MemberFamilyRequest": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "kind",
          "accountId",
          "revision",
          "relatedContactIds",
          "state",
          "relationship",
          "hasContactMeans",
          "profile",
          "linkedContactId",
          "createdAt",
          "validatedAt",
          "rejectedAt"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "kind": {
            "type": "string",
            "enum": [
              "ACCOUNT_FAMILY_MEMBER"
            ]
          },
          "accountId": {
            "type": "string",
            "format": "uuid"
          },
          "revision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "relatedContactIds": {
            "type": "array",
            "maxItems": 2,
            "uniqueItems": true,
            "items": {
              "type": "string",
              "format": "uuid"
            }
          },
          "state": {
            "type": "string",
            "enum": [
              "SUBMIT",
              "VALIDE",
              "REJECTED"
            ]
          },
          "relationship": {
            "type": "string",
            "enum": [
              "CONJOINT",
              "ENFANT"
            ]
          },
          "hasContactMeans": {
            "type": "boolean",
            "nullable": true
          },
          "profile": {
            "type": "object",
            "additionalProperties": false,
            "required": [
              "firstName",
              "lastName",
              "email",
              "phone"
            ],
            "properties": {
              "firstName": {
                "type": "string",
                "nullable": true
              },
              "lastName": {
                "type": "string",
                "nullable": true
              },
              "email": {
                "type": "string",
                "nullable": true
              },
              "phone": {
                "type": "string",
                "nullable": true
              }
            }
          },
          "linkedContactId": {
            "type": "string",
            "format": "uuid",
            "nullable": true
          },
          "createdAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "validatedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          },
          "rejectedAt": {
            "type": "string",
            "format": "date-time",
            "nullable": true
          }
        }
      },
      "MemberDecision": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "accountId",
          "action",
          "status",
          "reason",
          "admittedRevision",
          "resultRevision",
          "concurrentInternalChangesPossible",
          "crmSynchronization",
          "account"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "accountId": {
            "type": "string",
            "format": "uuid"
          },
          "action": {
            "type": "string",
            "enum": [
              "APPROVE",
              "REJECT"
            ]
          },
          "status": {
            "type": "string",
            "enum": [
              "APPLIED",
              "NOT_APPLIED",
              "UNKNOWN"
            ]
          },
          "reason": {
            "type": "string",
            "nullable": true
          },
          "admittedRevision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "resultRevision": {
            "type": "string",
            "nullable": true,
            "pattern": "^[a-f0-9]{64}$"
          },
          "concurrentInternalChangesPossible": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "crmSynchronization": {
            "type": "string",
            "enum": [
              "NOT_VERIFIED"
            ]
          },
          "account": {
            "$ref": "#/components/schemas/MemberAccount"
          }
        }
      },
      "MemberFamilyDecision": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "id",
          "accountId",
          "action",
          "status",
          "reason",
          "admittedRevision",
          "resultRevision",
          "concurrentInternalChangesPossible",
          "crmSynchronization",
          "requestId",
          "familyRequest"
        ],
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid"
          },
          "accountId": {
            "type": "string",
            "format": "uuid"
          },
          "action": {
            "type": "string",
            "enum": [
              "APPROVE",
              "REJECT"
            ]
          },
          "status": {
            "type": "string",
            "enum": [
              "APPLIED",
              "NOT_APPLIED",
              "UNKNOWN"
            ]
          },
          "reason": {
            "type": "string",
            "nullable": true
          },
          "admittedRevision": {
            "type": "string",
            "pattern": "^[a-f0-9]{64}$"
          },
          "resultRevision": {
            "type": "string",
            "nullable": true,
            "pattern": "^[a-f0-9]{64}$"
          },
          "concurrentInternalChangesPossible": {
            "type": "boolean",
            "enum": [
              true
            ]
          },
          "crmSynchronization": {
            "type": "string",
            "enum": [
              "NOT_VERIFIED"
            ]
          },
          "requestId": {
            "type": "string",
            "format": "uuid"
          },
          "familyRequest": {
            "$ref": "#/components/schemas/MemberFamilyRequest"
          }
        }
      }
    },
    "securitySchemes": {
      "bearerAuth": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "API Key",
        "description": "Format: `ke_live_xxx`"
      },
      "apiKeyHeader": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    }
  }
}
```
