Skip to content
SociaMesh

Errors

Every failure has a canonical code and says whether to retry.

{
  "error": {
    "code": "SM_VALIDATION_FAILED",
    "message": "The request is invalid.",
    "retryable": false,
    "requestId": "req_…",
    "details": [
      { "path": "platforms.0.platformSpecificData.boardId", "code": "required", "message": "…" }
    ]
  }
}

Include requestId when you contact support. Retry only when retryable is true, after Retry-After when it's present.

CodeHTTPMeaning
SM_AUTH_MISSING, SM_AUTH_INVALID401No key, or not a valid one.
SM_FORBIDDEN403The key lacks a scope, the IP isn't allowed, or a project policy forbids it.
SM_NOT_FOUND404Not in this project.
SM_VALIDATION_FAILED422The request is invalid; details says where.
SM_CONFLICT409The resource changed or is in the wrong state.
SM_IDEMPOTENCY_MISMATCH409The same key was used with a different request.
SM_RATE_LIMITED429Too many requests for this key.
SM_QUOTA_EXCEEDED429A plan limit was reached.
SM_INSUFFICIENT_CREDITS402Not enough credits for these posts.
SM_UNSUPPORTED_BY_PROVIDER422The platform's API doesn't offer this.
SM_REQUIRES_PROVIDER_APPROVAL422The platform requires an approval we don't have yet.
SM_ACCOUNT_REAUTH_REQUIRED422The account must be connected again.
SM_ACCOUNT_PERMISSION_MISSING422The user didn't grant a permission this needs.
SM_MEDIA_INVALID422A file the platform won't take.
SM_MEDIA_NOT_READY409Media still processing.
SM_MESSAGING_WINDOW_CLOSED422The platform's reply window for this conversation has passed.
SM_TEMPORARILY_UNAVAILABLE503Try again shortly.
SM_INTERNAL500Our failure.

Per-account publish results use these too, plus SM_PROVIDER_RATE_LIMITED, SM_PROVIDER_UNAVAILABLE, SM_PROVIDER_REJECTED, SM_PROVIDER_DUPLICATE and SM_OUTCOME_UNKNOWN (the platform didn't say; SociaMesh checks before any retry). The platform's own code is in providerCode.