Pre-release. HostCraft is in testing and not yet for sale. These docs describe the current build and may change. Join the waitlist to hear when it launches.

Audit API

Source: daemon/proto/hostcraft/v1/audit.proto

AuditService

AuditService reads the audit log. Callers without AuditReadAll see their own entries (resellers: their pool). REST: /api/v1/audit/events.

Method	REST route	Permission	Streaming
`ListAuditEvents`	`GET /api/v1/audit/events`	`AuditRead`	unary
`GetAuditEvent`	`GET /api/v1/audit/events/{id}`	`AuditRead`	unary

ListAuditEvents

/hostcraft.v1.AuditService/ListAuditEvents

Request: ListAuditEventsRequest
Response: ListAuditEventsResponse

GetAuditEvent

/hostcraft.v1.AuditService/GetAuditEvent

Request: GetAuditEventRequest
Response: AuditEntry

Messages

AuditEntry

Field	Type	Number	Description
`id`	`string`	1	-
`actor_user_id`	`string`	2	-
`actor_session_id`	`string`	3	-
`actor_ip`	`string`	4	-
`action`	`string`	5	-
`target_type`	`string`	6	-
`target_id`	`string`	7	-
`target_account_id`	`string`	8	-
`before_json`	`string`	9	-
`after_json`	`string`	10	-
`outcome`	`string`	11	success \| failure \| partial \| unspecified
`error`	`string`	12	-
`trace_id`	`string`	13	-
`at`	`google.protobuf.Timestamp`	14	-

AuditPage

Field	Type	Number	Description
`limit`	`int64`	1	-
`offset`	`int64`	2	-

GetAuditEventRequest

Field	Type	Number	Description
`id`	`string`	1	-

ListAuditEventsRequest

Field	Type	Number	Description
`action`	`string`	1	-
`target_type`	`string`	2	-
`target_id`	`string`	3	-
`actor_user_id`	`string`	4	-
`limit`	`int64`	5	default 100, max 1000
`offset`	`int64`	6	-
`since`	`string`	7	RFC 3339
`until`	`string`	8	RFC 3339

ListAuditEventsResponse

Field	Type	Number	Description
`entries`	`repeated AuditEntry`	1	-
`page`	`AuditPage`	2	-