Errors
Errors
Every error the dlogify API returns, with its status and how to fix it.
Every error is an RFC 9457 problem with the content type application/problem+json. Its members:
| Member | Meaning |
|---|---|
type | The address of the page that explains the error, https://docs.dlogify.com/errors/<slug> |
title | A short, fixed summary of the type |
status | The HTTP status code |
detail | What went wrong in this request |
instance | The request ID; include it when you contact support |
Some types add members of their own, listed on their page. Switch on type in your code, not on title or detail, which can change.
| Type | Status | Meaning |
|---|---|---|
| unauthorized | 401 | The request has no valid credential, or the wrong kind for this endpoint. Send the right bearer token. |
| forbidden | 403 | Your credential is valid but your role does not allow this action. |
| csrf-origin-rejected | 403 | A change authenticated by the session cookie did not come from the dlogify web app. Scripts must use a bearer token. |
| plan-limit-reached | 403 | A limit of your organization's plan was reached; limit, max and used say which. |
| free-org-limit | 403 | You already created the maximum number of organizations on the free plan. |
| reauthentication-required | 403 | The action needs a session you signed in to in the last 15 minutes. Sign in again. |
| channel-type-not-allowed | 403 | Your plan does not include this channel type, usually webhooks. |
| not-found | 404 | The resource does not exist, or it belongs to an organization you are not part of. |
| conflict | 409 | The change conflicts with the current state of the resource. |
| sole-owner | 409 | You are the only owner of the listed organizations, so you cannot deactivate your account yet. |
| payload-too-large | 413 | The body or the batch is larger than allowed. Split it into smaller requests. |
| unsupported-media-type | 415 | The Content-Type is not accepted by this endpoint. |
| unsupported-encoding | 415 | The Content-Encoding is not accepted. Use gzip or none. |
| malformed-body | 400 | The body could not be parsed as JSON, gzip or OTLP. |
| validation-failed | 400, 422 | The request does not match the endpoint's schema. The detail names the field. |
| invalid-webhook-url | 422 | The webhook URL is not https or does not resolve to public addresses only. |
| rate-limited | 429 | A rate limit or quota was hit. Wait for Retry-After and send again. |
| channel-test-rate-limited | 429 | A channel can be tested once a minute. |
| client-error | 4xx | Another client error without a more specific type. |
| auth-error | 4xx | Another error from the authentication endpoints; code says which. |
| internal | 500 | Something failed on dlogify's side. The request is safe to retry. |
| notifier-unavailable | 503 | The notification service could not run a channel test. Try again later. |
| notifier-timeout | 504 | The notification service did not finish a channel test in time. |