Update organization
Update allowed fields on a partner-managed organization. At least one field must be provided. If externalCustomerId is changed, uniqueness is enforced within the partner's organizations.
Long-lived distributor API key scoped to a channel partner on the shared smao instance.
In: header
Path Parameters
MongoDB ObjectId of the organization.
^[a-fA-F0-9]{24}$Display name of the organization.
1 <= length <= 255Industry label. Send empty string to clear.
length <= 255IANA timezone identifier.
1 <= length <= 100Your unique customer identifier. Must be unique within your partner scope. The literal strings "undefined" and "null" are rejected with VALIDATION_ERROR — they mean the value was missing on your side.
1 <= length <= 255Optional contract identifier. Send JSON null to clear. The literal strings "undefined" and "null" are rejected with VALIDATION_ERROR.
length <= 255Response 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/organizations/665abc123def456789012345" \ -H "Content-Type: application/json" \ -d '{ "name": "Acme GmbH (renamed)", "externalContractId": "CON-2026-0002" }'{
"status": "success",
"organization": {
"id": "69c175970f3e28310926a1aa",
"name": "string",
"industry": "string",
"timezone": "string",
"channelPartner": "acme",
"externalCustomerId": "string",
"externalContractId": "string",
"partnerId": "665abc123def456789012345",
"ownerEmail": "[email protected]",
"createdAt": "2019-08-24T14:15:22Z",
"plan": {
"id": "6967b1c7138bed3e7f6bf7e6",
"slug": "string",
"name": "string",
"commitment": "none",
"currency": "string",
"baseFee": 0
}
}
}{
"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."
}