---
title: "Register media as it is created or uploaded"
method: POST
path: "/api/ingest/content"
tags: ["Content register"]
---

# Register media as it is created or uploaded

`POST /api/ingest/content`

## Request

- Base URL: `https://botnotice.app`
- URL: `https://botnotice.app/api/ingest/content`
- Auth: HTTP bearer

url may be a media file (fetched, its provenance read: Content Credentials, IPTC, generator metadata) or a page (every media file on it is inspected). force=true registers the file on the sender's word even when the file declares nothing, for files straight from a creation tool. Up to 20 urls per call.

## Request body

- object
  - `url` string
  - `urls` string[]: Up to 20
  - `page` string: The page the file appears on
  - `title` string
  - `media_type` 'image' | 'video' | 'audio'
  - `force` boolean
  - `tool` string: Midjourney, Sora, ElevenLabs…
  - `depicts_real` boolean: Shows people, places or events that could be taken as real
  - `is_ad` boolean

## Response `200`

OK

- object
  - `ok` boolean
  - `results` object[]
    - `url` string
    - `kind` 'media' | 'page' | 'error'
    - `verdict` 'declared' | 'likely' | 'none'
    - `registered` integer
    - `assets` integer
    - `error` string
    - `item` object
      - `id` string
      - `title` string
      - `labeled` boolean
      - `label_text` string

## Other responses

- `401`: Error
- `403`: The plan has no content register

---

[API](https://skmtc.dev/botnotice/apis/botnotice-api.md) · [All operations](https://skmtc.dev/botnotice/apis/botnotice-api/llms.txt) · [OpenAPI document](https://skmtc.dev/botnotice/apis/botnotice-api/revisions/33724fe6eab9?raw)