Skip to content
Coritan Docs

Read the organization audit log

See who changed what in your organization, and when, from the dashboard, the staff console and the API.

View as Markdown

The audit log records the changes made in your organization: who made each one, what they changed, when, and from which IP address. Members, API keys, customers, your staff console, Coritan staff and the platform itself all write to it, newest entry first.

You need the owner or admin role to read the whole log. The Audit log page is not in the menu for other roles. In the staff console, support and billing roles can read parts of it, as described in The staff console's activity view.

  1. Go to Organizations, open your organization and choose Audit log under Team.
  2. Read the table. Each row shows When the change happened, Who made it, the Action, its Target, the first few Details and the IP address.
  3. To narrow the list, search the entries, choose who made the change (Anyone, a kind such as API keys, or one member by name), choose an area such as customers or services in place of Any area, or set the From and To dates. The filters and the page stay in the address, so a reload or a shared link shows the same entries.
  4. Select a row to open the full entry: When, Who, Action, Target, IP address, Entry ID and every detail it recorded. Choose Copy details to copy the details as JSON.
  5. Use the pages at the bottom to go back to older entries.

The search and the filters look through the whole log, not only the page on screen, and the count above the table is of every entry that matches. The search finds words in the action, the details, the target's kind and the IP address, a member by name or email, and a target by its number. Each area in the list shows how many entries it holds for the other filters, and only areas with entries are listed. The table shows 50 entries to a page. From and To count whole days in your browser's time zone, both included.

Who
Who made the change. A member shows by name, with In this console or In the staff console under it to say where they made it; your own changes show as You. Someone who has left shows by user number. API keys and customers show by their number, Coritan staff as Coritan staff, and the platform as System.
Action
What happened, in words such as Customer created, with its name in two parts under it: the area and the verb, such as customer.created or discord.config_updated. The colour shows whether it added, changed or removed something.
Target
The record the change applies to, such as a customer or a service, with its number.

The staff console's activity view

Section titled The staff console's activity view

Your staff console reads the same log through its Activity page, and each role sees a different part of it:

  • Owners and admins read all of it, and can filter by customer, service, server, member, action, date and text. On the Activity page they narrow it by area, period, record, action and person, and download the filtered log as a CSV.
  • Support tier 3 and billing members must name a customer, a service or a server, or ask for their own actions.
  • Support tiers 1 and 2 can only read their own actions.
  • Read-only members cannot open it.

The staff console describes the rest of the console.

You can see who made a change, when, from where, and exactly what they changed.

The Audit log is not in your menu
Only owners and admins can read the log, and its address takes anyone else to the overview. Ask one of them, or ask for your role to change.
A change you expected is missing
A filter may be leaving it out. Choose Reset filters, or clear the search, who and area, and widen the dates. A change made in the staff console shows under the member who made it, with In the staff console under their name.

The route needs an owner's or admin's access token, sent as Authorization: Bearer $CORITAN_TOKEN.

Shell
curl "https://api.coritan.com/api/v1/orgs/acme/audit-log?action=member&since=2026-09-01T00:00:00Z&with_total=true" \
  -H "Authorization: Bearer $CORITAN_TOKEN"

Every filter is applied before the page is cut:

Parameter What it matches
action One action, such as member.removed, or with no dot an area: every action whose first word it is, such as member. customers, coupons, setting and refund_request are read as the areas customer, coupon, settings and refund.
actor A member's user ID, for what they did in either console, or a kind: member, api_key, customer, system or admin (Coritan staff).
since and until Entries at or after since and before until, as ISO 8601 instants. One without an offset is UTC.
q Up to 100 characters of text in the action (with dots and underscores read as spaces), the details, the target's kind or the IP address; a member's name or email; or, for a number, the target's ID.
limit and offset limit takes 1–200 and defaults to 50; offset skips that many of the newest matching entries.

An action or an actor outside those words answers 422. Without with_total the answer is a list, newest first. With with_total=true it is {items, total, limit, offset, counts}: total is every matching entry, and counts holds how many entries each area has for the other filters, with all for every area, so the number beside an area is the total you get when you choose it. Each entry has:

Field Meaning
id The entry's ID.
actor_type user, staff, api_key, customer, admin, partner or system.
actor_id The ID of the actor within its kind, or null.
action The action name, such as customer.created.
resource_type and resource_id The record the change applies to.
details What changed, as a JSON object. Its fields depend on the action.
ip_address The IP address the change came from, when we know it.
created_at When it happened, in UTC.

To filter by a customer, a service or a server, use GET /api/v1/orgs/{org_slug}/staff/activity, which the staff console page covers.

API operations on this page

MethodPathWhat it does
GET/api/v1/orgs/{org_slug}/audit-logWho did what in the organization, newest first