Error Reference
This page documents error codes that appear in the WordPress admin interface and plugin logs. For API error codes returned in REST responses, see the complete Error Messages reference.
Admin-Facing Error Codes
These errors appear as WordPress admin notices or in the plugin's log output.
Organization Errors
| Error Code | Meaning | Fix |
|---|---|---|
MIDDAG-ORG-NOT_FOUND | The requested organization does not exist | Verify the organization ID. It may have been deleted or the ID is from another site |
MIDDAG-ORG-CNPJ_INVALID | CNPJ failed validation against the federal API | Correct the CNPJ number. Ensure it passes check-digit validation |
MIDDAG-ORG-CNPJ_DUPLICATE | Another organization already uses this CNPJ | Search existing organizations for the duplicate. Merge if appropriate |
MIDDAG-ORG-DELETE_DENIED | Non-owner attempted to delete an organization | Only the organization owner can delete it. Contact the owner or a site admin |
Collaborator Errors
| Error Code | Meaning | Fix |
|---|---|---|
MIDDAG-COLLAB-NOT_FOUND | Collaborator record does not exist | The user may not be a member of the organization. Verify the collaborator ID |
MIDDAG-COLLAB-INVITE_EXPIRED | The invitation link has expired | Send a new invitation. Default expiry is configured in plugin settings |
MIDDAG-COLLAB-INVITE_USED | The invitation was already accepted or rejected | No action needed if already accepted. Send a new invite if the user needs re-access |
MIDDAG-COLLAB-ALREADY_MEMBER | User is already a collaborator in this organization | The user already has access. Adjust their role if needed instead of re-inviting |
MIDDAG-COLLAB-ROLE_ESCALATION | Attempted to assign a role higher than the assigner's | Only users with equal or higher roles can assign. Use an admin account |
Entitlement Errors
| Error Code | Meaning | Fix |
|---|---|---|
MIDDAG-ENT-NOT_FOUND | Entitlement does not exist | Verify the entitlement code. Check if it was cancelled and purged |
MIDDAG-ENT-ALREADY_CANCELLED | Entitlement is already in cancelled state | No further cancellation needed. To reactivate, create a new entitlement |
MIDDAG-ENT-INVALID_TRANSITION | The requested status change is not allowed | Check the valid transitions: active, suspended, expired, cancelled. Not all paths exist |
MIDDAG-ENT-INVALID_CLASS | The entitlement class is not recognized | Use one of the six valid classes: Plugin, Environment, Service, Order, Affiliate, Education |
Quote Errors
| Error Code | Meaning | Fix |
|---|---|---|
MIDDAG-QUOTE-NOT_FOUND | Quote does not exist | Verify the quote ID or check if it was deleted |
MIDDAG-QUOTE-ALREADY_ACCEPTED | Quote was already accepted | A quote can only be accepted once. Create a new quote if terms changed |
MIDDAG-QUOTE-EXPIRED | Quote validity period has passed | Create a new quote with updated terms and expiry date |
MIDDAG-QUOTE-INVALID_TRANSITION | Status change not allowed | Quotes follow a defined lifecycle. Check valid transitions from current state |
License Errors
| Error Code | Meaning | Fix |
|---|---|---|
MIDDAG-LIC-NOT_FOUND | License does not exist | Verify the license key or ID |
MIDDAG-LIC-UNAVAILABLE | License system is temporarily unavailable | Retry after a few minutes. Check server logs for infrastructure issues |
MIDDAG-LIC-ACTIVATION_LIMIT | Maximum site activations reached | Deactivate an existing site or upgrade the license to increase the limit |
MIDDAG-LIC-DOMAIN_REQUIRED | Domain parameter missing from activation request | Include the site domain when activating a license |
MIDDAG-LIC-DOMAIN_NOT_ACTIVE | The specified domain is not currently activated | Activate the domain first, or check for typos in the domain name |
Authentication Errors
| Error Code | Meaning | Fix |
|---|---|---|
MIDDAG-AUTH-INVALID_CREDS | Email or password is incorrect | Verify credentials. Use the password reset flow if needed |
MIDDAG-AUTH-TOKEN_EXPIRED | JWT has expired | Request a new token. Default expiry is configurable in settings |
MIDDAG-AUTH-TOKEN_REVOKED | Token was revoked by a logout action | Authenticate again to obtain a fresh token |
MIDDAG-AUTH-EMAIL_UNVERIFIED | User's email address has not been verified | Check the inbox for the verification email. Resend from the admin panel |
MIDDAG-AUTH-ACCOUNT_DISABLED | User account has been disabled by an admin | Contact a site administrator to re-enable the account |
MIDDAG-AUTH-RATE_LIMITED | Too many authentication attempts | Wait before retrying. Default rate limit is 5 attempts per minute |
Service Errors
| Error Code | Meaning | Fix |
|---|---|---|
MIDDAG-SVC-NOT_FOUND | Service definition does not exist | Verify the service ID in the admin panel |
MIDDAG-SVC-INVALID_TRANSITION | Status change not allowed for this service | Check valid status transitions for the service type |
MIDDAG-SR-NOT_FOUND | Service request does not exist | Verify the service request ID |
MIDDAG-SR-INVALID_TRANSITION | Status change not allowed for this request | Check valid status transitions from the current state |
MIDDAG-SR-ENV_ONLY | Clients can only create SRs for ENV entitlements | Service requests from client portal are restricted to Environment class |
API Transport Errors
These are generic API-level errors, not specific to a domain:
| Code | HTTP | When It Happens |
|---|---|---|
VALIDATION_ERROR | 422 | One or more input fields are invalid |
AUTHENTICATION_ERROR | 401 | Missing, expired, or invalid token |
AUTHORIZATION_ERROR | 403 | Insufficient permissions |
NOT_FOUND | 404 | Resource does not exist |
CONFLICT | 409 | Conflicting state |
RATE_LIMIT | 429 | Rate limit exceeded |
INTERNAL_ERROR | 500 | Unexpected server error |
For full details on API error response structure, field-level validation errors, and client-side error handling examples, see the Error Messages reference.