---
title: "Apply Cognitive"
method: POST
path: "/v1/projects/{project_id}/keys/{key_id}/cognitive/apply"
tags: ["cognitive"]
---

# Apply Cognitive

`POST /v1/projects/{project_id}/keys/{key_id}/cognitive/apply`

## Request

- Base URL: `https://api.sonenta.dev`
- URL: `https://api.sonenta.dev/v1/projects/{project_id}/keys/{key_id}/cognitive/apply`
- Auth: none declared

Apply a suggestion: (A) mode=default -> replaces the key's base value
(re-translate locales after); (B) mode=surface -> easy-reading variant.

## Path parameters

- `key_id` string, required
- `project_id` string, required

## Request body

- CognitiveApplyIn
  - `mode` string, required
  - `surface` string
  - `language_codes` string[], nullable

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/sonenta/apis/sonenta-api.md) · [All operations](https://skmtc.dev/sonenta/apis/sonenta-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sonenta/apis/sonenta-api/revisions/f853ea49fb05?raw)