# Foundry Conversations

> Manage persistent conversations via Foundry Conversations API. Create conversations, add messages, and maintain history across sessions.

- Skill: `azure/foundry-conversations` (Agent Skill)
- Install (CLI): `npx skillmds@latest add azure/foundry-conversations`
- Raw SKILL.md: https://api.skillmd.com/api/skills/azure/foundry-conversations/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: Azure (https://skillmd.com/u/azure)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/azure/foundry-conversations

---


# Foundry Conversations — Persistent Conversation Management

You can create and manage persistent conversations via the Foundry Conversations API. Conversations store message history server-side, enabling multi-turn interactions that survive session boundaries.

## Endpoint

All requests: `http://localhost:8443` with `?api-version=2025-11-15-preview`. Auth is automatic.

## Operations

### Create a conversation

```bash
curl -s -X POST 'http://localhost:8443/openai/conversations?api-version=2025-11-15-preview' \
  -H 'Content-Type: application/json' \
  -d '{"metadata":{"user":"user-123","topic":"onboarding"}}'
```

Returns `{"id":"conv_abc123","object":"conversation",...}`.

### Add messages to a conversation

```bash
curl -s -X POST 'http://localhost:8443/openai/conversations/conv_abc123/items?api-version=2025-11-15-preview' \
  -H 'Content-Type: application/json' \
  -d '{"items":[{"type":"message","role":"user","content":[{"type":"input_text","text":"Hello!"}]}]}'
```

### List conversations

```bash
curl -s 'http://localhost:8443/openai/conversations?api-version=2025-11-15-preview'
```

### Generate a response in a conversation context

```bash
curl -s -X POST 'http://localhost:8443/openai/responses?api-version=2025-11-15-preview' \
  -H 'Content-Type: application/json' \
  -d '{"model":"gpt-4.1","input":"What did we discuss?","conversation":"conv_abc123"}'
```

### Delete a conversation

```bash
curl -s -X DELETE 'http://localhost:8443/openai/conversations/conv_abc123?api-version=2025-11-15-preview'
```

## When to use

- Multi-turn conversations where server-side history is needed
- Building chat applications with conversation persistence
- When you need to reference previous messages by conversation ID

## When NOT to use

- For stateless one-off queries (use /v1/chat/completions)
- For long-term user preferences (use foundry-memory skill)