Skip to content
Get Started

Authors

An author is one of your end users, identified by your own id. Infrared keeps a status, a trust level and a history per author, and content rules can read all three.

Endpoints

The author object

One of your end users in a project, with the status, trust level and history that content rules can read.

The author objectJSON
{
  "object": "author",
  "id": "aut_7ZRftUOZyMjsmFWvJifaOJ",
  "project_id": "prj_0TBAgHGtdMketrbltGFHuk",
  "external_id": "user_4821",
  "display_name": "Maya Okafor",
  "status": "enabled",
  "status_reason": "Appeal accepted",
  "status_until": null,
  "trust_level": "new",
  "trust_level_automatic": "new",
  "trust_override": null,
  "risk_score": 0.9,
  "stats": {
    "moderations": 5,
    "flagged": 5,
    "rejected": 5,
    "reviewed": 0,
    "reports": 0
  },
  "first_seen_at": "2026-10-08T08:50:58.962Z",
  "last_seen_at": "2026-10-08T09:28:46.195Z",
  "metadata": {
    "country": "GB",
    "email_verified": true
  },
  "created_at": "2026-10-08T08:50:59.118Z",
  "updated_at": "2026-10-08T09:28:46.195Z"
}

Attributes

object"author"

Always author.

idstring

Id of the author: aut_ plus 22 base62 characters. API paths use external_id instead.

external_idstring

Your id for the end user, up to 200 characters.

display_namestring or null

A name shown in the dashboard, or null.

statusenum

enabled, suspended or blocked. Content rules can test it.

One ofenabledsuspendedblocked

status_reasonstring or null

The reason given with the last status change, or null.

status_untiltimestamp or null

When a suspension ends, ISO 8601 in UTC. Null for a suspension without an end date and for the other statuses.

trust_levelenum

The effective trust level, from lowest to highest: new, basic, regular, established, trusted. It is trust_override when one is set, else the automatic level.

One ofnewbasicregularestablishedtrusted

trust_overrideenum or null

A trust level pinned by you, or null.

One ofnewbasicregularestablishedtrusted

risk_scorenumber or null

A number from 0 to 1 that grows with the share of flagged and rejected moderations and with a suspension or a block. Null until the author's first counted moderation or status change.

statsobject

Counters over the author's live moderations. Test key traffic, dry runs and invalid submissions are not counted.

moderationsinteger

Moderations counted.

flaggedinteger

Of those, the number that were flagged.

rejectedinteger

Of those, the number with the recommendation reject.

reviewedinteger

Of those, the number with the recommendation review.

reportsinteger

Reserved. Nothing writes this counter yet, so it is always 0.

first_seen_attimestamp or null

When the author was first seen: the first moderation, action or upsert that named them. ISO 8601 in UTC.

last_seen_attimestamp or null

When the author's last counted moderation finished, ISO 8601 in UTC. The creation time until then.

metadataobject

Your own data stored with the author. An empty object when none was set.

project_idstring

Id of the project: prj_ plus 22 base62 characters.

trust_level_automaticstring

The level computed from history after every counted moderation. Defaults: basic from 5 moderations with at most 10% rejected; regular from 20 moderations, at most 5% rejected and 7 days since first seen; established from 100, 2% and 30 days; trusted from 500, 1% and 90 days. A project can set its own values. new while the author is not enabled.

created_attimestamp

When the author was created, ISO 8601 in UTC.

updated_attimestamp

When the author last changed, ISO 8601 in UTC.

Something missing or unclear on this page? Write to support@useinfrared.com.