Check if the MiroFish backend is running and healthy. Returns service status.

List all MiroFish projects. Each project contains seed documents and ontology definitions for simulation.

Get details of a specific MiroFish project by its ID, including ontology, files, status, and graph info.

Delete a MiroFish project and all its associated data.

Reset a project's state so its knowledge graph can be rebuilt. Keeps the ontology but clears the graph.

Upload seed documents and a simulation requirement to generate an ontology (entity types and edge types). This creates a new project. Accepts PDF/MD/TXT file URLs or paths. NOTE: This endpoint expects multipart/form-data with actual file uploads — use the simulation_requirement and project_name to describe the scenario, and provide document text directly.

Build a knowledge graph from a project's documents and ontology using Zep. This is an async operation — returns a task_id to poll with mirofish_get_task.

Retrieve the full knowledge graph data (nodes and edges) for a given graph ID.

Delete a Zep knowledge graph by its ID.

Check the status and progress of an async task (graph building, simulation preparation, report generation, etc.).

List all background tasks and their statuses.

Get all filtered entities from a knowledge graph. Only returns nodes matching predefined entity types.

Get detailed information about a specific entity including its context and relationships.

Get all entities of a specific type from a knowledge graph.

Create a new multi-agent simulation from a project. Requires a completed knowledge graph.

Prepare a simulation environment — reads entities from the graph, generates agent profiles via LLM, and creates simulation config. Async — returns task_id.

Check the progress of simulation preparation.

Start running a prepared simulation. Agents will begin interacting in the simulated environment.

Stop a running simulation.

Get details and current status of a specific simulation.

List all simulations, optionally filtered by project.

Get the real-time running status of a simulation including process state.

Get detailed running status of a simulation including round progress and agent activity.

Get the agent profiles generated for a simulation.

Get the simulation configuration parameters.

Get the action log of a simulation — all agent actions taken during the run.

Get a chronological timeline of events during the simulation.

Get statistics about agent behavior during a simulation.

Get social media posts generated by agents during the simulation (Twitter/Reddit style).

Get comments/replies generated by agents during the simulation.

Interview (chat with) a specific simulated agent. The agent responds based on its personality, memories, and actions during the simulation.

Send the same question to multiple agents at once. Useful for gathering diverse perspectives.

Send the same question to ALL agents in the simulation. Returns all their responses.

Get the conversation history for a specific agent interview.

Check the status of the simulation environment (OASIS engine).

Close/shut down a simulation environment.

Generate a prediction/analysis report from a completed simulation. Async — returns task_id to poll.

Check the progress of report generation.

Get a completed report by its ID — includes outline, markdown content, and metadata.

Get the report associated with a specific simulation.

List all generated reports, optionally filtered by simulation.

Delete a generated report.

Get real-time progress of report generation including current section being written.

Get all generated sections of a report. Can be polled during generation to get sections as they complete.

Get the content of a specific section by index.

Check if a simulation has a report and its status. Used to determine if interview is unlocked.

Have a conversation with the Report Agent about a simulation's results. The agent can search the knowledge graph and use tools to answer your questions.

Search the knowledge graph for facts and information. Uses Zep's semantic search.

Get statistics about a knowledge graph — node counts, edge counts, entity type distribution.

Get the history of all simulations with their run status and results.