---
title: Classify content (2026-08-05) | SafetyKit
description: Archived reference for POST /v1/content on API version 2026-08-05.
---

API version `2026-08-05`, superseded on 2026-08-11. This shape is served to accounts pinned to `2026-08-05` and to any request sending `SafetyKit-Version: 2026-08-05`. See [API versioning](/api-versioning/index.md) for how versions resolve, and the [current reference](/api/resources/content/methods/create/index.md) for the latest shape.

```
POST https://api.safetykit.com/v1/content
```

Classify a piece of content synchronously. Send user-authored text, images, or both, and receive per-policy results in the response. Requests have a maximum size of 6MB.

## Request

Authentication: `Authorization: Bearer <api key>`.

| Field        | Type                   | Description                                                                                                |
| ------------ | ---------------------- | ---------------------------------------------------------------------------------------------------------- |
| `user_id`    | string, required       | Your stable identifier for the user this content belongs to.                                               |
| `content_id` | string, optional       | Your content identifier. Echoed in the response.                                                           |
| `text`       | string, optional       | User-authored text to classify. At most 16,000 characters.                                                 |
| `images`     | string array, optional | Images to classify, each as base64-encoded image bytes, raw or as a data URI. At most 20 images, 5MB each. |
| `metadata`   | object, optional       | Additional product context. At most 8KB when serialized.                                                   |

At least one of `text` or `images` is required.

```
{
  "user_id": "user_123",
  "content_id": "post_42",
  "text": "Hey, is this still available?",
  "metadata": { "channel": "marketplace_dm" }
}
```

## Response

| Field                                | Type           | Description                                                                                                      |
| ------------------------------------ | -------------- | ---------------------------------------------------------------------------------------------------------------- |
| `content_id`                         | string         | SafetyKit identifier for the classified content.                                                                 |
| `user_id`                            | string         | The `user_id` from the request.                                                                                  |
| `policies`                           | array          | One result per policy evaluated for your account.                                                                |
| `policies[].policy_id`               | string         | Identifier of the policy.                                                                                        |
| `policies[].version`                 | string         | Version of the policy.                                                                                           |
| `policies[].score`                   | number or null | Classifier score between 0 and 1. Higher means more likely violating. Null when no classifier scored the policy. |
| `policies[].decision`                | string         | `match`, `not_match`, or `review`.                                                                               |
| `policies[].escalation`              | string         | `none`, `completed`, or `error`.                                                                                 |
| `reference_set_matches`              | array          | Reference set matches found for the submitted content.                                                           |
| `reference_set_matches[].set_id`     | string         | Identifier of the matched reference set.                                                                         |
| `reference_set_matches[].similarity` | number         | Similarity between the submitted content and the matched entry.                                                  |

```
{
  "content_id": "post_42",
  "user_id": "user_123",
  "policies": [
    {
      "policy_id": "phishing",
      "version": "v3",
      "score": 0.12,
      "decision": "not_match",
      "escalation": "none"
    }
  ],
  "reference_set_matches": []
}
```

## Errors

| Status | Meaning                                                                                     |
| ------ | ------------------------------------------------------------------------------------------- |
| 400    | Invalid body or images. The message names the failing field.                                |
| 401    | Missing or invalid API key.                                                                 |
| 413    | Request body exceeds 6MB.                                                                   |
| 503    | Classification temporarily unavailable. The request was not processed and is safe to retry. |