---
title: "putSchemaGroupHeadline"
method: PUT
path: "/v1/entity/schemas/headline/{composite_id}"
tags: ["Schemas"]
---

# putSchemaGroupHeadline

`PUT /v1/entity/schemas/headline/{composite_id}`

Adds or updates a group headline in the schema

## Path parameters

- `composite_id` string, required

## Request body

- GroupHeadlineWithCompositeID — a readonly computed ID for the entity group headline including schema slug and the headline ID
  - `id` string, uuid
  - `name` string, required
  - `label` string, required
  - `layout` string
  - `group` string, required — The group of headline attribute
  - `order` integer — The order of headline attribute
  - `type` 'headline', required
  - `enable_divider` boolean
  - `divider` 'top_divider' | 'bottom_divider'
  - `_purpose` ClassificationId[]
  - `_manifest` string[], nullable — Manifest ID used to create/update the schema group headline
  - `composite_id` string
  - `schema` string — Schema slug the capability belongs to

## Response `200`

Success

- GroupHeadlineWithCompositeID — a readonly computed ID for the entity group headline including schema slug and the headline ID
  - `id` string, uuid
  - `name` string, required
  - `label` string, required
  - `layout` string
  - `group` string, required — The group of headline attribute
  - `order` integer — The order of headline attribute
  - `type` 'headline', required
  - `enable_divider` boolean
  - `divider` 'top_divider' | 'bottom_divider'
  - `_purpose` ClassificationId[]
  - `_manifest` string[], nullable — Manifest ID used to create/update the schema group headline
  - `composite_id` string
  - `schema` string — Schema slug the capability belongs to

---

[API](https://skmtc.net/epilot/apis/entity-api.md) · [All operations](https://skmtc.net/epilot/apis/entity-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/epilot/entity-api/versions/8dd3d44e1c4f/schema)