audit

type CategoryAttributes struct {
	// Category The category value. Same as the JSON:API “id“.
	Category string `json:"category"`

	// CreatedAt First sighting of this category for the account.
	CreatedAt time.Time `json:"created_at"`
}

type CategoryListResponse struct {
	Data []CategoryResource `json:"data"`

	// Meta Top-level “meta“ block included on every JSON:API list response.
	Meta ListMeta `json:"meta"`
}

type CategoryResource struct {
	Attributes CategoryAttributes `json:"attributes"`

	// Id The category value.
	Id   string  `json:"id"`
	Type *string `json:"type,omitempty"`
}

type Client struct {
	// The endpoint of the server conforming to this interface, with scheme,
	// https://api.deepmap.com for example. This can contain a path relative
	// to the server, such as https://api.deepmap.com/dev-test, and all the
	// paths in the swagger spec will be appended to the server.
	Server string

	// Doer for performing requests, typically a *http.Client with any
	// customized settings, such as certificate chains.
	Client HttpRequestDoer

	// A list of callbacks for modifying requests which are generated before sending over
	// the network.
	RequestEditors []RequestEditorFn
}

type ClientInterface interface {
	// ListCategories request
	ListCategories(ctx context.Context, params *ListCategoriesParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// ListEventTypes request
	ListEventTypes(ctx context.Context, params *ListEventTypesParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// ListEvents request
	ListEvents(ctx context.Context, params *ListEventsParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// RecordEventWithBody request with any body
	RecordEventWithBody(ctx context.Context, params *RecordEventParams, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	RecordEventWithApplicationVndAPIPlusJSONBody(ctx context.Context, params *RecordEventParams, body RecordEventApplicationVndAPIPlusJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// SearchEventsWithBody request with any body
	SearchEventsWithBody(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	SearchEvents(ctx context.Context, body SearchEventsJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetEvent request
	GetEvent(ctx context.Context, eventId openapi_types.UUID, reqEditors ...RequestEditorFn) (*http.Response, error)

	// CreateExportWithBody request with any body
	CreateExportWithBody(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	CreateExportWithApplicationVndAPIPlusJSONBody(ctx context.Context, body CreateExportApplicationVndAPIPlusJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// DownloadExport request
	DownloadExport(ctx context.Context, token string, reqEditors ...RequestEditorFn) (*http.Response, error)

	// ListForwarderTypesApiV1ForwarderTypesGet request
	ListForwarderTypesApiV1ForwarderTypesGet(ctx context.Context, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetForwarderTypeApiV1ForwarderTypesIdGet request
	GetForwarderTypeApiV1ForwarderTypesIdGet(ctx context.Context, id string, reqEditors ...RequestEditorFn) (*http.Response, error)

	// ListForwarders request
	ListForwarders(ctx context.Context, params *ListForwardersParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// CreateForwarderWithBody request with any body
	CreateForwarderWithBody(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	CreateForwarderWithApplicationVndAPIPlusJSONBody(ctx context.Context, body CreateForwarderApplicationVndAPIPlusJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// DeleteForwarder request
	DeleteForwarder(ctx context.Context, forwarderId string, reqEditors ...RequestEditorFn) (*http.Response, error)

	// GetForwarder request
	GetForwarder(ctx context.Context, forwarderId string, reqEditors ...RequestEditorFn) (*http.Response, error)

	// UpdateForwarderWithBody request with any body
	UpdateForwarderWithBody(ctx context.Context, forwarderId string, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	UpdateForwarderWithApplicationVndAPIPlusJSONBody(ctx context.Context, forwarderId string, body UpdateForwarderApplicationVndAPIPlusJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// RetryFailedForwarderDeliveriesWithBody request with any body
	RetryFailedForwarderDeliveriesWithBody(ctx context.Context, forwarderId string, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	RetryFailedForwarderDeliveries(ctx context.Context, forwarderId string, body RetryFailedForwarderDeliveriesJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// ListForwarderDeliveries request
	ListForwarderDeliveries(ctx context.Context, forwarderId string, params *ListForwarderDeliveriesParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// RetryForwarderDelivery request
	RetryForwarderDelivery(ctx context.Context, forwarderId string, deliveryId openapi_types.UUID, reqEditors ...RequestEditorFn) (*http.Response, error)

	// ExecuteTestForwarderWithBody request with any body
	ExecuteTestForwarderWithBody(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*http.Response, error)

	ExecuteTestForwarder(ctx context.Context, body ExecuteTestForwarderJSONRequestBody, reqEditors ...RequestEditorFn) (*http.Response, error)

	// ListResourceTypes request
	ListResourceTypes(ctx context.Context, params *ListResourceTypesParams, reqEditors ...RequestEditorFn) (*http.Response, error)

	// ListUsage request
	ListUsage(ctx context.Context, params *ListUsageParams, reqEditors ...RequestEditorFn) (*http.Response, error)
}

type ClientOption func(*Client) error

type ClientWithResponses struct {
	ClientInterface
}

type ClientWithResponsesInterface interface {
	// ListCategoriesWithResponse request
	ListCategoriesWithResponse(ctx context.Context, params *ListCategoriesParams, reqEditors ...RequestEditorFn) (*ListCategoriesResponse, error)

	// ListEventTypesWithResponse request
	ListEventTypesWithResponse(ctx context.Context, params *ListEventTypesParams, reqEditors ...RequestEditorFn) (*ListEventTypesResponse, error)

	// ListEventsWithResponse request
	ListEventsWithResponse(ctx context.Context, params *ListEventsParams, reqEditors ...RequestEditorFn) (*ListEventsResponse, error)

	// RecordEventWithBodyWithResponse request with any body
	RecordEventWithBodyWithResponse(ctx context.Context, params *RecordEventParams, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*RecordEventResponse, error)

	RecordEventWithApplicationVndAPIPlusJSONBodyWithResponse(ctx context.Context, params *RecordEventParams, body RecordEventApplicationVndAPIPlusJSONRequestBody, reqEditors ...RequestEditorFn) (*RecordEventResponse, error)

	// SearchEventsWithBodyWithResponse request with any body
	SearchEventsWithBodyWithResponse(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*SearchEventsResponse, error)

	SearchEventsWithResponse(ctx context.Context, body SearchEventsJSONRequestBody, reqEditors ...RequestEditorFn) (*SearchEventsResponse, error)

	// GetEventWithResponse request
	GetEventWithResponse(ctx context.Context, eventId openapi_types.UUID, reqEditors ...RequestEditorFn) (*GetEventResponse, error)

	// CreateExportWithBodyWithResponse request with any body
	CreateExportWithBodyWithResponse(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*CreateExportResponse, error)

	CreateExportWithApplicationVndAPIPlusJSONBodyWithResponse(ctx context.Context, body CreateExportApplicationVndAPIPlusJSONRequestBody, reqEditors ...RequestEditorFn) (*CreateExportResponse, error)

	// DownloadExportWithResponse request
	DownloadExportWithResponse(ctx context.Context, token string, reqEditors ...RequestEditorFn) (*DownloadExportResponse, error)

	// ListForwarderTypesApiV1ForwarderTypesGetWithResponse request
	ListForwarderTypesApiV1ForwarderTypesGetWithResponse(ctx context.Context, reqEditors ...RequestEditorFn) (*ListForwarderTypesApiV1ForwarderTypesGetResponse, error)

	// GetForwarderTypeApiV1ForwarderTypesIdGetWithResponse request
	GetForwarderTypeApiV1ForwarderTypesIdGetWithResponse(ctx context.Context, id string, reqEditors ...RequestEditorFn) (*GetForwarderTypeApiV1ForwarderTypesIdGetResponse, error)

	// ListForwardersWithResponse request
	ListForwardersWithResponse(ctx context.Context, params *ListForwardersParams, reqEditors ...RequestEditorFn) (*ListForwardersResponse, error)

	// CreateForwarderWithBodyWithResponse request with any body
	CreateForwarderWithBodyWithResponse(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*CreateForwarderResponse, error)

	CreateForwarderWithApplicationVndAPIPlusJSONBodyWithResponse(ctx context.Context, body CreateForwarderApplicationVndAPIPlusJSONRequestBody, reqEditors ...RequestEditorFn) (*CreateForwarderResponse, error)

	// DeleteForwarderWithResponse request
	DeleteForwarderWithResponse(ctx context.Context, forwarderId string, reqEditors ...RequestEditorFn) (*DeleteForwarderResponse, error)

	// GetForwarderWithResponse request
	GetForwarderWithResponse(ctx context.Context, forwarderId string, reqEditors ...RequestEditorFn) (*GetForwarderResponse, error)

	// UpdateForwarderWithBodyWithResponse request with any body
	UpdateForwarderWithBodyWithResponse(ctx context.Context, forwarderId string, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*UpdateForwarderResponse, error)

	UpdateForwarderWithApplicationVndAPIPlusJSONBodyWithResponse(ctx context.Context, forwarderId string, body UpdateForwarderApplicationVndAPIPlusJSONRequestBody, reqEditors ...RequestEditorFn) (*UpdateForwarderResponse, error)

	// RetryFailedForwarderDeliveriesWithBodyWithResponse request with any body
	RetryFailedForwarderDeliveriesWithBodyWithResponse(ctx context.Context, forwarderId string, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*RetryFailedForwarderDeliveriesResponse, error)

	RetryFailedForwarderDeliveriesWithResponse(ctx context.Context, forwarderId string, body RetryFailedForwarderDeliveriesJSONRequestBody, reqEditors ...RequestEditorFn) (*RetryFailedForwarderDeliveriesResponse, error)

	// ListForwarderDeliveriesWithResponse request
	ListForwarderDeliveriesWithResponse(ctx context.Context, forwarderId string, params *ListForwarderDeliveriesParams, reqEditors ...RequestEditorFn) (*ListForwarderDeliveriesResponse, error)

	// RetryForwarderDeliveryWithResponse request
	RetryForwarderDeliveryWithResponse(ctx context.Context, forwarderId string, deliveryId openapi_types.UUID, reqEditors ...RequestEditorFn) (*RetryForwarderDeliveryResponse, error)

	// ExecuteTestForwarderWithBodyWithResponse request with any body
	ExecuteTestForwarderWithBodyWithResponse(ctx context.Context, contentType string, body io.Reader, reqEditors ...RequestEditorFn) (*ExecuteTestForwarderResponse, error)

	ExecuteTestForwarderWithResponse(ctx context.Context, body ExecuteTestForwarderJSONRequestBody, reqEditors ...RequestEditorFn) (*ExecuteTestForwarderResponse, error)

	// ListResourceTypesWithResponse request
	ListResourceTypesWithResponse(ctx context.Context, params *ListResourceTypesParams, reqEditors ...RequestEditorFn) (*ListResourceTypesResponse, error)

	// ListUsageWithResponse request
	ListUsageWithResponse(ctx context.Context, params *ListUsageParams, reqEditors ...RequestEditorFn) (*ListUsageResponse, error)
}

type CreateExportApplicationVndAPIPlusJSONRequestBody = ExportRequest

type CreateExportResponse struct {
	Body                     []byte
	HTTPResponse             *http.Response
	ApplicationvndApiJSON201 *ExportResponse
}

type CreateForwarderApplicationVndAPIPlusJSONRequestBody = ForwarderCreateRequest

type CreateForwarderResponse struct {
	Body                     []byte
	HTTPResponse             *http.Response
	ApplicationvndApiJSON201 *ForwarderResponse
}

type DeleteForwarderResponse struct {
	Body         []byte
	HTTPResponse *http.Response
}

type DownloadExportResponse struct {
	Body         []byte
	HTTPResponse *http.Response
}

type Event struct {
	// ActorId Identifier of the actor that caused the event. Free-form string — any identifier scheme is accepted.
	ActorId *string `json:"actor_id,omitempty"`

	// ActorLabel Human-readable label for the actor (e.g. an email address or API key name) at the time the event was recorded.
	ActorLabel *string `json:"actor_label,omitempty"`

	// ActorType Kind of actor that caused the event, e.g. `USER`, `API_KEY`, `SYSTEM`, or any other label you choose. Free-form string; the API does not constrain or interpret it.
	ActorType *string `json:"actor_type,omitempty"`

	// Category Free-form bucket label, e.g. `auth`, `billing`, `config-change`. Stored exactly as supplied. Drives the `filter[category]` filter and the `GET /api/v1/categories` discovery endpoint.
	Category *string `json:"category,omitempty"`

	// CreatedAt When the event was received and recorded.
	CreatedAt *time.Time `json:"created_at,omitempty"`

	// Data Free-form payload attached to the event. Use it for resource snapshots (by convention under `data.snapshot`), request identifiers, or any other context the event needs to carry.
	Data *map[string]interface{} `json:"data,omitempty"`

	// Description Free-text description of the event. Included alongside `resource_id` in the `filter[search]` substring target.
	Description *string `json:"description,omitempty"`

	// DoNotForward When `true`, the event is recorded but not delivered to any forwarder, and no delivery log entries are created for it.
	DoNotForward *bool `json:"do_not_forward,omitempty"`

	// Environment The environment the event occurred in. On write, optionally names the target environment: omit it and a single-environment credential implies it (a multi-environment credential must name it), and a named environment must be one the caller may access. Always present on read as the resolved environment. The same content recorded in two environments produces two distinct events.
	Environment *string `json:"environment,omitempty"`

	// EventType What happened, e.g. `user.created`. Any non-empty string.
	EventType string `json:"event_type"`

	// IdempotencyKey The idempotency key used to deduplicate the record. Echoes the `Idempotency-Key` header if one was supplied, otherwise a key derived from the event's content.
	IdempotencyKey *string `json:"idempotency_key,omitempty"`

	// OccurredAt When the event actually happened. Defaults to the server receipt time (`created_at`).
	OccurredAt *time.Time `json:"occurred_at,omitempty"`

	// ResourceId Identifier of the specific resource the event is about.
	ResourceId string `json:"resource_id"`

	// ResourceType Kind of resource the event is about, e.g. `user`. Any non-empty string.
	ResourceType string `json:"resource_type"`

	// Severity One of `TRACE`, `DEBUG`, `INFO`, `WARN`, `ERROR`, `FATAL`.
	Severity *Severity `json:"severity,omitempty"`
}

type EventListLinks struct {
	Next *string `json:"next,omitempty"`
}

type EventListMeta struct {
	PageSize int `json:"page_size"`
}

type EventListResponse struct {
	Data  []EventResource `json:"data"`
	Links *EventListLinks `json:"links,omitempty"`

	// Meta Cursor-pagination meta for the audit-event list endpoint.
	//
	// Audit events are append-only at high cardinality (millions of rows
	// per account at production tenants), so this endpoint stays on
	// cursor pagination — the documented exception in ADR-014. Every
	// other read-many endpoint in the platform follows the standard
	// offset convention (`page[number]` / `page[size]`).
	Meta EventListMeta `json:"meta"`
}

type EventRequest struct {
	// Data JSON:API resource envelope for an audit event.
	//
	// `id` must not be specified for create requests (the server assigns it).
	Data EventResource `json:"data"`
}

type EventResource struct {
	// Attributes An audit event — a record that something happened, attributed to
	// an actor and a resource.
	//
	// When recording a snapshot of the resource at the time of the event,
	// place it inside `data`. smplkit's own integrations nest it under
	// `data.snapshot`, but the slot is yours to use however you like.
	Attributes Event   `json:"attributes"`
	Id         *string `json:"id,omitempty"`
	Type       *string `json:"type,omitempty"`
}

type EventResponse struct {
	// Data JSON:API resource envelope for an audit event.
	//
	// `id` must not be specified for create requests (the server assigns it).
	Data EventResource `json:"data"`
}

type EventSearchListLinks struct {
	// Next Opaque cursor token for the next page. POST the same body with `page[after]` set to this value to fetch the next page. Unlike the URL-form `links.next` returned by `GET /api/v1/events`, this is a bare cursor token — the client must re-issue a POST with its body, which the URL form cannot capture.
	Next *string `json:"next,omitempty"`
}

type EventSearchListMeta struct {
	PageSize int `json:"page_size"`

	// Scan Scan statistics for a search response.
	//
	// Exposed so a selective JSON Logic filter doesn't silently look like
	// "0 matches" when the truth is "the scan ceiling was reached before
	// the filter had a chance to find page[size] matches."
	Scan EventSearchScanMeta `json:"scan"`
}

type EventSearchRequest struct {
	// Filter Optional JSON Logic expression evaluated against each row after column filters narrow the candidate set. Null, absent, or an empty object disables JSON Logic filtering. When present, the search is silently capped to the last 30 days by `occurred_at` (intersected with any explicit `filter[occurred_at]` the caller supplied).
	Filter *map[string]interface{} `json:"filter,omitempty"`

	// FilterActorId Exact match on the event's `actor_id` field.
	FilterActorId *string `json:"filter[actor_id],omitempty"`

	// FilterActorType Exact match on the event's `actor_type` field.
	FilterActorType *string `json:"filter[actor_type],omitempty"`

	// FilterCategory Exact match on the event's `category` field.
	FilterCategory *string `json:"filter[category],omitempty"`

	// FilterDoNotForward When set, restrict to events whose `do_not_forward` flag matches the given boolean. Forwarder previews typically pass `false` to match live-pipeline semantics (events flagged `do_not_forward=true` are skipped by the forwarder pipeline).
	FilterDoNotForward *bool `json:"filter[do_not_forward],omitempty"`

	// FilterEnvironment Comma-separated list of environment keys to scope results to (e.g. `production,staging`). When omitted, results cover every environment you can access. The reserved value `smplkit` selects platform change events smplkit records about your own resources; it is included by default when your plan grants change history, and requesting it explicitly without that entitlement returns 402.
	FilterEnvironment *string `json:"filter[environment],omitempty"`

	// FilterEventType Exact match on the event's `event_type` field.
	FilterEventType *string `json:"filter[event_type],omitempty"`

	// FilterOccurredAt Date range using interval notation, e.g. `[2026-04-01T00:00:00Z,2026-04-15T00:00:00Z)`. Required by `filter[search]` when the resource pair isn't provided. When a JSON Logic `filter` is present, the effective range is intersected with the last 30 days.
	FilterOccurredAt *string `json:"filter[occurred_at],omitempty"`

	// FilterResourceId Exact match on the event's `resource_id` field. Must be accompanied by `filter[resource_type]`.
	FilterResourceId *string `json:"filter[resource_id],omitempty"`

	// FilterResourceType Exact match on the event's `resource_type` field.
	FilterResourceType *string `json:"filter[resource_type],omitempty"`

	// FilterSearch Case-insensitive substring match on `resource_id` or `description`. Must be accompanied by either `filter[occurred_at]` or `filter[resource_type]` + `filter[resource_id]`.
	FilterSearch *string `json:"filter[search],omitempty"`

	// FilterSeverity Exact match on the event's `severity` field. One of `TRACE`, `DEBUG`, `INFO`, `WARN`, `ERROR`, `FATAL`.
	FilterSeverity *string `json:"filter[severity],omitempty"`

	// PageAfter Opaque cursor — pass the previous response's `links.next` cursor verbatim to fetch the next page. Keep the same `sort` value across paginated requests.
	PageAfter *string `json:"page[after],omitempty"`

	// PageSize Maximum events to return. Range 1..1000, default 1000 — matches every other list / search endpoint on the platform. Set explicitly to a smaller value when the consumer is rendering results card-by-card.
	PageSize *int `json:"page[size],omitempty"`

	// Sort Sort field: `occurred_at` or `created_at`, optionally prefixed with `-` for descending order. Default `-occurred_at` (newest first).
	Sort *string `json:"sort,omitempty"`
}

type EventSearchResponse struct {
	Data  []EventResource       `json:"data"`
	Links *EventSearchListLinks `json:"links,omitempty"`

	// Meta Cursor-pagination + scan meta for the search response.
	//
	// Mirrors `EventListMeta` (cursor pagination — `page_size` is the
	// only pagination field) and adds the `scan` block above.
	Meta EventSearchListMeta `json:"meta"`
}

type EventSearchScanMeta struct {
	// Exhausted `true` if the server hit the per-request scan ceiling before finding `page[size]` matches. When true, paginate again with the returned `links.next` cursor to continue scanning past the ceiling.
	Exhausted bool `json:"exhausted"`

	// Matched Rows the JSON Logic expression matched. Equal to `len(data)` for the page being returned plus any matches found beyond the page size.
	Matched int `json:"matched"`

	// Scanned Rows scanned after column filters narrowed the candidate set, before the JSON Logic expression was applied.
	Scanned int `json:"scanned"`
}

type EventTypeAttributes struct {
	// CreatedAt First sighting of this event_type for the account. When the request includes “filter[resource_type]“, this is the first sighting of the (event_type, resource_type) triple rather than the event_type overall.
	CreatedAt time.Time `json:"created_at"`

	// EventType The event_type slug. Same as the JSON:API “id“.
	EventType string `json:"event_type"`
}

type EventTypeListResponse struct {
	Data []EventTypeResource `json:"data"`

	// Meta Top-level “meta“ block included on every JSON:API list response.
	Meta ListMeta `json:"meta"`
}

type EventTypeResource struct {
	Attributes EventTypeAttributes `json:"attributes"`

	// Id The event_type slug.
	Id   string  `json:"id"`
	Type *string `json:"type,omitempty"`
}

type ExecuteTestForwarderJSONRequestBody = TestForwarderRequest

type ExecuteTestForwarderResponse struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON200      *TestForwarderResponse
}

type Export struct {
	// Environment The single environment the export is scoped to. Omit it and a single-environment credential implies it (a multi-environment credential must name it), and a named environment must be one the caller may access. An export always covers exactly one environment.
	Environment *string `json:"environment,omitempty"`

	// ExpiresAt When the signed URL stops being valid (ISO-8601 UTC). Open the URL well before this time — the signed token is stateless, so a single mint cannot be 'refreshed'; mint a new export if the URL has expired.
	ExpiresAt *time.Time `json:"expires_at,omitempty"`

	// FilterActorId Exact match on the event's `actor_id` field.
	FilterActorId *string `json:"filter[actor_id],omitempty"`

	// FilterActorType Exact match on the event's `actor_type` field.
	FilterActorType *string `json:"filter[actor_type],omitempty"`

	// FilterDoNotForward When set, restrict to events whose `do_not_forward` flag matches the given boolean.
	FilterDoNotForward *bool `json:"filter[do_not_forward],omitempty"`

	// FilterEventType Exact match on the event's `event_type` field.
	FilterEventType *string `json:"filter[event_type],omitempty"`

	// FilterOccurredAt Date range using interval notation, e.g. `[2026-04-01T00:00:00Z,2026-04-15T00:00:00Z)`.
	FilterOccurredAt *string `json:"filter[occurred_at],omitempty"`

	// FilterResourceId Exact match on the event's `resource_id` field. Must be accompanied by `filter[resource_type]`.
	FilterResourceId *string `json:"filter[resource_id],omitempty"`

	// FilterResourceType Exact match on the event's `resource_type` field.
	FilterResourceType *string `json:"filter[resource_type],omitempty"`

	// FilterSearch Case-insensitive substring match against `resource_id` or `description`. Must be accompanied by either `filter[occurred_at]` or `filter[resource_type]` + `filter[resource_id]`.
	FilterSearch *string `json:"filter[search],omitempty"`

	// Format Output format for the download. `CSV` writes one row per event with the event payload (`data`) serialized as a JSON-encoded cell. `JSONL` writes one JSON object per line with `data` preserved as a nested object.
	Format ExportFormat `json:"format"`

	// Url Absolute, signed download URL. Open in a browser to stream the export to disk. Expires shortly after mint — see `expires_at`.
	Url *string `json:"url,omitempty"`
}

type ExportFormat string

type ExportRequest struct {
	// Data JSON:API resource envelope for an export ticket.
	//
	// `id` must not be specified on create requests — the server assigns
	// a fresh UUID per mint response. The UUID identifies this particular
	// response envelope only; nothing is persisted behind it (the signed
	// token inside `attributes.url` is the actual artifact).
	Data ExportResource `json:"data"`
}

type ExportResource struct {
	// Attributes A request for a short-lived signed download URL.
	//
	// The customer chooses a `format` and supplies the same filter set
	// the events list endpoint accepts. The server mints an HMAC-signed
	// URL (valid for 30 seconds) that the browser navigates to for a
	// native streaming download — no `Authorization` header required at
	// download time.
	//
	// The download honors the **same filter-combination rules** as
	// `GET /api/v1/events`:
	//
	// - `filter[resource_id]` must be accompanied by `filter[resource_type]`.
	// - `filter[search]` must be accompanied by either `filter[occurred_at]`
	//   or `filter[resource_type]` + `filter[resource_id]`.
	//
	// A request that violates these rules is rejected at mint time with
	// `400 Bad Request`.
	Attributes Export  `json:"attributes"`
	Id         *string `json:"id,omitempty"`
	Type       *string `json:"type,omitempty"`
}

type ExportResponse struct {
	// Data JSON:API resource envelope for an export ticket.
	//
	// `id` must not be specified on create requests — the server assigns
	// a fresh UUID per mint response. The UUID identifies this particular
	// response envelope only; nothing is persisted behind it (the signed
	// token inside `attributes.url` is the actual artifact).
	Data ExportResource `json:"data"`
}

type Forwarder struct {
	// Configuration HTTP request configuration for delivering a payload to a destination.
	//
	// The shared base shape for any product that posts to a customer-supplied
	// HTTP destination. Smpl Audit forwarders use it directly; Smpl Jobs
	// extends it (adding “body“ and “timeout“). When other transports land
	// (“FTP“, “SQS“, …) their own configuration schemas will join this one
	// as members of a discriminated union under a “configuration“ field.
	Configuration HttpConfiguration `json:"configuration"`

	// CreatedAt When the forwarder was created.
	CreatedAt *time.Time `json:"created_at,omitempty"`

	// DeletedAt When the forwarder was deleted. `null` for active forwarders.
	DeletedAt *time.Time `json:"deleted_at,omitempty"`

	// Description Free-text description for the forwarder.
	Description *string `json:"description,omitempty"`

	// Enabled Always false. Enablement is per-environment: a forwarder delivers in an environment only when `environments[<env>].enabled` is true. The base value is pinned false and cannot be set.
	Enabled *bool `json:"enabled,omitempty"`

	// Environments Per-environment overrides keyed by environment key (e.g. `production`, `staging`). Each entry sets `enabled` (whether the forwarder delivers in that environment) and an optional `configuration` override (omit to inherit the base `configuration`). A forwarder with no entry for an environment is disabled there. Every referenced environment must exist and be managed for the account.
	Environments *map[string]ForwarderEnvironment `json:"environments,omitempty"`

	// Filter JSON Logic expression evaluated against each event. The event is delivered only if the expression returns truthy. Omit to deliver every event.
	Filter *map[string]interface{} `json:"filter,omitempty"`

	// ForwardSmplkitEvents When true, this forwarder also receives platform change events that smplkit records about your own resources (flag, configuration, and similar changes). Each such event is delivered through every environment this forwarder is enabled in, using that environment's resolved configuration. Defaults to false — platform change events are not forwarded unless you opt in. Independent of the per-environment `enabled` settings, since platform change events are not tied to a deployment environment.
	ForwardSmplkitEvents *bool `json:"forward_smplkit_events,omitempty"`

	// ForwarderType Supported forwarder destination types (ADR-050).
	ForwarderType ForwarderType `json:"forwarder_type"`

	// Name Human-readable name for the forwarder. Must contain at least one non-whitespace character.
	Name string `json:"name"`

	// Transform Template applied to each event before delivery. The shape depends on “transform_type“: for `JSONATA`, a string containing a JSONata expression. Omit to deliver the event JSON unchanged.
	Transform interface{} `json:"transform,omitempty"`

	// TransformType Engine used to evaluate “transform“. Must be set whenever “transform“ is set. Today only `JSONATA` is supported.
	TransformType *ForwarderTransformType `json:"transform_type,omitempty"`

	// UpdatedAt When the forwarder was last modified.
	UpdatedAt *time.Time `json:"updated_at,omitempty"`

	// Version Monotonic counter incremented on every update, starting at 1.
	Version *int `json:"version,omitempty"`
}

type ForwarderCreateRequest struct {
	// Data JSON:API resource envelope for creating a forwarder (id required).
	Data ForwarderCreateResource `json:"data"`
}

type ForwarderCreateResource struct {
	// Attributes A destination that receives audit events recorded for the account.
	//
	// Each event recorded for the account is evaluated against every enabled
	// forwarder. If the filter expression evaluates truthy — or is absent —
	// the event is shaped by the configured transform and delivered to the
	// destination defined by “configuration“.
	Attributes Forwarder `json:"attributes"`

	// Id Client-supplied resource id.
	Id   string                       `json:"id"`
	Type *ForwarderCreateResourceType `json:"type,omitempty"`
}

type ForwarderCreateResourceType string

type ForwarderDelivery struct {
	// AttemptNumber 1 for the initial delivery, incremented for each retry.
	AttemptNumber int `json:"attempt_number"`

	// CreatedAt When the delivery attempt was recorded.
	CreatedAt *time.Time `json:"created_at,omitempty"`

	// Environment Environment the delivered event occurred in. Deliveries are scoped to one environment.
	Environment string `json:"environment"`

	// Error Error message if the delivery did not complete.
	Error *string `json:"error,omitempty"`

	// Event Event that was being delivered.
	Event openapi_types.UUID `json:"event"`

	// Forwarder Forwarder the delivery belongs to.
	Forwarder openapi_types.UUID `json:"forwarder"`

	// LatencyMs Elapsed time of the delivery attempt in milliseconds.
	LatencyMs *int `json:"latency_ms,omitempty"`

	// Request The HTTP request as it was sent to the destination. Header values are redacted.
	Request *map[string]interface{} `json:"request,omitempty"`

	// ResponseBody Response body returned by the destination.
	ResponseBody *string `json:"response_body,omitempty"`

	// ResponseStatus HTTP status code returned by the destination.
	ResponseStatus *int `json:"response_status,omitempty"`

	// Status Delivery outcome. `SUCCEEDED` when the destination accepted the event, `FAILED` when the delivery attempt did not succeed. Events that a forwarder's filter rejected are not recorded as deliveries.
	Status ForwarderDeliveryStatus `json:"status"`
}

type ForwarderDeliveryListLinks struct {
	Next *string `json:"next,omitempty"`
}

type ForwarderDeliveryListMeta struct {
	PageSize int `json:"page_size"`
}

type ForwarderDeliveryListResponse struct {
	Data  []ForwarderDeliveryResource `json:"data"`
	Links *ForwarderDeliveryListLinks `json:"links,omitempty"`

	// Meta Cursor-pagination meta for the forwarder-delivery log endpoint.
	//
	// Forwarder deliveries are append-only at high cardinality (one row per
	// delivery attempt per event) and scroll with the same workload as
	// audit events, so this endpoint stays on cursor pagination — the
	// documented exception in ADR-014. The parent `/forwarders` collection
	// follows the standard offset convention.
	Meta ForwarderDeliveryListMeta `json:"meta"`
}

type ForwarderDeliveryResource struct {
	// Attributes A log entry for one attempt to deliver an event to a forwarder.
	Attributes ForwarderDelivery `json:"attributes"`
	Id         string            `json:"id"`
	Type       *string           `json:"type,omitempty"`
}

type ForwarderDeliveryResponse struct {
	// Data JSON:API resource envelope for a forwarder delivery log entry.
	Data ForwarderDeliveryResource `json:"data"`
}

type ForwarderDeliveryStatus string

type ForwarderEnvironment struct {
	// Configuration HTTP request configuration for delivering a payload to a destination.
	//
	// The shared base shape for any product that posts to a customer-supplied
	// HTTP destination. Smpl Audit forwarders use it directly; Smpl Jobs
	// extends it (adding “body“ and “timeout“). When other transports land
	// (“FTP“, “SQS“, …) their own configuration schemas will join this one
	// as members of a discriminated union under a “configuration“ field.
	Configuration *HttpConfiguration `json:"configuration,omitempty"`

	// Enabled Whether the forwarder delivers events in this environment. A forwarder is enabled in an environment only via this field — the base `enabled` is always false.
	Enabled *bool `json:"enabled,omitempty"`
}

type ForwarderListResponse struct {
	Data []ForwarderResource `json:"data"`

	// Meta Top-level “meta“ block included on every JSON:API list response.
	Meta ListMeta `json:"meta"`
}

type ForwarderRequest struct {
	// Data JSON:API resource envelope for a forwarder.
	//
	// The caller supplies `id` (the forwarder's key) on create.
	Data ForwarderResource `json:"data"`
}

type ForwarderResource struct {
	// Attributes A destination that receives audit events recorded for the account.
	//
	// Each event recorded for the account is evaluated against every enabled
	// forwarder. If the filter expression evaluates truthy — or is absent —
	// the event is shaped by the configured transform and delivered to the
	// destination defined by “configuration“.
	Attributes Forwarder `json:"attributes"`
	Id         *string   `json:"id,omitempty"`
	Type       *string   `json:"type,omitempty"`
}

type ForwarderResponse struct {
	// Data JSON:API resource envelope for a forwarder.
	//
	// The caller supplies `id` (the forwarder's key) on create.
	Data ForwarderResource `json:"data"`
}

type ForwarderTransformType string

type ForwarderType string

type ForwarderTypeAttributes struct {
	// BaseType Transport family — today only `HTTP`. New base types will add their own configuration shape and runtime handler.
	BaseType string `json:"base_type"`

	// Configuration HTTP-base-type delivery template.
	Configuration ForwarderTypeHttpConfiguration `json:"configuration"`

	// DocsUrl Link to the vendor's own documentation for this destination.
	DocsUrl *string `json:"docs_url,omitempty"`

	// Icon Absolute URL to the icon asset, served by audit at `/api/v1/forwarder_types/{id}/icon`.
	Icon string `json:"icon"`

	// IsCustom True for the synthetic `http` Custom HTTP entry, which has no vendor template — the customer supplies URL, headers, and transform from scratch. False for branded types.
	IsCustom bool `json:"is_custom"`

	// Name Human-readable label shown in the type-picker.
	Name string `json:"name"`

	// Placeholders UI metadata keyed by placeholder name. Each `{name}` token appearing in `configuration` (URL, header value) has a matching entry here describing how to prompt for it.
	Placeholders map[string]ForwarderTypePlaceholder `json:"placeholders"`

	// Transform Default transform shipped with the type.
	Transform *ForwarderTypeTransform `json:"transform,omitempty"`
}

type ForwarderTypeHeader struct {
	// Name Header name.
	Name string `json:"name"`

	// Value Header value template. Strings of the form `{name}` are placeholders the customer fills in; look up `name` in `placeholders` for the UI metadata.
	Value string `json:"value"`
}

type ForwarderTypeHttpConfiguration struct {
	// Headers Headers attached to each delivery request.
	Headers []ForwarderTypeHeader `json:"headers"`

	// Method HTTP method.
	Method string `json:"method"`

	// SuccessStatus HTTP response status indicating a successful delivery — either a specific code (`200`, `204`) or a class (`2xx`).
	SuccessStatus string `json:"success_status"`

	// Url URL template. `null` for the synthetic `http` (Custom HTTP) entry, where the customer supplies the URL from scratch. May contain `{name}` placeholders that map to the `placeholders` block.
	Url *string `json:"url"`
}

type ForwarderTypeListResponse struct {
	Data []ForwarderTypeResource `json:"data"`

	// Meta Top-level “meta“ block included on every JSON:API list response.
	Meta ListMeta `json:"meta"`
}

type ForwarderTypePlaceholder struct {
	// Default Pre-selected value when `enum` is set, or the default for a free-text field.
	Default *string `json:"default,omitempty"`

	// Enum If set, the value must be one of the listed strings — render as a dropdown.
	Enum *[]string `json:"enum,omitempty"`

	// Label Human-readable label for the input.
	Label string `json:"label"`

	// Placeholder HTML-input hint text shown when the field is empty.
	Placeholder *string `json:"placeholder,omitempty"`

	// Secret If true, mask the value in the UI and treat as a credential.
	Secret *bool `json:"secret,omitempty"`
}

type ForwarderTypeResource struct {
	// Attributes The catalog entry's attributes — one branded forwarder type or the
	// synthetic Custom HTTP entry.
	Attributes ForwarderTypeAttributes `json:"attributes"`

	// Id Lowercase forwarder type id — matches `forwarder.forwarder_type` values and is the filename stem of `forwarder_types/<id>.yaml`.
	Id   string  `json:"id"`
	Type *string `json:"type,omitempty"`
}

type ForwarderTypeResponse struct {
	// Data JSON:API resource envelope for a forwarder type.
	Data ForwarderTypeResource `json:"data"`
}

type ForwarderTypeTransform struct {
	// Default Default template; customers can override per forwarder.
	Default string `json:"default"`

	// Type Engine name. Today only `JSONATA`.
	Type string `json:"type"`
}

type GetEventResponse struct {
	Body                     []byte
	HTTPResponse             *http.Response
	ApplicationvndApiJSON200 *EventResponse
}

type GetForwarderResponse struct {
	Body                     []byte
	HTTPResponse             *http.Response
	ApplicationvndApiJSON200 *ForwarderResponse
}

type GetForwarderTypeApiV1ForwarderTypesIdGetResponse struct {
	Body                     []byte
	HTTPResponse             *http.Response
	ApplicationvndApiJSON200 *ForwarderTypeResponse
}

type HttpConfiguration struct {
	// CaCert Optional PEM-encoded certificate (or bundle) used to verify the destination server's TLS certificate, in addition to the system trust store. Use this to pin a private or self-signed CA (e.g. Splunk's default `SplunkCommonCA`) without disabling verification entirely via `tls_verify`. Must contain one or more `-----BEGIN CERTIFICATE-----` blocks. Ignored when `tls_verify` is `false`.
	CaCert *string `json:"ca_cert,omitempty"`

	// Headers HTTP headers attached to each request.
	Headers *[]HttpHeader `json:"headers,omitempty"`

	// Method HTTP method used when delivering the request.
	Method *HttpConfigurationMethod `json:"method,omitempty"`

	// SuccessStatus HTTP response status that indicates success. Either a specific status code (e.g. `200`, `204`) or a status class (`1xx`, `2xx`, `3xx`, `4xx`, `5xx`).
	SuccessStatus *string `json:"success_status,omitempty"`

	// TlsVerify Whether to verify the destination server's TLS certificate against trusted certificate authorities. Defaults to `true` and should be left on for any production destination. Set to `false` only for development or short-lived testing against a destination that presents an untrusted certificate (e.g. a Splunk Cloud trial stack on `:8088` serving its default self-signed certificate). When `false`, deliveries proceed without certificate verification — they are vulnerable to man-in-the-middle attacks. For long-lived self-signed setups, pin the issuing CA via `ca_cert` instead of disabling verification entirely.
	TlsVerify *bool `json:"tls_verify,omitempty"`

	// Url Destination URL. Must be an absolute `http://` or `https://` URL with a hostname (e.g. `https://siem.example.com/in`).
	Url string `json:"url"`
}

type HttpConfigurationMethod string

type HttpHeader struct {
	// Name Header name.
	Name string `json:"name"`

	// Value Header value. Stored encrypted at rest; returned as plaintext on `GET`.
	Value string `json:"value"`
}

type HttpRequestDoer interface {
	Do(req *http.Request) (*http.Response, error)
}

type ListCategoriesParams struct {
	// FilterEnvironment Comma-separated list of environment keys to scope results to (e.g. `production,staging`). When omitted, results cover every environment you can access. The reserved value `smplkit` selects platform change events smplkit records about your own resources; it is included by default when your plan grants change history, and requesting it explicitly without that entitlement returns 402.
	FilterEnvironment *string `form:"filter[environment],omitempty" json:"filter[environment],omitempty"`

	// Sort Field to sort by. Prefix with `-` for descending order. Default: `key`. Allowed values: `key`, `-key`.
	Sort *ListCategoriesParamsSort `form:"sort,omitempty" json:"sort,omitempty"`

	// PageNumber 1-based page number to return. Optional; defaults to `1` when omitted. Must be `>= 1` — requests with a smaller value are rejected with a 400 error.
	PageNumber *int `form:"page[number],omitempty" json:"page[number],omitempty"`

	// PageSize Number of items per page. Optional; defaults to `1000` when omitted. Must be between `1` and `1000` inclusive — requests outside that range are rejected with a 400 error.
	PageSize *int `form:"page[size],omitempty" json:"page[size],omitempty"`

	// MetaTotal When `true`, the response's `meta.pagination` block includes `total` (the total number of matching items across all pages) and `total_pages`. Computing these requires an extra `COUNT` query, so omit (or pass `false`) when the totals are not needed. Defaults to `false`.
	MetaTotal *bool `form:"meta[total],omitempty" json:"meta[total],omitempty"`
}

type ListCategoriesParamsSort string

type ListCategoriesResponse struct {
	Body                     []byte
	HTTPResponse             *http.Response
	ApplicationvndApiJSON200 *CategoryListResponse
}

type ListEventTypesParams struct {
	// FilterEnvironment Comma-separated list of environment keys to scope results to (e.g. `production,staging`). When omitted, results cover every environment you can access. The reserved value `smplkit` selects platform change events smplkit records about your own resources; it is included by default when your plan grants change history, and requesting it explicitly without that entitlement returns 402.
	FilterEnvironment  *string `form:"filter[environment],omitempty" json:"filter[environment],omitempty"`
	FilterResourceType *string `form:"filter[resource_type],omitempty" json:"filter[resource_type],omitempty"`

	// Sort Field to sort by. Prefix with `-` for descending order. Default: `key`. Allowed values: `key`, `-key`.
	Sort *ListEventTypesParamsSort `form:"sort,omitempty" json:"sort,omitempty"`

	// PageNumber 1-based page number to return. Optional; defaults to `1` when omitted. Must be `>= 1` — requests with a smaller value are rejected with a 400 error.
	PageNumber *int `form:"page[number],omitempty" json:"page[number],omitempty"`

	// PageSize Number of items per page. Optional; defaults to `1000` when omitted. Must be between `1` and `1000` inclusive — requests outside that range are rejected with a 400 error.
	PageSize *int `form:"page[size],omitempty" json:"page[size],omitempty"`

	// MetaTotal When `true`, the response's `meta.pagination` block includes `total` (the total number of matching items across all pages) and `total_pages`. Computing these requires an extra `COUNT` query, so omit (or pass `false`) when the totals are not needed. Defaults to `false`.
	MetaTotal *bool `form:"meta[total],omitempty" json:"meta[total],omitempty"`
}

type ListEventTypesParamsSort string

type ListEventTypesResponse struct {
	Body                     []byte
	HTTPResponse             *http.Response
	ApplicationvndApiJSON200 *EventTypeListResponse
}

type ListEventsParams struct {
	// FilterEnvironment Comma-separated list of environment keys to scope results to (e.g. `production,staging`). When omitted, results cover every environment you can access. The reserved value `smplkit` selects platform change events smplkit records about your own resources; it is included by default when your plan grants change history, and requesting it explicitly without that entitlement returns 402.
	FilterEnvironment  *string `form:"filter[environment],omitempty" json:"filter[environment],omitempty"`
	FilterOccurredAt   *string `form:"filter[occurred_at],omitempty" json:"filter[occurred_at],omitempty"`
	FilterActorType    *string `form:"filter[actor_type],omitempty" json:"filter[actor_type],omitempty"`
	FilterActorId      *string `form:"filter[actor_id],omitempty" json:"filter[actor_id],omitempty"`
	FilterEventType    *string `form:"filter[event_type],omitempty" json:"filter[event_type],omitempty"`
	FilterResourceType *string `form:"filter[resource_type],omitempty" json:"filter[resource_type],omitempty"`
	FilterResourceId   *string `form:"filter[resource_id],omitempty" json:"filter[resource_id],omitempty"`

	// FilterSeverity Exact match on the event's `severity` field. One of `TRACE`, `DEBUG`, `INFO`, `WARN`, `ERROR`, `FATAL`.
	FilterSeverity *string `form:"filter[severity],omitempty" json:"filter[severity],omitempty"`

	// FilterCategory Exact match on the event's `category` field.
	FilterCategory *string `form:"filter[category],omitempty" json:"filter[category],omitempty"`

	// FilterSearch Case-insensitive substring match against `resource_id` or `description`. Use `filter[resource_id]` for an exact match on `resource_id`.
	FilterSearch *string `form:"filter[search],omitempty" json:"filter[search],omitempty"`

	// FilterDoNotForward When set, restrict to events whose `do_not_forward` flag matches the given boolean. Forwarder previews typically pass `false` to match live-pipeline semantics (events flagged `do_not_forward=true` are skipped by the forwarder pipeline).
	FilterDoNotForward *bool   `form:"filter[do_not_forward],omitempty" json:"filter[do_not_forward],omitempty"`
	PageSize           *int    `form:"page[size],omitempty" json:"page[size],omitempty"`
	PageAfter          *string `form:"page[after],omitempty" json:"page[after],omitempty"`

	// Format When set, stream a download of the full filtered result set in the chosen format instead of returning a paginated JSON:API response. `page[size]` and `page[after]` are ignored in this mode; every event matching the supplied filters is emitted. `CSV` writes one row per event with the event payload (`data`) serialized as a single JSON-encoded cell. `JSONL` writes one JSON object per line with the event payload nested as a JSON object. Omit this parameter to receive the paginated JSON:API response.
	Format *ListEventsParamsFormat `form:"format,omitempty" json:"format,omitempty"`

	// Sort Field to sort by. Prefix with `-` for descending order. Default: `-occurred_at`. Allowed values: `created_at`, `-created_at`, `occurred_at`, `-occurred_at`.
	Sort *ListEventsParamsSort `form:"sort,omitempty" json:"sort,omitempty"`
}

type ListEventsParamsFormat string

type ListEventsParamsSort string

type ListEventsResponse struct {
	Body                     []byte
	HTTPResponse             *http.Response
	ApplicationvndApiJSON200 *EventListResponse
}

type ListForwarderDeliveriesParams struct {
	// FilterEnvironment Comma-separated list of environment keys to scope deliveries to (e.g. `production,staging`). When omitted, results cover every environment you can access. The reserved value `smplkit` selects deliveries of platform change events smplkit records about your own resources; it is included by default when your plan grants change history, and requesting it explicitly without that entitlement returns 402.
	FilterEnvironment *string `form:"filter[environment],omitempty" json:"filter[environment],omitempty"`
	FilterStatus      *string `form:"filter[status],omitempty" json:"filter[status],omitempty"`
	FilterCreatedAt   *string `form:"filter[created_at],omitempty" json:"filter[created_at],omitempty"`
	FilterEvent       *string `form:"filter[event],omitempty" json:"filter[event],omitempty"`
	PageSize          *int    `form:"page[size],omitempty" json:"page[size],omitempty"`
	PageAfter         *string `form:"page[after],omitempty" json:"page[after],omitempty"`

	// Sort Field to sort by. Prefix with `-` for descending order. Default: `-created_at`. Allowed values: `created_at`, `-created_at`.
	Sort *ListForwarderDeliveriesParamsSort `form:"sort,omitempty" json:"sort,omitempty"`
}

type ListForwarderDeliveriesParamsSort string

type ListForwarderDeliveriesResponse struct {
	Body                     []byte
	HTTPResponse             *http.Response
	ApplicationvndApiJSON200 *ForwarderDeliveryListResponse
}

type ListForwarderTypesApiV1ForwarderTypesGetResponse struct {
	Body                     []byte
	HTTPResponse             *http.Response
	ApplicationvndApiJSON200 *ForwarderTypeListResponse
}

type ListForwardersParams struct {
	FilterForwarderType *string `form:"filter[forwarder_type],omitempty" json:"filter[forwarder_type],omitempty"`

	// Sort Field to sort by. Prefix with `-` for descending order. Default: `-created_at`. Allowed values: `created_at`, `-created_at`, `updated_at`, `-updated_at`.
	Sort *ListForwardersParamsSort `form:"sort,omitempty" json:"sort,omitempty"`

	// PageNumber 1-based page number to return. Optional; defaults to `1` when omitted. Must be `>= 1` — requests with a smaller value are rejected with a 400 error.
	PageNumber *int `form:"page[number],omitempty" json:"page[number],omitempty"`

	// PageSize Number of items per page. Optional; defaults to `1000` when omitted. Must be between `1` and `1000` inclusive — requests outside that range are rejected with a 400 error.
	PageSize *int `form:"page[size],omitempty" json:"page[size],omitempty"`

	// MetaTotal When `true`, the response's `meta.pagination` block includes `total` (the total number of matching items across all pages) and `total_pages`. Computing these requires an extra `COUNT` query, so omit (or pass `false`) when the totals are not needed. Defaults to `false`.
	MetaTotal *bool `form:"meta[total],omitempty" json:"meta[total],omitempty"`
}

type ListForwardersParamsSort string

type ListForwardersResponse struct {
	Body                     []byte
	HTTPResponse             *http.Response
	ApplicationvndApiJSON200 *ForwarderListResponse
}

type ListMeta struct {
	// Pagination Pagination block returned inside “meta“ on every list response.
	//
	// “page“ and “size“ are always present and echo the parameters that
	// served the response (their defaults when the client omitted them).
	// “total“ and “total_pages“ are present only when the request included
	// “meta[total]=true“.
	Pagination PaginationMeta `json:"pagination"`
}

type ListResourceTypesParams struct {
	// FilterEnvironment Comma-separated list of environment keys to scope results to (e.g. `production,staging`). When omitted, results cover every environment you can access. The reserved value `smplkit` selects platform change events smplkit records about your own resources; it is included by default when your plan grants change history, and requesting it explicitly without that entitlement returns 402.
	FilterEnvironment *string `form:"filter[environment],omitempty" json:"filter[environment],omitempty"`

	// Sort Field to sort by. Prefix with `-` for descending order. Default: `key`. Allowed values: `key`, `-key`.
	Sort *ListResourceTypesParamsSort `form:"sort,omitempty" json:"sort,omitempty"`

	// PageNumber 1-based page number to return. Optional; defaults to `1` when omitted. Must be `>= 1` — requests with a smaller value are rejected with a 400 error.
	PageNumber *int `form:"page[number],omitempty" json:"page[number],omitempty"`

	// PageSize Number of items per page. Optional; defaults to `1000` when omitted. Must be between `1` and `1000` inclusive — requests outside that range are rejected with a 400 error.
	PageSize *int `form:"page[size],omitempty" json:"page[size],omitempty"`

	// MetaTotal When `true`, the response's `meta.pagination` block includes `total` (the total number of matching items across all pages) and `total_pages`. Computing these requires an extra `COUNT` query, so omit (or pass `false`) when the totals are not needed. Defaults to `false`.
	MetaTotal *bool `form:"meta[total],omitempty" json:"meta[total],omitempty"`
}

type ListResourceTypesParamsSort string

type ListResourceTypesResponse struct {
	Body                     []byte
	HTTPResponse             *http.Response
	ApplicationvndApiJSON200 *ResourceTypeListResponse
}

type ListUsageParams struct {
	// FilterPeriod Period to report. `current` is the only supported value.
	FilterPeriod string `form:"filter[period]" json:"filter[period]"`

	// PageNumber 1-based page number to return. Optional; defaults to `1` when omitted. Must be `>= 1` — requests with a smaller value are rejected with a 400 error.
	PageNumber *int `form:"page[number],omitempty" json:"page[number],omitempty"`

	// PageSize Number of items per page. Optional; defaults to `1000` when omitted. Must be between `1` and `1000` inclusive — requests outside that range are rejected with a 400 error.
	PageSize *int `form:"page[size],omitempty" json:"page[size],omitempty"`

	// MetaTotal When `true`, the response's `meta.pagination` block includes `total` (the total number of matching items across all pages) and `total_pages`. Computing these requires an extra `COUNT` query, so omit (or pass `false`) when the totals are not needed. Defaults to `false`.
	MetaTotal *bool `form:"meta[total],omitempty" json:"meta[total],omitempty"`
}

type ListUsageResponse struct {
	Body                     []byte
	HTTPResponse             *http.Response
	ApplicationvndApiJSON200 *UsageResponse
}

type PaginationMeta struct {
	// Page 1-based page number returned.
	Page int `json:"page"`

	// Size Number of items per page.
	Size int `json:"size"`

	// Total Total number of matching items across all pages. Present only when the request included `meta[total]=true`.
	Total *int `json:"total,omitempty"`

	// TotalPages Total number of pages at the requested page size. Present only when the request included `meta[total]=true`.
	TotalPages *int `json:"total_pages,omitempty"`
}

type RecordEventApplicationVndAPIPlusJSONRequestBody = EventRequest

type RecordEventParams struct {
	IdempotencyKey *string `json:"Idempotency-Key,omitempty"`
}

type RecordEventResponse struct {
	Body                     []byte
	HTTPResponse             *http.Response
	ApplicationvndApiJSON200 *EventResponse
	ApplicationvndApiJSON201 *EventResponse
}

type RequestEditorFn func(ctx context.Context, req *http.Request) error

type ResourceTypeAttributes struct {
	// CreatedAt First sighting of this resource_type for the account.
	CreatedAt time.Time `json:"created_at"`

	// ResourceType The resource_type slug. Same as the JSON:API “id“.
	ResourceType string `json:"resource_type"`
}

type ResourceTypeListResponse struct {
	Data []ResourceTypeResource `json:"data"`

	// Meta Top-level “meta“ block included on every JSON:API list response.
	Meta ListMeta `json:"meta"`
}

type ResourceTypeResource struct {
	Attributes ResourceTypeAttributes `json:"attributes"`

	// Id The resource_type slug.
	Id   string  `json:"id"`
	Type *string `json:"type,omitempty"`
}

type RetryFailedDeliveriesRequest struct {
	// Environment The single environment whose failed deliveries are re-attempted. Omit it and a single-environment credential implies it (a multi-environment credential must name it), and a named environment must be one the caller may access. The action always targets exactly one environment.
	Environment *string `json:"environment,omitempty"`
}

type RetryFailedDeliveriesSummary struct {
	// Attempted Number of failed deliveries that were re-attempted.
	Attempted int `json:"attempted"`

	// Failed Number of re-attempts that failed again.
	Failed int `json:"failed"`

	// Succeeded Number of re-attempts that succeeded.
	Succeeded int `json:"succeeded"`
}

type RetryFailedForwarderDeliveriesJSONRequestBody = RetryFailedDeliveriesRequest

type RetryFailedForwarderDeliveriesResponse struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON200      *RetryFailedDeliveriesSummary
}

type RetryForwarderDeliveryResponse struct {
	Body                     []byte
	HTTPResponse             *http.Response
	ApplicationvndApiJSON200 *ForwarderDeliveryResponse
}

type SearchEventsJSONRequestBody = EventSearchRequest

type SearchEventsResponse struct {
	Body         []byte
	HTTPResponse *http.Response
	JSON200      *EventSearchResponse
}

type Severity string

type TestForwarderRequest struct {
	// Body Request body sent to the destination. When omitted, an empty body is sent (suitable for connectivity probes). When set, the body is sent verbatim — pair with an appropriate `Content-Type` entry in `headers` so the destination interprets it correctly. Limit 1 MiB.
	Body *string `json:"body,omitempty"`

	// CaCert Optional PEM-encoded certificate (or bundle) used to verify the destination server's TLS certificate. Mirrors the parent forwarder field. Must contain one or more `-----BEGIN CERTIFICATE-----` blocks.
	CaCert *string `json:"ca_cert,omitempty"`

	// Headers HTTP headers attached to the test request.
	Headers *[]HttpHeader `json:"headers,omitempty"`

	// Method HTTP method used for the test request.
	Method *TestForwarderRequestMethod `json:"method,omitempty"`

	// SuccessStatus HTTP response status that indicates success. Either a specific status code (e.g. `200`, `204`) or a status class (`1xx`, `2xx`, `3xx`, `4xx`, `5xx`).
	SuccessStatus *string `json:"success_status,omitempty"`

	// TimeoutMs Per-request timeout in milliseconds. Capped at 30 seconds.
	TimeoutMs *int `json:"timeout_ms,omitempty"`

	// TlsVerify Whether to verify the destination server's TLS certificate. Mirrors the parent forwarder field of the same name — see its description for security guidance. Defaults to `true`.
	TlsVerify *bool `json:"tls_verify,omitempty"`

	// Url Destination URL. Must be an absolute `http://` or `https://` URL with a hostname (e.g. `https://siem.example.com/in`).
	Url string `json:"url"`
}

type TestForwarderRequestMethod string

type TestForwarderResponse struct {
	// Error Error message if the request did not complete.
	Error *string `json:"error,omitempty"`

	// LatencyMs Elapsed time of the request in milliseconds.
	LatencyMs *int `json:"latency_ms"`

	// ResponseBody Response body returned by the destination.
	ResponseBody *string `json:"response_body,omitempty"`

	// ResponseHeaders Headers returned by the destination.
	ResponseHeaders *map[string]string `json:"response_headers,omitempty"`

	// ResponseStatus HTTP status code returned by the destination.
	ResponseStatus *int `json:"response_status"`

	// Succeeded True if the destination responded with a status matching `success_status`.
	Succeeded bool `json:"succeeded"`
}

type UpdateForwarderApplicationVndAPIPlusJSONRequestBody = ForwarderRequest

type UpdateForwarderResponse struct {
	Body                     []byte
	HTTPResponse             *http.Response
	ApplicationvndApiJSON200 *ForwarderResponse
}

type UsageAttributes struct {
	// LimitKey Identifier of the metered limit, e.g. `audit.events_per_month`.
	LimitKey string `json:"limit_key"`

	// Period Period the counter covers. `current` is the only supported value.
	Period string `json:"period"`

	// Value Count for the period.
	Value int `json:"value"`
}

type UsageResource struct {
	// Attributes Usage counter for a single metered limit.
	Attributes UsageAttributes `json:"attributes"`
	Id         string          `json:"id"`
	Type       *string         `json:"type,omitempty"`
}

type UsageResponse struct {
	Data []UsageResource `json:"data"`

	// Meta Top-level “meta“ block included on every JSON:API list response.
	Meta ListMeta `json:"meta"`
}