---
title: "Add Facts"
method: POST
path: "/interactions/{id}/facts/"
tags: ["Facts"]
---

# Add Facts

`POST /interactions/{id}/facts/`

Adds new facts to an interaction.

## Path parameters

- `id` string, uuid, required

## Headers

- `Tenant-Name` string, required — Identifies a distinct entity within Corti's multi-tenant system. Ensures correct routing and authentication of the request.

## Request body

- FactsCreateRequest
  - `facts` FactsCreateInput[], required — A list of facts to be created.
    - `text` string, required — The text content of the fact.
    - `group` string, required — The key identifying the group to which the fact belongs.
    - `source` 'core' | 'system' | 'user'

## Response `200`

Returns the created facts, including their unique identifiers and associated metadata.

- FactsCreateResponse
  - `facts` FactsCreateItem[], required — A list of successfully created facts.
    - `id` string, uuid — The unique identifier of the newly created fact.
    - `text` string — The textual content of the created fact.
    - `group` string — The group key categorizing the fact.
    - `groupId` string, uuid
    - `source` 'core' | 'system' | 'user'
    - `isDiscarded` boolean — Indicates whether the fact has been marked as discarded by an end-user.
    - `updatedAt` string, date-time — The timestamp when the fact was last updated.

## Other responses

- `504` — RFC9457

---

[API](https://skmtc.net/corti/apis/admin-api.md) · [All operations](https://skmtc.net/corti/apis/admin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/corti/admin-api/versions/5d1895a1b3fc/schema)