---
title: "Upsert Prompt"
method: PUT
path: "/agent-knowledge/system-prompts"
tags: ["agent-knowledge"]
---

# Upsert Prompt

`PUT /agent-knowledge/system-prompts`

## Headers

- `If-Match-Revision` integer, nullable

## Request body

- UpsertSystemPromptEntryRequest
  - `scope` 'organization' | 'channel' | 'user', required
  - `channelId` string, nullable
  - `userId` string, nullable
  - `title` string, required
  - `promptText` string, required

## Response `200`

Successful Response

- SystemPromptEntryResponse
  - `id` string, required
  - `scope` 'organization' | 'channel' | 'user', required
  - `channelId` string, nullable
  - `userId` string, nullable
  - `title` string, required
  - `promptText` string, required
  - `promptSha256` string, required
  - `revision` integer, required
  - `createdByUserId` string, nullable
  - `updatedByUserId` string, nullable
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/traversal/apis/fastapi.md) · [All operations](https://skmtc.net/traversal/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/traversal/fastapi/revisions/2134ebffd1ef/schema)