---
title: "Commit a bounded turn packet"
method: POST
path: "/v1/profile/commit"
tags: ["Profile"]
---

# Commit a bounded turn packet

`POST /v1/profile/commit`

## Request

- Base URL: `https://api.configure.dev`
- URL: `https://api.configure.dev/v1/profile/commit`
- Auth: one of:
  - API key in header `X-API-Key` and HTTP bearer
  - API key in header `X-API-Key` and API key in header `X-User-Id`

Requires a secret key plus Bearer auth or X-User-Id. Use this for bounded turn evidence after a read-backed turn, not historical bulk import. Explicit memories are optional durable facts/preferences.

## Headers

- `X-Agent` string

## Request body

- union
  - object
    - `user_id` string
    - `memories` string[], required
    - `messages` ConversationMessage[]
      - `role` 'user' | 'assistant' | 'tool', required
      - `content` string, required
      - `toolName` string
    - `toolResults` object[]
      - `toolName` string, required
      - `content` union, required
        - string
        - object
    - `memory_criteria` string
    - `sync` boolean
  - object
    - `user_id` string
    - `memories` string[]
    - `messages` ConversationMessage[], required
      - `role` 'user' | 'assistant' | 'tool', required
      - `content` string, required
      - `toolName` string
    - `toolResults` object[]
      - `toolName` string, required
      - `content` union, required
        - string
        - object
    - `memory_criteria` string
    - `sync` boolean
  - object
    - `user_id` string
    - `memories` string[]
    - `messages` ConversationMessage[]
      - `role` 'user' | 'assistant' | 'tool', required
      - `content` string, required
      - `toolName` string
    - `toolResults` object[], required
      - `toolName` string, required
      - `content` union, required
        - string
        - object
    - `memory_criteria` string
    - `sync` boolean

## Response `200`

Completed commit.

- object

## Other responses

- `202`: Async commit accepted.

---

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