SMAO API Documentation
Partners

Update partner

PATCH
/partners/{partnerId}
AuthorizationBearer <token>

Long-lived distributor API key scoped to a channel partner on the shared smao instance.

In: header

Path Parameters

partnerIdstring

MongoDB ObjectId of the partner (MSP).

Match^[a-fA-F0-9]{24}$
name?string
Length1 <= length <= 255
externalPartnerId?string
Length1 <= length <= 255
contactEmail?string|null
Formatemail
Lengthlength <= 255
contactName?string|null
Length1 <= length <= 255
notes?string|null
Lengthlength <= 1000

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X PATCH "https://api.smao.ai/api/distributor/v1/partners/string" \  -H "Content-Type: application/json" \  -d '{}'
{
  "status": "success",
  "partner": {
    "id": "665abc123def456789012345",
    "name": "MSP Hamburg GmbH",
    "externalPartnerId": "MSP-001",
    "contactEmail": "[email protected]",
    "contactName": "Hans Mueller",
    "isActive": true,
    "notes": null,
    "organizationId": "665abc123def456789012346",
    "organizationCount": 12,
    "createdAt": "2026-03-20T10:41:14.553Z"
  }
}
{
  "status": "error",
  "errorCode": "INVALID_DATE_RANGE",
  "message": "from and to must be valid YYYY-MM-DD values"
}
{
  "status": "error",
  "errorCode": "INVALID_DATE_RANGE",
  "message": "from and to must be valid YYYY-MM-DD values"
}
{
  "status": "error",
  "errorCode": "INVALID_DATE_RANGE",
  "message": "from and to must be valid YYYY-MM-DD values"
}
{
  "status": "error",
  "errorCode": "INVALID_DATE_RANGE",
  "message": "from and to must be valid YYYY-MM-DD values"
}
{
  "status": "error",
  "errorCode": "INVALID_DATE_RANGE",
  "message": "from and to must be valid YYYY-MM-DD values"
}

{
  "status": "error",
  "errorCode": "RATE_LIMITED",
  "message": "Too many requests for this API key."
}
{
  "status": "error",
  "errorCode": "INVALID_DATE_RANGE",
  "message": "from and to must be valid YYYY-MM-DD values"
}

{
  "status": "error",
  "errorCode": "RATE_LIMIT_UNAVAILABLE",
  "message": "Rate limit storage is unavailable. Try again shortly."
}