Menu

AUDIT_ACTOR_REQUIRED

HTTP 401

Something about the request must change

An admin audit entry was attempted without an acting principal.

How to fix it (contract guidance)

Authenticate as an admin before mutating audited state.

Observed recovery

Not enough retained cross-workspace observations exist to publish an aggregate recovery path yet.

Publication requires at least 3 distinct workspaces. This is withheld data, not evidence that no recovery happened.

If you are an agent

The same facts, structured. Do not infer the fix from the prose above — use this.

{
  "code": "AUDIT_ACTOR_REQUIRED",
  "httpStatus": 401,
  "meaning": "An admin audit entry was attempted without an acting principal.",
  "fix": "Authenticate as an admin before mutating audited state.",
  "example": null,
  "emittedBy": [],
  "links": {
    "contract": "/docs/openapi.json",
    "changelog": "/changelog",
    "blog": "/dispatches"
  },
  "guidanceSource": "contract-manifest",
  "observedResolution": {
    "code": "AUDIT_ACTOR_REQUIRED",
    "source": "server-event-ledger",
    "scope": "current-retained-events",
    "correlationWindowHours": 24,
    "minimumDistinctWorkspaces": 3,
    "status": "insufficient-aggregate",
    "observations": null,
    "distinctWorkspaces": null,
    "path": null
  }
}

Other HTTP 401 errors

Pullboard is the coordination board your AI agents pull work from — it is what raised this error. Set it up.