---
title: "Create Summarizer Brief"
method: POST
path: "/api/workspaces/{workspace_id}/summarizer/briefs"
---

# Create Summarizer Brief

`POST /api/workspaces/{workspace_id}/summarizer/briefs`

## Path parameters

- `workspace_id` string, required

## Request body

- SummarizerBriefWriteRequest
  - `name` string, required
  - `description` string, nullable
  - `useCaseId` string, nullable
  - `industry` 'REAL_ESTATE' | 'HOSPITAL' | 'LOGISTICS' | 'PHARMACY' | 'SCHOOL' | 'OTHERS', nullable
  - `prompt` string, nullable
  - `taskObjectives` string, nullable
  - `conclusion` string, nullable
  - `language` string

## Response `201`

Successful Response

- SummarizerBriefEnvelopeResponse
  - `brief` SummarizerBriefResponse, required
    - `id` string, required
    - `workspaceId` string, required
    - `createdById` string, nullable
    - `useCaseId` string, nullable
    - `name` string, required
    - `description` string, nullable
    - `industry` string, nullable
    - `prompt` string, nullable
    - `taskObjectives` string, nullable
    - `conclusion` string, nullable
    - `language` string
    - `recordingCount` integer
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required

## Other responses

- `422` — Validation Error

## Changes

> 16 revisions in range; 5 could not be searched.

- **2026-07-31** `7c9aff2501f3` — 2 warning, 2 info
  - removed the request property `campaignId`
  - removed the optional property `brief/campaignId` from the response with the `201` status
  - added the new optional request property `useCaseId`
  - added the optional property `brief/useCaseId` to the response with the `201` status
- **2026-07-26** `e7248cb2f50b` — 1 info
  - added the new `OTHERS` enum value to the request property `industry/anyOf[subschema #1]/`

[Change history](https://skmtc.dev/outcallerai/apis/fastapi/changes/api/workspaces/:workspace_id/summarizer/briefs/post.md)

---

[API](https://skmtc.dev/outcallerai/apis/fastapi.md) · [All operations](https://skmtc.dev/outcallerai/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/outcallerai/fastapi/revisions/6155db644bab/schema)