title: Workbench: audit evidence, operations and artifacts
Workbench: audit evidence, operations and artifacts
32 endpoints. Every path below is served by trilocore-backend behind the gateway at https://api.trilocore.ai.
GET /api/v1/workbench/artifacts/{artifact_id}
| Property |
Value |
| Authentication |
Authorization: Bearer (jns_ key or SSO session) |
| Idempotency-Key |
not required |
| Success |
200 |
| Upstream |
trilocore-backend |
GET /api/v1/workbench/artifacts/{artifact_id}/content
| Property |
Value |
| Authentication |
Authorization: Bearer (jns_ key or SSO session) |
| Idempotency-Key |
not required |
| Success |
200 |
| Upstream |
trilocore-backend |
Query parameters
| Parameter |
Type |
Required |
Constraints |
Description |
download |
boolean |
no |
— |
Prefer a short-lived signed URL |
GET /api/v1/workbench/audit-checkpoints
| Property |
Value |
| Authentication |
Authorization: Bearer (jns_ key or SSO session) |
| Idempotency-Key |
not required |
| Success |
200 |
| Upstream |
trilocore-backend |
| Pagination |
paged: page_size ≤ 200 (default 50) + page_token; the body is {data, has_more, next_page_token, page_size} |
Query parameters
| Parameter |
Type |
Required |
Constraints |
Description |
page_size |
integer |
no |
default 50, clamped to 200, minimum 1 |
Items per page. Default 50; values above 200 are clamped to 200 (never an error). The effective value is echoed as page_size. |
page_token |
string |
no |
maxLength 2048 |
Opaque token from a previous page's next_page_token. Valid for 3 days, only with the same filters and the same caller. Omit it to start from the first page. |
▶ Run this example in the sandbox
GET /api/v1/workbench/audit-destinations
| Property |
Value |
| Authentication |
Authorization: Bearer (jns_ key or SSO session) |
| Idempotency-Key |
not required |
| Success |
200 |
| Upstream |
trilocore-backend |
| Pagination |
paged: page_size ≤ 200 (default 50) + page_token; the body is {data, has_more, next_page_token, page_size} |
Query parameters
| Parameter |
Type |
Required |
Constraints |
Description |
page_size |
integer |
no |
default 50, clamped to 200, minimum 1 |
Items per page. Default 50; values above 200 are clamped to 200 (never an error). The effective value is echoed as page_size. |
page_token |
string |
no |
maxLength 2048 |
Opaque token from a previous page's next_page_token. Valid for 3 days, only with the same filters and the same caller. Omit it to start from the first page. |
▶ Run this example in the sandbox
POST /api/v1/workbench/audit-destinations
| Property |
Value |
| Authentication |
Authorization: Bearer (jns_ key or SSO session) |
| Idempotency-Key |
not required |
| Success |
201 |
| Upstream |
trilocore-backend |
Request body
DELETE /api/v1/workbench/audit-destinations/{dest_id}
| Property |
Value |
| Authentication |
Authorization: Bearer (jns_ key or SSO session) |
| Idempotency-Key |
not required |
| Success |
204 |
| Upstream |
trilocore-backend |
POST /api/v1/workbench/audit-destinations/{dest_id}:disable
| Property |
Value |
| Authentication |
Authorization: Bearer (jns_ key or SSO session) |
| Idempotency-Key |
not required |
| Success |
200 |
| Upstream |
trilocore-backend |
This operation takes no request body.
POST /api/v1/workbench/audit-destinations/{dest_id}:enable
| Property |
Value |
| Authentication |
Authorization: Bearer (jns_ key or SSO session) |
| Idempotency-Key |
not required |
| Success |
200 |
| Upstream |
trilocore-backend |
This operation takes no request body.
GET /api/v1/workbench/audit-events
| Property |
Value |
| Authentication |
Authorization: Bearer (jns_ key or SSO session) |
| Idempotency-Key |
not required |
| Success |
200 |
| Upstream |
trilocore-backend |
| Pagination |
paged: page_size ≤ 200 (default 50) + page_token; the body is {data, has_more, next_page_token, page_size} |
Query parameters
| Parameter |
Type |
Required |
Constraints |
Description |
action_prefix |
string |
no |
— |
Action prefix, e.g. composer. |
actor_id |
string |
no |
— |
Filter to one actor (admins only; a member is already self-scoped) |
event_type |
string |
no |
— |
Exact action, e.g. audit_view.updated |
from |
string |
no |
— |
ISO-8601 / epoch lower bound |
page_size |
integer |
no |
default 50, clamped to 200, minimum 1 |
Items per page. Default 50; values above 200 are clamped to 200 (never an error). The effective value is echoed as page_size. |
page_token |
string |
no |
maxLength 2048 |
Opaque token from a previous page's next_page_token. Valid for 3 days, only with the same filters and the same caller. Omit it to start from the first page. |
project_id |
string |
no |
— |
Filter to one project |
resource_id |
string |
no |
— |
— |
resource_type |
string |
no |
— |
— |
to |
string |
no |
— |
ISO-8601 / epoch upper bound |
▶ Run this example in the sandbox
GET /api/v1/workbench/audit-events/{event_id}
| Property |
Value |
| Authentication |
Authorization: Bearer (jns_ key or SSO session) |
| Idempotency-Key |
not required |
| Success |
200 |
| Upstream |
trilocore-backend |
GET /api/v1/workbench/audit-exports
| Property |
Value |
| Authentication |
Authorization: Bearer (jns_ key or SSO session) |
| Idempotency-Key |
not required |
| Success |
200 |
| Upstream |
trilocore-backend |
| Pagination |
paged: page_size ≤ 200 (default 50) + page_token; the body is {data, has_more, next_page_token, page_size} |
Query parameters
| Parameter |
Type |
Required |
Constraints |
Description |
page_size |
integer |
no |
default 50, clamped to 200, minimum 1 |
Items per page. Default 50; values above 200 are clamped to 200 (never an error). The effective value is echoed as page_size. |
page_token |
string |
no |
maxLength 2048 |
Opaque token from a previous page's next_page_token. Valid for 3 days, only with the same filters and the same caller. Omit it to start from the first page. |
▶ Run this example in the sandbox
POST /api/v1/workbench/audit-exports
| Property |
Value |
| Authentication |
Authorization: Bearer (jns_ key or SSO session) |
| Idempotency-Key |
not required |
| Success |
202 |
| Upstream |
trilocore-backend |
Request body
GET /api/v1/workbench/audit-exports/{export_id}
| Property |
Value |
| Authentication |
Authorization: Bearer (jns_ key or SSO session) |
| Idempotency-Key |
not required |
| Success |
200 |
| Upstream |
trilocore-backend |
GET /api/v1/workbench/audit-exports/{export_id}/content
| Property |
Value |
| Authentication |
Authorization: Bearer (jns_ key or SSO session) |
| Idempotency-Key |
not required |
| Success |
200 |
| Upstream |
trilocore-backend |
GET /api/v1/workbench/audit-legal-holds
| Property |
Value |
| Authentication |
Authorization: Bearer (jns_ key or SSO session) |
| Idempotency-Key |
not required |
| Success |
200 |
| Upstream |
trilocore-backend |
| Pagination |
paged: page_size ≤ 200 (default 50) + page_token; the body is {data, has_more, next_page_token, page_size} |
Query parameters
| Parameter |
Type |
Required |
Constraints |
Description |
active |
boolean |
no |
— |
Only active holds |
page_size |
integer |
no |
default 50, clamped to 200, minimum 1 |
Items per page. Default 50; values above 200 are clamped to 200 (never an error). The effective value is echoed as page_size. |
page_token |
string |
no |
maxLength 2048 |
Opaque token from a previous page's next_page_token. Valid for 3 days, only with the same filters and the same caller. Omit it to start from the first page. |
▶ Run this example in the sandbox
POST /api/v1/workbench/audit-legal-holds
| Property |
Value |
| Authentication |
Authorization: Bearer (jns_ key or SSO session) |
| Idempotency-Key |
not required |
| Success |
201 |
| Upstream |
trilocore-backend |
Request body
POST /api/v1/workbench/audit-legal-holds/{hold_id}:release
| Property |
Value |
| Authentication |
Authorization: Bearer (jns_ key or SSO session) |
| Idempotency-Key |
not required |
| Success |
200 |
| Upstream |
trilocore-backend |
This operation takes no request body.
GET /api/v1/workbench/audit-residency
| Property |
Value |
| Authentication |
Authorization: Bearer (jns_ key or SSO session) |
| Idempotency-Key |
not required |
| Success |
200 |
| Upstream |
trilocore-backend |
▶ Run this example in the sandbox
PUT /api/v1/workbench/audit-residency
| Property |
Value |
| Authentication |
Authorization: Bearer (jns_ key or SSO session) |
| Idempotency-Key |
not required |
| Success |
200 |
| Upstream |
trilocore-backend |
Request body
GET /api/v1/workbench/audit-retention-policy
| Property |
Value |
| Authentication |
Authorization: Bearer (jns_ key or SSO session) |
| Idempotency-Key |
not required |
| Success |
200 |
| Upstream |
trilocore-backend |
▶ Run this example in the sandbox
PUT /api/v1/workbench/audit-retention-policy
| Property |
Value |
| Authentication |
Authorization: Bearer (jns_ key or SSO session) |
| Idempotency-Key |
not required |
| Success |
200 |
| Upstream |
trilocore-backend |
Request body
GET /api/v1/workbench/audit-tombstones
| Property |
Value |
| Authentication |
Authorization: Bearer (jns_ key or SSO session) |
| Idempotency-Key |
not required |
| Success |
200 |
| Upstream |
trilocore-backend |
| Pagination |
paged: page_size ≤ 200 (default 50) + page_token; the body is {data, has_more, next_page_token, page_size} |
Query parameters
| Parameter |
Type |
Required |
Constraints |
Description |
page_size |
integer |
no |
default 50, clamped to 200, minimum 1 |
Items per page. Default 50; values above 200 are clamped to 200 (never an error). The effective value is echoed as page_size. |
page_token |
string |
no |
maxLength 2048 |
Opaque token from a previous page's next_page_token. Valid for 3 days, only with the same filters and the same caller. Omit it to start from the first page. |
▶ Run this example in the sandbox
DELETE /api/v1/workbench/audit-views/me
| Property |
Value |
| Authentication |
Authorization: Bearer (jns_ key or SSO session) |
| Idempotency-Key |
not required |
| Success |
200 |
| Upstream |
trilocore-backend |
Query parameters
| Parameter |
Type |
Required |
Constraints |
Description |
workspace_id |
string |
yes |
— |
— |
project_id |
string |
no |
— |
— |
GET /api/v1/workbench/audit-views/me
| Property |
Value |
| Authentication |
Authorization: Bearer (jns_ key or SSO session) |
| Idempotency-Key |
not required |
| Success |
200 |
| Upstream |
trilocore-backend |
Query parameters
| Parameter |
Type |
Required |
Constraints |
Description |
workspace_id |
string |
yes |
— |
Workspace the view belongs to |
project_id |
string |
no |
— |
Optional project within the workspace |
▶ Run this example in the sandbox
PATCH /api/v1/workbench/audit-views/me
| Property |
Value |
| Authentication |
Authorization: Bearer (jns_ key or SSO session) |
| Idempotency-Key |
not required |
| Success |
200 |
| Upstream |
trilocore-backend |
Query parameters
| Parameter |
Type |
Required |
Constraints |
Description |
workspace_id |
string |
yes |
— |
— |
project_id |
string |
no |
— |
— |
Request body
| Field |
Type |
Required |
Constraints |
composer |
— |
no |
— |
PUT /api/v1/workbench/audit-views/me
| Property |
Value |
| Authentication |
Authorization: Bearer (jns_ key or SSO session) |
| Idempotency-Key |
not required |
| Success |
200 |
| Upstream |
trilocore-backend |
Query parameters
| Parameter |
Type |
Required |
Constraints |
Description |
workspace_id |
string |
yes |
— |
— |
project_id |
string |
no |
— |
— |
Request body
| Field |
Type |
Required |
Constraints |
schema_version |
integer |
no |
minimum 1.0 |
view_state |
object |
no |
— |
▶ Run this example in the sandbox
GET /api/v1/workbench/operations
| Property |
Value |
| Authentication |
Authorization: Bearer (jns_ key or SSO session) |
| Idempotency-Key |
not required |
| Success |
200 |
| Upstream |
trilocore-backend |
| Pagination |
paged: page_size ≤ 200 (default 50) + page_token; the body is {data, has_more, next_page_token, page_size} |
Query parameters
| Parameter |
Type |
Required |
Constraints |
Description |
kind |
string |
no |
— |
— |
page_size |
integer |
no |
default 50, clamped to 200, minimum 1 |
Items per page. Default 50; values above 200 are clamped to 200 (never an error). The effective value is echoed as page_size. |
page_token |
string |
no |
maxLength 2048 |
Opaque token from a previous page's next_page_token. Valid for 3 days, only with the same filters and the same caller. Omit it to start from the first page. |
status |
string |
no |
— |
— |
▶ Run this example in the sandbox
GET /api/v1/workbench/operations/{op_id}
| Property |
Value |
| Authentication |
Authorization: Bearer (jns_ key or SSO session) |
| Idempotency-Key |
not required |
| Success |
200 |
| Upstream |
trilocore-backend |
GET /api/v1/workbench/operations/{op_id}/events
| Property |
Value |
| Authentication |
Authorization: Bearer (jns_ key or SSO session) |
| Idempotency-Key |
not required |
| Success |
200 |
| Upstream |
trilocore-backend |
| Pagination |
paged: page_size ≤ 200 (default 50) + page_token; the body is {data, has_more, next_page_token, page_size} |
Query parameters
| Parameter |
Type |
Required |
Constraints |
Description |
page_size |
integer |
no |
default 50, clamped to 200, minimum 1 |
Items per page. Default 50; values above 200 are clamped to 200 (never an error). The effective value is echoed as page_size. |
page_token |
string |
no |
maxLength 2048 |
Opaque token from a previous page's next_page_token. Valid for 3 days, only with the same filters and the same caller. Omit it to start from the first page. |
POST /api/v1/workbench/operations/{op_id}:cancel
| Property |
Value |
| Authentication |
Authorization: Bearer (jns_ key or SSO session) |
| Idempotency-Key |
not required |
| Success |
200 |
| Upstream |
trilocore-backend |
This operation takes no request body.
POST /api/v1/workbench/operations/{op_id}:pause
| Property |
Value |
| Authentication |
Authorization: Bearer (jns_ key or SSO session) |
| Idempotency-Key |
not required |
| Success |
200 |
| Upstream |
trilocore-backend |
This operation takes no request body.
POST /api/v1/workbench/operations/{op_id}:resume
| Property |
Value |
| Authentication |
Authorization: Bearer (jns_ key or SSO session) |
| Idempotency-Key |
not required |
| Success |
200 |
| Upstream |
trilocore-backend |
This operation takes no request body.