Endpoint /logs

Endpoint logs return log messages with various data structures.

In this section, we will examine five types of response logs, including their common parameters and other details.

GET or POST https://api.YOUR_TENANT.appmixer.cloud/logs

Complete documentation for the appmixer application API protocols can be found at:

Common Core

These fields are present in all observed variants.

Field	Type	Format / Notes
_id	string	Elasticsearch document id
_index	string	Elasticsearch index name
es_index	string	Source index name
flowId	string	UUID-like string
gridTimestamp	string	ISO 8601 UTC datetime
id	string	Constant-like discriminator, observed values include component, input-queue, flow, retry
indexPrefix	string	Constant-like discriminator, observed values include logstash, system
severity	string	Constant-like discriminator, observed values include info, error
tenantId	string	Tenant identifier
timestamp	string	ISO 8601 UTC datetime

{
  "_id": "38j04JsB5N8vaDg6yxaZ",
  "_index": "dev-automated-00001-module-202601",
  "es_index": "dev-automated-00001-module-202601",
  "flowId": "49dfa93c-eda8-4d91-a345-b5f2ebdbae67",
  "gridTimestamp": "2026-01-21T14:28:17.138Z",
  "id": "component",
  "indexPrefix": "logstash",
  "severity": "info",
  "tenantId": "dev-automated-00001",
  "timestamp": "2026-01-21T14:28:17.146174532Z"
}

Variant 1: Component data event

Observed as the regular component-level data event, typically outbound, with id = "component" and type = "data". In the sample, portType is out for this variant.

Field	Type	Format / Notes
_id	string	Elasticsearch document id
_index	string	Elasticsearch index name
componentId	string	UUID-like string
componentType	string	Component type identifier
correlationId	string	UUID-like string
testRunId	string	Present only on records produced by a flow test run; its presence marks the record as a test execution.
staticCall	boolean	Present only on records produced by a static component call with log: true (AI Agent tools observability).
es_index	string	Source index name
flowId	string	UUID-like string
flowName	string	Flow name
flowType	string	Observed constant value: automation
gridTimestamp	string	ISO 8601 UTC datetime
id	string	Observed constant value: component
indexPrefix	string	Observed constant value: logstash
level	integer	Optional in sample, present in newer-looking records
messageId	string	UUID-like string, optional in sample
port	string	Port name, observed values include request, out, item, done
portType	string	Observed constant value in this variant: out
senderId	string	UUID-like string
senderType	string	Sender component type identifier
severity	string	Observed constant value in this variant: info
tenantId	string	Tenant identifier
timestamp	string	ISO 8601 UTC datetime
type	string	Observed constant value: data
userId	string	User identifier

{
  "severity": "info",
  "componentType": "appmixer.utils.controls.Each",
  "componentId": "201dd446-c259-4023-9118-5315539533ff",
  "level": 30,
  "messageId": "71b49651-7fb3-496a-815c-3186f65774fe",
  "type": "data",
  "flowName": "Test each",
  "userId": "695312affbdyyyb75e0cc360",
  "portType": "out",
  "senderId": "201dd446-c259-4023-9118-5315539533ff",
  "port": "item",
  "indexPrefix": "logstash",
  "tenantId": "dev-automated-00001",
  "correlationId": "545a95da-8a69-4103-b8d1-bebc9ec909d8",
  "senderType": "appmixer.utils.controls.Each",
  "es_index": "dev-automated-00001-module-202603",
  "id": "component",
  "gridTimestamp": "2026-03-17T16:29:11.910Z",
  "flowId": "49dfa93c-eda8-4d91-a345-b5f2ebdbae67",
  "flowType": "automation",
  "timestamp": "2026-03-17T16:29:11.918173099Z",
  "_id": "Ioyh_JwBw7IAskcYQtwv",
  "_index": "dev-automated-00001-module-202603"
}

Variant 2: Input queue data event

Observed as the inbound queue-style data event, with id = "input-queue" and type = "data". In the sample, portType is in for this variant.

Field	Type	Format / Notes
_id	string	Elasticsearch document id
_index	string	Elasticsearch index name
bundleId	string	UUID-like string
componentId	string	UUID-like string
componentType	string	Component type identifier
correlationId	string	UUID-like string
es_index	string	Source index name
flowId	string	UUID-like string
flowName	string	Flow name
flowType	string	Observed constant value: automation
gridTimestamp	string	ISO 8601 UTC datetime
id	string	Observed constant value: input-queue
indexPrefix	string	Observed constant value: logstash
level	integer	Optional in sample
messageId	string	UUID-like string, optional in sample
port	string	Observed constant value in this variant: in
portType	string	Observed constant value in this variant: in
senderId	string	UUID-like string
senderPort	string	Port name, observed values include out, item
senderType	string	Sender component type identifier
severity	string	Observed constant value in this variant: info
tenantId	string	Tenant identifier
timestamp	string	ISO 8601 UTC datetime
type	string	Observed constant value: data
userId	string	User identifier

{
  "severity": "info",
  "componentType": "appmixer.utils.controls.SetVariable",
  "senderPort": "item",
  "componentId": "67d06917-95fb-44f4-b7aa-f2ea6196ed32",
  "level": 30,
  "bundleId": "022adc03-2719-45e1-a18a-818e000f2d5f",
  "messageId": "5ba614d8-386a-4367-aa70-4753dafb8682",
  "type": "data",
  "flowName": "Test each",
  "userId": "694699affbdxxxb75e0cc360",
  "portType": "in",
  "senderId": "201dd446-c259-4023-9118-5315539533ff",
  "port": "in",
  "indexPrefix": "logstash",
  "tenantId": "dev-automated-00001",
  "correlationId": "545a95da-8a69-4103-b8d1-bebc9ec909d8",
  "senderType": "appmixer.utils.controls.Each",
  "es_index": "dev-automated-00001-module-202603",
  "id": "input-queue",
  "gridTimestamp": "2026-03-17T16:29:11.252Z",
  "flowId": "49dfa93c-eda8-4d91-a345-b5f2ebdbae67",
  "flowType": "automation",
  "timestamp": "2026-03-17T16:29:11.317881731Z",
  "_id": "PYqh_JwBbUptlPbkPuoX",
  "_index": "dev-automated-00001-module-202603"
}

Variant 3: Flow event

Observed as the flow-level event with id = "flow" and type = "flow".

Field	Type	Format / Notes
_id	string	Elasticsearch document id
_index	string	Elasticsearch index name
dataMessageType	string	Observed constant value in sample: componentLog
es_index	string	Source index name
flowId	string	UUID-like string
flowName	string	Flow name
flowType	string	Observed constant value: automation
gridTimestamp	string	ISO 8601 UTC datetime
id	string	Observed constant value: flow
indexPrefix	string	Observed constant value: logstash
level	integer	Optional in sample
severity	string	Observed constant value in sample: info
tenantId	string	Tenant identifier
timestamp	string	ISO 8601 UTC datetime
type	string	Observed constant value: flow
userId	string	User identifier

{
  "severity": "info",
  "dataMessageType": "componentLog",
  "type": "flow",
  "flowName": "Test each",
  "userId": "695399affbdxxxb75e0cc385",
  "indexPrefix": "logstash",
  "tenantId": "dev-automated-00001",
  "es_index": "dev-automated-00001-module-202603",
  "id": "flow",
  "gridTimestamp": "2026-03-17T16:29:11.252Z",
  "flowId": "49dfa93c-eda8-4d91-a345-b5f2ebdbae67",
  "flowType": "automation",
  "timestamp": "2026-03-17T16:29:11.260000000Z",
  "_id": "exampleFlowEventId",
  "_index": "dev-automated-00001-module-202603"
}

Variant 4: Component error event

Observed as a component-related error with id = "component", severity = "error", and without type in the sampled minimal form.

Field	Type	Format / Notes
_id	string	Elasticsearch document id
_index	string	Elasticsearch index name
componentId	string	UUID-like string
componentType	string	Component type identifier
correlationId	string	UUID-like string
es_index	string	Source index name
flowId	string	UUID-like string
gridTimestamp	string	ISO 8601 UTC datetime
id	string	Observed constant value: component
indexPrefix	string	Observed constant value: logstash
senderId	string	UUID-like string
senderType	string	Sender component type identifier
severity	string	Observed constant value: error
tenantId	string	Tenant identifier
timestamp	string	ISO 8601 UTC datetime
userId	string	User identifier

{
  "severity": "error",
  "componentType": "appmixer.utils.controls.Each",
  "componentId": "a4833f9f-0c29-4911-bff2-c4f73b0f1b13",
  "userId": "695312affbdxxxb75e0cc370",
  "senderId": "6fbd1b6a-10c3-4b8b-ac8d-68985f1fb8af",
  "indexPrefix": "logstash",
  "tenantId": "dev-automated-00001",
  "correlationId": "7fe84058-ad1a-4a6d-8a59-d015a9d7c4f5",
  "senderType": "appmixer.utils.http.WebhookTrigger",
  "es_index": "dev-automated-00001-module-202601",
  "id": "component",
  "gridTimestamp": "2026-01-21T14:28:01.714Z",
  "flowId": "49dfa93c-eda8-4d91-a345-b5f2ebdbae67",
  "timestamp": "2026-01-21T14:28:01.765321479Z",
  "_id": "uvD04JsBdjlz-szdjt4D",
  "_index": "dev-automated-00001-module-202601"
}

Variant 5: System retry error event

Observed as the system-level retry error with id = "retry" and indexPrefix = "system".

Field	Type	Format / Notes
_id	string	Elasticsearch document id
_index	string	Elasticsearch index name
componentId	string	UUID-like string
es_index	string	Source index name
flowId	string	UUID-like string
gridTimestamp	string	ISO 8601 UTC datetime
id	string	Observed constant value: retry
indexPrefix	string	Observed constant value: system
severity	string	Observed constant value: error
tenantId	string	Tenant identifier
timestamp	string	ISO 8601 UTC datetime

```json { "severity": "error", "componentId": "a4833f9f-0c29-4911-bff2-c4f73b0f1b13", "indexPrefix": "system", "tenantId": "dev-automated-00001", "es_index": "dev-automated-00001-appmixer-202601", "id": "retry", "gridTimestamp": "2026-01-21T14:28:01.715Z", "flowId": "49dfa93c-eda8-4d91-a345-b5f2ebdbae67", "timestamp": "2026-01-21T14:28:01.768048338Z", "_id": "vfD04JsBdjlz-szdjt4D", "_index": "dev-automated-00001-appmixer-202601" } ```

Minimal summary of observed discriminators

These are the constant-like fields that help identify the output variant:

Variant	id	indexPrefix	severity	type	portType
Component data event	component	logstash	info	data	out
Input queue data event	input-queue	logstash	info	data	in
Flow event	flow	logstash	info	flow	—
Component error event	component	logstash	error	—	—
System retry error event	retry	system	error	—	—