# Generate a brief

Generates a brief draft and the content of its fields, using the specified brief type, brand kit, and prompt. This endpoint does not save the generated draft. You can copy the response and use the Create a brief endpoint to save it in the Brief management tool.

Endpoint: POST /api/v1/brief/generate
Version: v2.0
Security: HTTPBearer

## Header parameters:

  - `x-sc-job-id` (any)
    A unique identifier for the job, used to trace, audit, and revert actions performed by an AI agent through the Agent API.
    Example: "job-1234"

## Request fields (application/json):

  - `briefTypeId` (string, required)
    The unique identifier of the brief type to use for generating a brief. To get this ID, you can use the [List brief types](#operation/brieftypes-list_brieftypes) endpoint to retrieve the list of brief types available in your organization.
    Example: "e7fe656b-178e-4ee2-86a9-ec800ff8a31d"

  - `brandId` (string, required)
    The unique identifier of the brand kit. To get this ID, you can use the [List brand kits](#operation/brandkits-list_brandkits) endpoint to retrieve the list of brand kits in your organization.
    Example: "b1234567-89ab-4cde-f012-3456789abcde"

  - `prompt` (string, required)
    The prompt for brief generation. This provides AI the context or instructions for generating the brief.
    Example: "Generate a brief for the new holiday campaign."

## Response 422 fields (application/json):

  - `detail` (array)

  - `detail.loc` (array, required)
    The location of the error in the request.

  - `detail.msg` (string, required)
    The error message.

  - `detail.type` (string, required)
    The type of error.

  - `detail.input` (any)
    The input that caused the error.

  - `detail.ctx` (object)
    The context in which the error occurred.