---
title: "Upsert application summary"
method: POST
path: "/applicationSummary"
tags: ["Application"]
---

# Upsert application summary

`POST /applicationSummary`

Create a new application summary version (AI-generated or user-created). Version number is auto-incremented.

## Headers

- `If-Match` string

## Request body

- ApplicationSummary — AI-generated summary of an application based on test analysis
  - `id` string — Unique identifier for the application summary
  - `version` integer — Business version number of this summary (auto-incremented by server)
  - `workspace_id` string, required — ID of workspace associated with this summary
  - `application_id` string, required — ID of the application this summary describes
  - `created_time` integer — Time summary was created (epoch milliseconds)
  - `created_by_id` string — ID of user or client who created the summary
  - `summary` string, required — The full AI-generated summary text
  - `headline` string — Short headline version of the summary
  - `previous_agent_summary_id` string — ID of the previous AI-generated summary this was based on
  - `is_user_created_version` boolean, required — Whether this version was created or edited by a user
  - `user_edits_summary` string — User-provided summary text if is_user_created_version is true
  - `agent_type` 'test_authoring' | 'test_creation_planning' | 'test_planning' | 'agent_review' | 'app_summary' | 'test_run_analysis' | 'test_recovery' | 'runtime_recovery_summary_agent' | 'plan_run_analysis' | 'deployment_analysis' | 'workspace_results_analysis' | 'results_auto_analysis' | 'app_modeling' | 'app_modeling_run' | 'file_assertion'
  - `agent_version` string — Version of the AI agent that generated this summary
  - `test_summaries_used_count` integer — Number of test summaries used to generate this summary
  - `test_details_used_invariant_ids` string[] — Invariant IDs of tests whose details were used
  - `screenshots_used_count` integer — Number of screenshots analyzed for this summary

## Response `201`

Application summary created

- ApplicationSummary — AI-generated summary of an application based on test analysis
  - `id` string — Unique identifier for the application summary
  - `version` integer — Business version number of this summary (auto-incremented by server)
  - `workspace_id` string, required — ID of workspace associated with this summary
  - `application_id` string, required — ID of the application this summary describes
  - `created_time` integer — Time summary was created (epoch milliseconds)
  - `created_by_id` string — ID of user or client who created the summary
  - `summary` string, required — The full AI-generated summary text
  - `headline` string — Short headline version of the summary
  - `previous_agent_summary_id` string — ID of the previous AI-generated summary this was based on
  - `is_user_created_version` boolean, required — Whether this version was created or edited by a user
  - `user_edits_summary` string — User-provided summary text if is_user_created_version is true
  - `agent_type` 'test_authoring' | 'test_creation_planning' | 'test_planning' | 'agent_review' | 'app_summary' | 'test_run_analysis' | 'test_recovery' | 'runtime_recovery_summary_agent' | 'plan_run_analysis' | 'deployment_analysis' | 'workspace_results_analysis' | 'results_auto_analysis' | 'app_modeling' | 'app_modeling_run' | 'file_assertion'
  - `agent_version` string — Version of the AI agent that generated this summary
  - `test_summaries_used_count` integer — Number of test summaries used to generate this summary
  - `test_details_used_invariant_ids` string[] — Invariant IDs of tests whose details were used
  - `screenshots_used_count` integer — Number of screenshots analyzed for this summary

## Other responses

- `400` — Invalid or missing parameter
- `401` — User not authenticated
- `403` — User not authorized
- `404` — Entity not found
- `412` — Unknown error
- `default` — Unknown error

---

[API](https://skmtc.net/mabl/apis/mabl-api.md) · [All operations](https://skmtc.net/mabl/apis/mabl-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mabl/mabl-api/revisions/d0fc0114da66/schema)