Log Workflows to an Observe Project
Log workflows to an Observe project.
Use this endpoint to log workflows to an Observe project. The request body should contain the
workflows to be ingested.
Additionally, specify the project_id or project_name to which the workflows should be ingested.
If the project does not exist, it will be created. If the project exists, the workflows will be logged to it.
If both project_id and project_name are provided, project_id will take precedence.
curl --request POST \
--url https://api.acme.rungalileo.io/v1/observe/workflows \
--header 'Content-Type: application/json' \
--header 'Galileo-API-Key: <api-key>' \
--data '{
"project_name": "my-observe-project",
"workflows": [
{
"created_at_ns": 1741367645601150000,
"duration_ns": 0,
"input": "who is a smart LLM?",
"metadata": {},
"name": "llm",
"output": "I am!",
"type": "llm"
}
]
}'{
"message": "<string>",
"project_id": "<string>",
"project_name": "<string>",
"workflows_count": 123,
"records_count": 123
}WorkflowStep
A workflow step is the atomic unit of logging to Galileo. They represent a single execution of a workflow, such as a chain, agent, or a RAG execution. Workflows can have multiple steps, each of which can be a different type of node, such as an LLM, Retriever, or Tool.
You can log multiple workflows in a single request. Each workflow step must have the following fields:
type: The type of the workflow.input: The input to the workflow.output: The output of the workflow.
Examples
LLM Step
{
"type": "llm",
"input": "What is the capital of France?",
"output": "Paris"
}
Retriever Step
{
"type": "retriever",
"input": "What is the capital of France?",
"output": [{ "content": "Paris is the capital and largest city of France." }]
}
Multi-Step
Workflow steps of type workflow, agent or chain can have sub-steps with children. A workflow with a retriver and an LLM step would look like this:
{
"type": "workflow",
"input": "What is the capital of France?",
"output": "Paris",
"steps": [
{
"type": "retriever",
"input": "What is the capital of France?",
"output": [{ "content": "Paris is the capital and largest city of France." }]
},
{
"type": "llm",
"input": "What is the capital of France?",
"output": "Paris"
}
]
}
Authorizations
Body
List of workflows to log.
Input to the step.
Type of the step. By default, it is set to workflow.
"workflow"Output of the step.
Name of the step.
Timestamp of the step's creation, as nanoseconds since epoch.
Duration of the step in nanoseconds.
Status code of the step. Used for logging failed/errored steps.
Ground truth expected output for the step.
Steps in the workflow.
Input to the step.
Type of the step. By default, it is set to workflow.
"workflow"Output of the step.
Name of the step.
Timestamp of the step's creation, as nanoseconds since epoch.
Duration of the step in nanoseconds.
Metadata associated with this step.
Status code of the step. Used for logging failed/errored steps.
Ground truth expected output for the step.
Steps in the workflow.
Input to the step.
Type of the step. By default, it is set to workflow.
"workflow"Output of the step.
Name of the step.
Timestamp of the step's creation, as nanoseconds since epoch.
Duration of the step in nanoseconds.
Metadata associated with this step.
Status code of the step. Used for logging failed/errored steps.
Ground truth expected output for the step.
Steps in the workflow.
Input to the step.
Type of the step. By default, it is set to workflow.
"workflow"Output of the step.
Name of the step.
Timestamp of the step's creation, as nanoseconds since epoch.
Duration of the step in nanoseconds.
Metadata associated with this step.
Status code of the step. Used for logging failed/errored steps.
Ground truth expected output for the step.
Steps in the workflow.
Parent node of the current node. For internal use only.
Parent node of the current node. For internal use only.
Input to the step.
Type of the step. By default, it is set to workflow.
chain, chat, llm, retriever, tool, agent, workflow, trace Output of the step.
Name of the step.
Timestamp of the step's creation, as nanoseconds since epoch.
Duration of the step in nanoseconds.
Metadata associated with this step.
Status code of the step. Used for logging failed/errored steps.
Ground truth expected output for the step.
Steps in the workflow.
Parent node of the current node. For internal use only.
Input to the step.
Type of the step. By default, it is set to workflow.
chain, chat, llm, retriever, tool, agent, workflow, trace Output of the step.
Name of the step.
Timestamp of the step's creation, as nanoseconds since epoch.
Duration of the step in nanoseconds.
Metadata associated with this step.
Status code of the step. Used for logging failed/errored steps.
Ground truth expected output for the step.
Steps in the workflow.
Input to the step.
Type of the step. By default, it is set to workflow.
"workflow"Output of the step.
Name of the step.
Timestamp of the step's creation, as nanoseconds since epoch.
Duration of the step in nanoseconds.
Metadata associated with this step.
Status code of the step. Used for logging failed/errored steps.
Ground truth expected output for the step.
Steps in the workflow.
Parent node of the current node. For internal use only.
Parent node of the current node. For internal use only.
Input to the step.
Type of the step. By default, it is set to workflow.
chain, chat, llm, retriever, tool, agent, workflow, trace Output of the step.
Name of the step.
Timestamp of the step's creation, as nanoseconds since epoch.
Duration of the step in nanoseconds.
Metadata associated with this step.
Status code of the step. Used for logging failed/errored steps.
Ground truth expected output for the step.
Steps in the workflow.
Input to the step.
Type of the step. By default, it is set to workflow.
"workflow"Output of the step.
Name of the step.
Timestamp of the step's creation, as nanoseconds since epoch.
Duration of the step in nanoseconds.
Metadata associated with this step.
Status code of the step. Used for logging failed/errored steps.
Ground truth expected output for the step.
Steps in the workflow.
Input to the step.
Type of the step. By default, it is set to workflow.
"workflow"Output of the step.
Name of the step.
Timestamp of the step's creation, as nanoseconds since epoch.
Duration of the step in nanoseconds.
Metadata associated with this step.
Status code of the step. Used for logging failed/errored steps.
Ground truth expected output for the step.
Steps in the workflow.
Parent node of the current node. For internal use only.
Parent node of the current node. For internal use only.
Input to the step.
Type of the step. By default, it is set to workflow.
chain, chat, llm, retriever, tool, agent, workflow, trace Output of the step.
Name of the step.
Timestamp of the step's creation, as nanoseconds since epoch.
Duration of the step in nanoseconds.
Metadata associated with this step.
Status code of the step. Used for logging failed/errored steps.
Ground truth expected output for the step.
Steps in the workflow.
Project ID for the Observe project.
Project name for the Observe project.
Was this page helpful?
curl --request POST \
--url https://api.acme.rungalileo.io/v1/observe/workflows \
--header 'Content-Type: application/json' \
--header 'Galileo-API-Key: <api-key>' \
--data '{
"project_name": "my-observe-project",
"workflows": [
{
"created_at_ns": 1741367645601150000,
"duration_ns": 0,
"input": "who is a smart LLM?",
"metadata": {},
"name": "llm",
"output": "I am!",
"type": "llm"
}
]
}'{
"message": "<string>",
"project_id": "<string>",
"project_name": "<string>",
"workflows_count": 123,
"records_count": 123
}