AI-suggest product mappings

Call the RevKeen AI service to propose product-mapping candidates for unmapped external packages. Inputs: the unmapped package list plus the merchant's product catalogue. Output: a ranked list of suggested `(external_id, revkeen_product_id, confidence)` tuples. No state is written — the merchant must confirm and `PUT` the mapping set. --- **Related endpoints** - `POST /integrations/{provider}/activate` — Activate integration - `POST /integrations/{provider}/deactivate` — Deactivate integration - `GET /integrations/{provider}` — Get integration status - `POST /integrations/{provider}/test` — Test integration credentials - `POST /integrations/{provider}/rotate` — Rotate integration credentials - `POST /integrations/{provider}/sync` — Trigger manual sync - `POST /integrations/{provider}/invoices/{externalInvoiceId}/refresh` — Refresh a single PracticeHub invoice - `GET /integrations/{provider}/invoices/{externalInvoiceId}/refresh-status` — Get demand invoice refresh status **Common errors** - `401 authentication_error` — missing, invalid, expired, or revoked credential. Codes: `authentication_failed`, `invalid_api_key`, `expired_api_key`, `api_key_revoked`, `session_invalid`, `merchant_required`. Carries a `WWW-Authenticate: Bearer` challenge. **Idempotency** Pass an `Idempotency-Key` header (UUID v4 recommended) to make retries safe. Keys are valid for 24 hours; see [the idempotency guide](/docs/fundamentals/idempotency).

curl -X POST "https://api.revkeen.com/v2/integrations/practicehub/suggest-mappings" \
  -H "x-api-key: $REVKEEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "externalItems": [
      {
        "id": "string",
        "name": "string",
        "type": null,
        "charge_type": null,
        "price": null,
        "source": "package"
      }
    ]
  }'

{  "success": true,  "suggestions": [    {      "external_id": "string",      "internal_id": "string",      "confidence": 0,      "reasoning": "string"    }  ]}