---
title: "Create or update PR messages"
method: POST
path: "/pull-request-messages"
tags: ["Pull Request Messages"]
---

# Create or update PR messages

`POST /pull-request-messages`

Creates or updates the review message configuration for a repository or directory.

## Request body

- PullRequestMessagesUpsertDto
  - `organizationId` string — Optional. It will be replaced by the authenticated user organization.
  - `configLevel` 'main' | 'global' | 'repository' | 'directory', required
  - `repositoryId` string
  - `directoryId` string
  - `startReviewMessage` PullRequestMessageContentUpsertDto
    - `content` string, required
    - `status` 'every_push' | 'only_when_opened' | 'off' | 'active' | 'inactive', required
  - `endReviewMessage` PullRequestMessageContentUpsertDto
    - `content` string, required
    - `status` 'every_push' | 'only_when_opened' | 'off' | 'active' | 'inactive', required
  - `globalSettings` PullRequestMessagesGlobalSettingsUpsertDto
    - `hideComments` boolean
    - `suggestionCopyPrompt` boolean

## Response `204`

Configuration updated

## Other responses

- `400` — Validation error
- `401` — Not authenticated
- `403` — Insufficient permissions
- `500` — Unexpected error

---

[API](https://skmtc.net/kodustech/apis/kodus-api.md) · [All operations](https://skmtc.net/kodustech/apis/kodus-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kodustech/kodus-api/revisions/e2282ac5fb3a/schema)