Errors
Every error the image API answers with, and what to do about it.
Errors are plain text (text/plain), so they read well in a browser tab.
| Status | Body | Cause | Fix |
|---|---|---|---|
400 |
Missing domain |
The path is empty (/ or /og/) |
Put a domain after the slash |
400 |
Invalid domain |
Not a domain with a dot, like localhost or my_site |
Use a public domain such as stripe.com |
401 |
Invalid token |
No token, or a key that doesn’t exist (or was deleted) |
Copy the key from the Keys page |
401 |
Origin not allowed |
The page’s host isn’t in the key’s allowed origins | Add the host on the Keys page, or leave the list empty |
404 |
Logo not found |
No image was found and fallback=404 (the default for /og/) |
Show your own placeholder, or use fallback=monogram for icons |
405 |
Method not allowed |
Anything but GET or HEAD |
Use GET |
Going over your plan’s monthly requests is not an error: images keep working.