# Create a brief

Creates a brief using the specified brief type ID, locale, and provided data fields. The new brief is saved as a draft in the [Brief management tool](https://doc.sitecore.com/sai/en/users/sitecoreai/managing-briefs.html).

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

## Security:

  - `HTTPBearer` (unknown)
    http bearer JWT

## 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.

## Request fields (application/json):

  - `name` (string, required)
    The name of the brief.
    Example: New Summer Campaign Brief

  - `locale` (string, required)
    The locale code associated with the brief, in the format xx-XX.
    Example: en-us

  - `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

  - `fields` (any)
    Dictionary of field names to their values.
    Example: {"Objectives":{"type":"RichText","value":"New product campaign launch for Summer 2026."},"TargetAudience":{"type":"RichText","value":"Millenials"}}

## Response 201:

  - `201` (unknown)
    Successful response

## Response 201 fields (application/json):

  - `id` (string)
    The unique identifier of the created brief.
    Example: a1b2c3d4-e5f6-7890-abcd-ef1234567890

  - `icon` (any)
    The icon associated with the brief.

  - `name` (string)
    The name of the brief.
    Example: New Summer Campaign Brief

  - `status` (string)
    The status of the brief. *Draft* by default.
    Example: Draft

  - `locale` (string)
    The locale code in the format xx-XX.
    Example: en-us

  - `fields` (object)
    Dictionary of field names to their values.
    Example: {"Objectives":{"type":"RichText","value":"New product campaign launch for Summer 2026."},"TargetAudience":{"type":"RichText","value":"Millenials"}}

  - `isTemplate` (any)
    Whether the brief is a template
    Example: false

  - `contributors` (any)
    A list of users who are contributors to the brief, or null if no contributors.

  - `createdBy` (any)
    The user who created the brief.

  - `createdBy.type` (string)
    The type of the link, which is always 'ExternalLink' for this model.
    Example: ExternalLink

  - `createdBy.relatedSystem` (string)
    Represents the related system reference for external links
    Enum: "contenthub", "mms", "ai", "xmcloud", "co"

  - `createdBy.relatedType` (any)
    The type of the related entity in the external system, or null if not specified.
    Example: Dashboard

  - `createdBy.id` (string)
    The unique identifier of the related entity in the external system.
    Example: dashboard-12345

  - `createdOn` (any)
    The ISO 8601 timestamp when the brief was created.
    Example: 2026-01-15T10:30:00Z

  - `updatedBy` (any)
    The user who last updated the brief.

  - `updatedOn` (any)
    The ISO 8601 timestamp when the brief was last updated.
    Example: 2026-04-01T08:00:00Z

## Response 422:

  - `422` (unknown)
    Unprocessable entity

## Response 422 fields (application/json):

  - `detail` (array)

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

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

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

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

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