Skill

foundry-conversations

Name: foundry-conversations
Author: Azure (Microsoft)

manage persistent conversations via Foundry

Published by Azure (Microsoft) Updated Jul 12

Covers Azure Memory Agents

Description

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

SKILL.md

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

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

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

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

Generate a response in a conversation context

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

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)

More skills from the kars repository

View all 11 skills

SkillTagsUpdated

More from Azure (Microsoft)

View publisher

SkillTagsUpdated