Token FactoryAPI Reference
Playground
Create a playground conversation.
Playground
Prefix: /api/v1/agent-playground
See Overview for authentication.
Playground conversations are stored as normal AI conversations and tagged AGENT_PLAYGROUND. The server sets that tag on create. A value sent in conversationRequestor is replaced.
Endpoint summary
| Method | Path |
|---|---|
| POST | /conversations |
Create a conversation
POST /api/v1/agent-playground/conversations
Content-Type: application/json
Authorization: Bearer YOUR_API_TOKEN
{
"conversationTitle": "Compare Gemma and Nemotron",
"conversationDescription": "Same prompt, two models"
}| Field | Required | Description |
|---|---|---|
conversationTitle | no | Title shown in the conversation list |
conversationDescription | no | Short description |
fileIds | no | UUIDs of files already stored for this tenant. Unknown ids are dropped |
Response 200
{
"id": "77777777-7777-7777-7777-777777777777",
"conversationTitle": "Compare Gemma and Nemotron",
"conversationDescription": "Same prompt, two models",
"fileIds": [],
"createdAt": "2026-10-30T05:20:00Z",
"lastActivityAt": "2026-10-30T05:20:00Z",
"conversationRequestor": "AGENT_PLAYGROUND"
}