Skip to content

The company’s exports of its action log

GET
/v1/companies/{id}/audit-exports
curl --request GET \
--url https://beta-api.plune.ai/v1/companies/example/audit-exports \
--cookie plune_session=<plune_session>

The panel of the company’s export jobs: the last 7 days, newest first, each with its job and whether its file is ready to fetch, still pending, or expired. The owner and the managers of the company (ADR 0079 Р261 А), the session alone; the file holds the log of EVERY project of the company, the ones the caller is not a member of too. A company without Enterprise in active or grace is refused 403 enterprise_required.

id
required
string

The exports

Media type application/json
object
exports
required
Array<object>
object
id
required
string
format
required
string
Allowed values: jsonl csv
filename
required
string
query
required

The period and the filters it was asked with.

object
state
required
string
Allowed values: pending ready expired
rows
required
integer
nullable
size
required
integer
nullable
createdBy
required
string
createdAt
required
string format: date-time
expiresAt
required

The file is kept until then (a day after it is made).

string format: date-time
job
required
object
id
required
string format: uuid
kind
required

Which operation: ingest, sync, auto-analysis, and bin-empty — the Bin emptied by the server (#1388) — and runs-delete — runs deleted in the background (#1423) — today; open-ended.

string
>= 1 characters <= 64 characters
state
required
string
Allowed values: in_progress action_needed paused blocked completed failed cancelled
subjectId
required

What it works on — a run id, an import id.

string
nullable
subjectName
required

Its name as people know it — shown after the kind.

string
nullable <= 200 characters
progress
required

How far it got; null while the size is not known yet.

object
done
required
integer
total
required
integer
>= 1
reason
required

Why it stopped — only on action_needed, paused, blocked, failed, cancelled. A cancel reads «Cancelled by ».

string
nullable <= 2000 characters
cursor
required

The producer’s own token for where it resumes; null — a Retry starts from the beginning.

string
nullable <= 2000 characters
attempt
required

Which try this is: 1, and one more for each Retry. A producer sends it back in its reports (attempt), and a report of an earlier try is 409 stale_attempt.

integer
>= 1
createdAt
required
string format: date-time
startedAt
required
string format: date-time
nullable
finishedAt
required

Set on completed, failed and cancelled, and only there.

string format: date-time
nullable
runId

Only on a run-export job in GET /v1/jobs and in the answer of GET /v1/runs/{id}/export (202): the run the file is of, so «Export again» works from any browser. A completed export stays in the list 7 days (its file goes after 24 hours).

string
waitUntil

Only on a testrail-import or testrail-dry-run job in GET /v1/jobs while TestRail asked it to wait (its import is paused_rate_limit, #2269): when it goes on by itself. The job stays in_progress; no Resume is needed. Absent once that time has passed, while the step that goes on has not settled yet.

string format: date-time
updatedAt
required
string format: date-time
failure
required

Why the job failed, as a word (also the job’s reason): too_large - the file would be over 32 MiB; gone - its row was swept first; forbidden - the one who asked no longer runs the company’s people; failed - the build broke. null unless the job failed.

string
nullable
Allowed values: too_large gone forbidden failed
Example
{
"exports": [
{
"format": "jsonl",
"filename": "audit-log-2026-08-01-2026-10-30.jsonl",
"state": "pending",
"job": {
"state": "in_progress"
},
"failure": "too_large"
}
]
}

No session

Media type application/json
object
error
required
string
Example generated
{
"error": "example"
}

Not the owner or a manager, or no Enterprise

Media type application/json
object
error
required
string
Example generated
{
"error": "example"
}

A company the caller is not in

Media type application/json
object
error
required
string
Example generated
{
"error": "example"
}