Skip to main content

Push - MIME Type Validation

Endpoint​

/o/push/mime

Overview​

Validates a media URL for push attachments and returns resolved URL, MIME type, and media size.

Authentication​

Countly API supports three authentication methods:

  1. api_key=YOUR_API_KEY
  2. auth_token=YOUR_AUTH_TOKEN
  3. countly-token: YOUR_AUTH_TOKEN

Permissions​

Requires push Read permission.

Request Parameters​

ParameterTypeRequiredDescription
api_keyStringConditionalRequired if auth_token is not provided.
auth_tokenStringConditionalRequired if api_key is not provided.
app_idStringYesApp ID used by permission validation.
urlStringYesHTTP/HTTPS media URL to validate.

Response​

Success Response​

{
  "media": "https://cdn.example.com/assets/promo.png",
  "mediaMime": "image/png",
  "mediaSize": 2458624
}

Response Fields​

FieldTypeDescription
mediaStringFinal resolved URL used after redirects.
mediaMimeStringMIME type from response headers.
mediaSizeNumberContent length in bytes.

Error Responses​

  • 400
{
  "errors": [
    "url is required"
  ]
}
  • 400
{
  "errors": [
    "Invalid status 404"
  ]
}
  • 400
{
  "errors": [
    "No content-type while HEADing the url"
  ]
}
  • 400
{
  "errors": [
    "No content-length while HEADing the url"
  ]
}
  • 400
{
  "errors": [
    "Media mime type \"video/avi\" is not supported"
  ]
}
  • 400
{
  "errors": [
    "Media size (73400320) is too large"
  ]
}

Behavior/Processing​

  • Sends HEAD request first.
  • Follows single redirect hop explicitly when status is 301 or 302 and location exists.
  • Fails when final status is not 200.
  • Requires both content-type and content-length headers.
  • If HEAD has no content-length, retries with GET and checks length again.
  • Validates MIME type against allowed push media MIME list.
  • Validates size against push media max size limit (DEFAULTS.max_media_size).

Database Collections​

This endpoint does not read or write database collections.

Examples​

Validate attachment URL​

/o/push/mime?
  api_key=YOUR_API_KEY&
  app_id=6991c75b024cb89cdc04efd2&
  url=https://cdn.example.com/assets/promo.png

Last Updated​

2026-04-09