POpoll-the-people
Task Messages

Get task message.

Changed on

Returns the complete details for a single message, including the user's prompt, the agent's response, timestamps, citations, and any attached metadata. Use this to retrieve specific messages for display or analysis.

get/api/v1/projects/{projectId}/tasks/{taskId}/messages/{promptHistoryId}

Request

Path parameters

projectIdinteger required
Example:1

The ID of the agent

taskIdstring required
Example:f1b9aaf0-5e4e-11eb-ae93-0242ac130002

The task ID

promptHistoryIdinteger required
Example:42

The unique identifier of the message

Response

The requested task message.

status'error' | 'success'

The status of the response

Example response

{
  "status": "success",
  "data": {
    "id": 101,
    "conversation_id": 42,
    "user_id": 1,
    "user_query": "What file formats does CustomGPT support?",
    "openai_response": "CustomGPT supports PDF, DOCX, TXT, and more. You can also ingest content via sitemap, URL, or file upload.",
    "citations": [
      3,
      7
    ],
    "citations_external": [
      {
        "source_id": "1-1",
        "type": "web",
        "action": "web_search",
        "title": "Paris - Wikipedia",
        "url": "https://en.wikipedia.org/wiki/Paris",
        "description": "Paris is the capital of France."
      }
    ],
    "citations_hidden": [
      12
    ],
    "tools": [],
    "metadata": {
      "user_ip": "203.0.113.12",
      "user_agent": "Mozilla/5.0",
      "external_id": "ext_id_abc123",
      "request_source": "web"
    },
    "response_feedback": {
      "created_at": "2024-08-27T21:07:20.000000Z",
      "updated_at": "2024-08-27T21:07:20.000000Z",
      "user_id": 1,
      "reaction": "liked"
    },
    "customer_intelligence": {
      "prompt_id": 101,
      "conversation_id": 42,
      "project_id": 7,
      "user_query": "What file formats does CustomGPT support?",
      "ai_response": "CustomGPT supports PDF, DOCX, TXT, and more.",
      "created_at": "2026-02-01T09:20:00.000000Z",
      "content_source": "in-context",
      "user_emotion": "neutral",
      "user_intent": "informational",
      "language": "en",
      "human_request": "false",
      "user_id": -2,
      "user_location": "US",
      "chatbot_deployment": "web",
      "risk_fidelity": "Good",
      "risk_jailbreak": "no_event",
      "risk_prompt_leakage": "no_event",
      "risk_profanity": "no_event",
      "accuracy": "-",
      "stakeholder_status": "UNKNOWN",
      "browser": "Chrome 121"
    },
    "created_at": "2026-02-01T09:20:00.000000Z",
    "updated_at": "2026-02-01T09:20:05.000000Z",
    "files": []
  }
}

Changes