{
  "opencollection": "1.0.0",
  "info": {
    "name": "Clarifeye Platform Agent Settings Conversations API",
    "version": "1.0.0"
  },
  "request": {
    "auth": {
      "type": "bearer",
      "token": "{{bearerToken}}"
    }
  },
  "items": [
    {
      "info": {
        "name": "Conversations",
        "type": "folder"
      },
      "items": [
        {
          "info": {
            "name": "List conversations",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://eu.app.clarifeye.ai/api/v1/projects/:project_id/playground-conversations/",
            "headers": [
              {
                "name": "X-Impersonate-Email",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "project_id",
                "value": "",
                "type": "path",
                "description": "UUID of the project"
              },
              {
                "name": "tags",
                "value": "analysis,review",
                "type": "query",
                "description": "Filter by tags (OR logic). Can be specified multiple times or comma-separated."
              },
              {
                "name": "no_tags",
                "value": "",
                "type": "query",
                "description": "Set to \"true\" to filter for conversations with no tags"
              },
              {
                "name": "text",
                "value": "",
                "type": "query",
                "description": "Search text within chat history (case-insensitive)"
              },
              {
                "name": "include_archived",
                "value": "",
                "type": "query",
                "description": "Set to \"true\" to include archived conversations in results. Defaults to false (active conversations only)."
              },
              {
                "name": "limit",
                "value": "",
                "type": "query",
                "description": "Maximum number of results per page"
              },
              {
                "name": "offset",
                "value": "",
                "type": "query",
                "description": "Number of results to skip for pagination"
              }
            ]
          },
          "docs": "Retrieve all conversations for a project with optional filtering.\n\n**Access Control:**\n- Admins see all conversations (including shared ones)\n- Regular users see only conversations they created (including their own shared ones)\n- Shared conversations from other users are not shown in the list but are accessible via direct URL\n\n**Impersonation:**\n- When using impersonation, returns conversations created by the impersonated user\n\n**Filtering:**\n- Tags filtering uses OR logic (matches any of the pr"
        },
        {
          "info": {
            "name": "Create conversation",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://eu.app.clarifeye.ai/api/v1/projects/:project_id/playground-conversations/",
            "headers": [
              {
                "name": "X-Impersonate-Email",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "project_id",
                "value": "",
                "type": "path",
                "description": "UUID of the project"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Create a new AI-powered conversation.\n\n**Impersonation:**\n- When using impersonation, the conversation is created as the impersonated user\n"
        },
        {
          "info": {
            "name": "Get conversation",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://eu.app.clarifeye.ai/api/v1/projects/:project_id/playground-conversations/:conversation_id/",
            "params": [
              {
                "name": "project_id",
                "value": "",
                "type": "path",
                "description": "UUID of the project"
              },
              {
                "name": "conversation_id",
                "value": "",
                "type": "path",
                "description": "UUID of the conversation"
              },
              {
                "name": "include_archived",
                "value": "",
                "type": "query",
                "description": "Set to \"true\" to allow retrieving an archived conversation. Defaults to false."
              }
            ]
          },
          "docs": "Retrieve a conversation with its complete chat history.\n\n**Access Control:**\n- Admins can access any conversation\n- Regular users can access their own conversations\n- All project members can access shared conversations via direct URL\n"
        },
        {
          "info": {
            "name": "Archive conversation",
            "type": "http"
          },
          "http": {
            "method": "DELETE",
            "url": "https://eu.app.clarifeye.ai/api/v1/projects/:project_id/playground-conversations/:conversation_id/",
            "headers": [
              {
                "name": "X-Impersonate-Email",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "project_id",
                "value": "",
                "type": "path",
                "description": "UUID of the project"
              },
              {
                "name": "conversation_id",
                "value": "",
                "type": "path",
                "description": "UUID of the conversation"
              }
            ]
          },
          "docs": "Soft-archive a conversation. The conversation is hidden from default list/get endpoints\nbut is preserved in the database along with all linked feedback.\n\nTo permanently delete an archived conversation, use the `permanent_delete` action.\nTo restore an archived conversation, use the `unarchive` action.\n\n**Access Control:**\n- Admins can archive any conversation\n- Regular users can only archive conversations they created\n\n**Impersonation:**\n- When using impersonation, the ownership check is performe"
        },
        {
          "info": {
            "name": "Unarchive conversation",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://eu.app.clarifeye.ai/api/v1/projects/:project_id/playground-conversations/:conversation_id/unarchive/",
            "headers": [
              {
                "name": "X-Impersonate-Email",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "project_id",
                "value": "",
                "type": "path",
                "description": "UUID of the project"
              },
              {
                "name": "conversation_id",
                "value": "",
                "type": "path",
                "description": "UUID of the conversation"
              }
            ]
          },
          "docs": "Restore a previously archived conversation back to active status.\n\n**Access Control:**\n- Admins can unarchive any conversation\n- Regular users can only unarchive conversations they created\n"
        },
        {
          "info": {
            "name": "Permanently delete conversation",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://eu.app.clarifeye.ai/api/v1/projects/:project_id/playground-conversations/:conversation_id/permanent_delete/",
            "params": [
              {
                "name": "project_id",
                "value": "",
                "type": "path",
                "description": "UUID of the project"
              },
              {
                "name": "conversation_id",
                "value": "",
                "type": "path",
                "description": "UUID of the conversation"
              }
            ]
          },
          "docs": "Permanently delete an archived conversation and all its associated feedbacks.\nThis action is irreversible.\n\nThe conversation must be archived first (via the DELETE endpoint) before it can be permanently deleted.\n\n**Access Control:**\n- Superusers only, or project members with `CAN_PERFORM_ADMIN_ACTIONS` permission\n"
        },
        {
          "info": {
            "name": "Send message (streaming)",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://eu.app.clarifeye.ai/api/v1/projects/:project_id/playground-conversations/:conversation_id/send_message_stream/",
            "headers": [
              {
                "name": "X-Impersonate-Email",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "project_id",
                "value": "",
                "type": "path",
                "description": "UUID of the project"
              },
              {
                "name": "conversation_id",
                "value": "",
                "type": "path",
                "description": "UUID of the conversation"
              }
            ],
            "body": {
              "type": "json",
              "data": "{}"
            }
          },
          "docs": "Send a message and receive a streaming response using Server-Sent Events (SSE).\n\nThe response is a stream of newline-delimited JSON events. Use this endpoint for both\ninitial messages and follow-up messages - conversation context is automatically preserved.\n\n**Access Control:**\n- For shared conversations, only the creator or admins can send messages\n- Other project members can view shared conversations but cannot send messages\n\n**Impersonation:**\n- When using impersonation, the message is sent a"
        },
        {
          "info": {
            "name": "Get all conversation tags",
            "type": "http"
          },
          "http": {
            "method": "GET",
            "url": "https://eu.app.clarifeye.ai/api/v1/projects/:project_id/playground-conversations/all-tags/",
            "headers": [
              {
                "name": "X-Impersonate-Email",
                "value": ""
              }
            ],
            "params": [
              {
                "name": "project_id",
                "value": "",
                "type": "path",
                "description": "UUID of the project"
              }
            ]
          },
          "docs": "Retrieve all unique tags used across conversations in the project.\n\n**Access Control:**\n- Admins see tags from all conversations\n- Regular users see only tags from conversations they created\n\n**Impersonation:**\n- When using impersonation, returns tags from conversations created by the impersonated user\n"
        },
        {
          "info": {
            "name": "Share conversation",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://eu.app.clarifeye.ai/api/v1/projects/:project_id/playground-conversations/:conversation_id/share/",
            "params": [
              {
                "name": "project_id",
                "value": "",
                "type": "path",
                "description": "UUID of the project"
              },
              {
                "name": "conversation_id",
                "value": "",
                "type": "path",
                "description": "UUID of the conversation"
              }
            ]
          },
          "docs": "Share a conversation with all workspace members.\n\nWhen shared:\n- The conversation becomes accessible to all project members via direct URL\n- The conversation is hidden from the conversation list (to reduce clutter)\n- Only the creator and admins can send messages (read-only for others)\n\n**Access Control:**\n- Only the conversation creator or project admins can share a conversation\n"
        },
        {
          "info": {
            "name": "Unshare conversation",
            "type": "http"
          },
          "http": {
            "method": "POST",
            "url": "https://eu.app.clarifeye.ai/api/v1/projects/:project_id/playground-conversations/:conversation_id/unshare/",
            "params": [
              {
                "name": "project_id",
                "value": "",
                "type": "path",
                "description": "UUID of the project"
              },
              {
                "name": "conversation_id",
                "value": "",
                "type": "path",
                "description": "UUID of the conversation"
              }
            ]
          },
          "docs": "Remove sharing from a conversation.\n\nWhen unshared:\n- The conversation returns to the creator's conversation list\n- Other project members lose access to the conversation\n\n**Access Control:**\n- Only the conversation creator or project admins can unshare a conversation\n"
        }
      ]
    }
  ],
  "bundled": true
}