Analysis

Save agent-generated analysis result

Changed on

Saves structured analysis output (title, summary, evidence, failure category) to the target entity (test run, plan run, or deployment). Used by the auto-analysis agent system.

put/analysis/{workspace_id}/agentAnalysis/save

Request

  • Base URL: https://api.mabl.com
  • URL: https://api.mabl.com/analysis/{workspace_id}/agentAnalysis/save
  • Auth: one of:
    • HTTP basic
    • API key in header Authorization

Path parameters

workspace_idstring required

The workspace associated with this entity

Request body

entity_idstring required

ID of the entity to save analysis on (test run, plan run, or deployment event)

entity_type'test_run' | 'plan_run' | 'deployment' required

The type of entity

titlestring required

Agent-generated analysis title

summarystring required

Agent-generated analysis summary (root cause + next steps)

failure_categorystring

Agent-suggested failure category ID

evidence_detailsstring

Agent-generated evidence details

content_blocks_jsonstring

Pre-computed structured content blocks for evidence_details, serialized as a JSON array string. Stored as-is on the FailureAnalysis entity and deserialized by consumers.

agent_session_idstring

ID of the agent session that generated this analysis

reused_from_run_idstring

When the failure analysis was reused from a prior run, the ID of the original run that produced the analysis.

analysis_source'auto' | 'user_correction'

Who authored this analysis. Defaults to auto (the automatic analysis agent) when absent. user_correction marks a correction a user made in the results chat: it is stored as a new analysis attributed to that user, and a later automatic analysis of the same execution will not overwrite it. A correction may omit evidence_details and content_blocks_json, in which case the evidence already stored for the execution is kept.

failing_step_numberstring

The step number the run terminally failed at (e.g. "12.4"), taken from the execution log when the server could determine it, otherwise from the analysis agent. Test-run analyses only.

Response

Analysis result saved successfully

Changes

  • fa7925beb997Revision changes
    • info

      added the new optional request property

    • info

      added the new optional request property