Korely Audit API
The Audit API from Korely — 1 operation(s) for audit.
The Audit API from Korely — 1 operation(s) for audit.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/korely-ai:korely-ai-audit-api"
curl "https://apis.io/api/v1/apis?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Korely Ai Audit API
version: 1.0.21
description: 'Operations tagged Audit across 2 of this provider''s published API definitions: korely-ai-agent-openapi.json, korely-ai-openapi.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.korely.ai
description: EU (Helsinki)
tags:
- name: Audit
paths:
/v1/audit:
get:
tags:
- Audit
summary: List Audit
description: 'The events this key''s project produced, newest first.
Scoped to the caller''s own account AND project by the key, like
everything else here; a key confined to some end users reads their
events only. The dashboard''s acts and reads in the project are among
them (`actor` `dashboard`), without the name the operator signs in
with. The operator''s screen (/admin/audit) reads one project or the
whole account, and that name.'
operationId: list_audit_v1_audit_get
security:
- HTTPBearer: []
parameters:
- name: user_id
in: query
required: false
schema:
anyOf:
- type: string
minLength: 1
maxLength: 255
- type: 'null'
description: Only events touching this end user.
title: User Id
description: Only events touching this end user.
- name: action
in: query
required: false
schema:
anyOf:
- type: string
minLength: 1
maxLength: 32
- type: 'null'
title: Action
- name: since
in: query
required: false
schema:
anyOf:
- type: string
maxLength: 64
- type: 'null'
description: ISO date (2026-06-01, midnight) or datetime; no offset is UTC. Inclusive.
title: Since
description: ISO date (2026-06-01, midnight) or datetime; no offset is UTC. Inclusive.
- name: until
in: query
required: false
schema:
anyOf:
- type: string
maxLength: 64
- type: 'null'
description: ISO date (2026-06-01, midnight) or datetime; no offset is UTC. Inclusive.
title: Until
description: ISO date (2026-06-01, midnight) or datetime; no offset is UTC. Inclusive.
- name: limit
in: query
required: false
schema:
type: integer
maximum: 1000
minimum: 1
default: 100
title: Limit
- name: offset
in: query
required: false
schema:
type: integer
maximum: 9223372036854775807
minimum: 0
default: 0
title: Offset
responses:
'200':
description: Successful Response
content:
application/json:
schema:
$ref: '#/components/schemas/AuditPage'
'401':
description: '`invalid_key`: the `Authorization: Bearer` key is missing, unknown, revoked or expired.'
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'403':
description: '`forbidden`: the key lacks the scope this operation needs; `message` names it.'
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'422':
description: '`invalid_request`: the body, a query parameter or a path parameter is malformed (`detail` lists the first 20 fields that failed, `message` names the first and counts them all), or the endpoint refuses a value (an empty content, an unreadable timestamp, a NUL byte or a lone UTF-16 surrogate anywhere in the request, a moment that cannot be stored, which is any but from 0001-01-02 to 9999-12-30, in UTC; `detail` is a sentence or `{code, message}`).'
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'429':
description: '`rate_limit_exceeded`: past the request ceiling, the per-minute one set on this install (`RATE_LIMIT_PER_MINUTE`) or, on the hosted service, the plan''s minute, hour or day; `message` names the window and `Retry-After` the seconds until it resets.'
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'500':
description: '`internal_error`: the server failed on this request; `message` holds no detail of it.'
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
'503':
description: 'A dependency did not answer: the database while the key was checked (`unavailable`, see `Retry-After`), or the one `code` names. Nothing was written; retry. Also `unavailable` when the request waited more than 5 s for another change to the same records (an erasure under way, for example) or its statement ran past 60 s; see `Retry-After`.'
content:
application/json:
schema:
$ref: '#/components/schemas/ApiError'
components:
schemas:
ErrorCode:
properties:
code:
type: string
title: Code
description: Stable, machine-readable reason, e.g. `not_found`, `stale_write`, `invalid_request`, `search_unavailable`. Branch on this, never on `message`.
examples:
- not_found
message:
type: string
title: Message
description: What went wrong, for a person to read. Wording may change.
type: object
required:
- code
- message
title: ErrorCode
description: A refusal with a stable reason.
AuditPage:
properties:
events:
items:
$ref: '#/components/schemas/AuditRow'
type: array
title: Events
total:
type: integer
title: Total
type: object
required:
- events
- total
title: AuditPage
AuditRead:
properties:
memories:
items:
type: string
type: array
title: Memories
description: Public ids of the memories the call returned, at most 100.
facts:
items:
type: string
type: array
title: Facts
description: Public ids of the facts the call returned, at most 100.
type: object
title: AuditRead
AuditRow:
properties:
ts:
type: string
format: date-time
title: Ts
actor:
type: string
title: Actor
description: 'Who acted: `rest`, a key over REST, or an admin key on /admin; `mcp`, a key over MCP; `dashboard`, an operator signed in to the dashboard; `manage`, the command line (`manage`); `worker`, the background worker; `oauth`, an app connected over OAuth: its key made, renewed or revoked; `install`, a change to what is the whole install''s, filed in every account''s trail.'
action:
type: string
title: Action
description: read | write | fact_write | fact_invalidate | erase | key_create | key_revoke | key_change | tenant_create | setting_change | login | logout
result:
type: string
title: Result
description: 'ok | error. `error`: the call was refused or could not be served, and `meta.code` says why with the token the call answered (`forbidden`, `not_found`, `quota_exceeded`, `search_unavailable`, ...), never a sentence.'
user_id:
anyOf:
- type: string
- type: 'null'
title: User Id
description: 'The end user the event touched. After their erasure, a keyed pseudonym (`erased:...`): ask with their id and it is found.'
target_id:
anyOf:
- type: string
- type: 'null'
title: Target Id
description: The memory or fact acted on, by public id.
meta:
anyOf:
- additionalProperties: true
type: object
- type: 'null'
title: Meta
description: Counts and labels, never content. A read says how many memories and facts it returned (memories_read, facts_read).
ip:
anyOf:
- type: string
- type: 'null'
title: Ip
read:
anyOf:
- $ref: '#/components/schemas/AuditRead'
- type: 'null'
description: 'For reads: what the call returned, by id. With as_of on /v1/facts it rebuilds what the agent knew at that moment.'
type: object
required:
- ts
- actor
- action
- result
title: AuditRow
ApiError:
properties:
detail:
anyOf:
- type: string
- $ref: '#/components/schemas/ErrorCode'
- items:
$ref: '#/components/schemas/ValidationIssue'
type: array
title: Detail
description: 'As this install has always sent it: a sentence; or `{code, message}` where the endpoint names the reason; or, on a 422 from validation, the list of fields that failed.'
code:
type: string
title: Code
description: 'Stable, machine-readable reason, the same names as the hosted API: `invalid_key`, `forbidden`, `not_found`, `stale_write`, `invalid_request`, `identity_required` (a write with neither user_id nor agent_id), `rate_limit_exceeded`, `search_unavailable`, `model_unavailable`, `service_paused`, `internal_error`... When `detail` is `{code, message}` it is that code. Branch on this, never on `message`.'
examples:
- not_found
message:
type: string
title: Message
description: 'What went wrong, for a person to read: the sentence, the message of `detail`, or the first field that failed validation. Wording may change.'
current_fact_id:
anyOf:
- type: string
- type: 'null'
title: Current Fact Id
description: '`fact_not_current`: the fact in force to correct instead, null when nothing took the fact''s place. Absent on every other refusal.'
type: object
required:
- detail
- code
- message
title: ApiError
description: The body of every answer that is not a success, whatever the status.
ValidationIssue:
properties:
type:
type: string
title: Type
description: What kind of failure, e.g. `missing`, `extra_forbidden`, `string_too_long`, `invalid_namespace_id`.
loc:
items:
anyOf:
- type: string
- type: integer
type: array
title: Loc
description: 'Where: `body`, `query` or `path`, then the field, e.g. ["body", "memories", 0, "user_id"].'
msg:
type: string
title: Msg
description: What is wrong with it, for a person to read.
ctx:
anyOf:
- additionalProperties: true
type: object
- type: 'null'
title: Ctx
description: The limit that was crossed, when there is one.
type: object
required:
- type
- loc
- msg
title: ValidationIssue
description: One field that failed validation. The value sent is never echoed back.
securitySchemes:
HTTPBearer:
type: http
scheme: bearer
bearerAuth:
type: http
scheme: bearer
description: Your kor_live_ API key.
x-refined-from:
- korely-ai-agent-openapi.json
- korely-ai-openapi.json