--- title: "Get message details." method: GET path: "/api/v1/projects/{projectId}/conversations/{sessionId}/messages/{promptId}" tags: ["Message"] --- # Get message details. `GET /api/v1/projects/{projectId}/conversations/{sessionId}/messages/{promptId}` ## Request - Base URL: `https://app.customgpt.ai` - URL: `https://app.customgpt.ai/api/v1/projects/{projectId}/conversations/{sessionId}/messages/{promptId}` - Auth: HTTP bearer - TypeScript: (a function with typed inputs; its response is checked against the schema) 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. ## Path parameters - `projectId` integer, required - `sessionId` string, required - `promptId` integer, required ## Query parameters - `includeInsights` boolean ## Response `200` Retrieve certain conversation message - object - `status` 'error' | 'success': The status of the response - `data` PromptHistory - `id` integer: The unique identifier of the prompt history. - `conversation_id` integer: The unique identifier of the conversation. - `user_id` integer: The unique identifier of the user. - `user_query` string: The user prompt query. - `openai_response` string: The OpenAI response to the user prompt query. - `citations` integer[]: The citations for the prompt history. - `citations_external` object[]: External (web/agentic) source citations referenced in the response. Empty when the response cited no external sources. - `source_id` string: Opaque per-type identifier of the external source. - `type` string: External source type (e.g. web, mcp, file, sharepoint). - `action` string, nullable: The agentic action that produced the citation. - `title` string: Title of the external source. - `url` string: Absolute http(s) URL of the external source. - `description` string: Short snippet/description of the external source. - `citations_hidden` integer[]: Page ids the response drew on that were hidden from the citations shown to the user, either by the agent-level sources setting or per page. Debugging aid, never rendered in the chat UI. - `tools` string[]: Array of tools invoked during response generation (e.g., web search, document retrieval). Returns an empty array if no tools were used. - `metadata` object: Additional metadata associated with this message, such as custom session attributes passed via the API. Returns null if no metadata was set. - `user_ip` string: The IP address of the user. - `user_agent` string: The user agent of the user. - `external_id` string: The external ID of the prompt history. - `request_source` string: The source of the request. - `response_feedback` object, nullable: User feedback submitted for this response. Includes the reaction rating and any text feedback. Returns null if the user has not provided feedback. - `created_at` string, date-time: The timestamp when the feedback was created - `updated_at` string, date-time: The timestamp when the feedback was last updated - `user_id` integer, nullable: The ID of the user who provided the feedback - `reaction` 'neutral' | 'disliked' | 'liked': User reaction to this response. - `customer_intelligence` CustomerIntelligence: Customer intelligence data captured for this conversation turn, populated when the lead capture feature is enabled. Contains contact information and intent signals. Returns null if lead capture is disabled. - `prompt_id` integer: Unique identifier for the prompt - `conversation_id` integer: Unique identifier for the conversation - `project_id` integer: Unique identifier for the project - `user_query` string: The user's original query - `ai_response` string: The AI's response to the query - `created_at` string: Timestamp when the interaction occurred - `content_source` string: Detected content source - `user_emotion` string: Detected user emotion - `user_intent` string: Detected user intent - `language` string: Detected language - `human_request` 'true' | 'false' | 'unclear': Whether the user requested a human - `user_id` integer: Sent-by user identifier. -2 indicates SSO Guest, -1 indicates Guest, and positive values indicate team member user IDs. - `feedback` string, nullable: User feedback on the response - `user_location` string: User's location (country code) - `chatbot_deployment` string: Chatbot deployment source - `risk_fidelity` string: Risk fidelity level - `risk_jailbreak` string: Jailbreak risk assessment - `risk_prompt_leakage` string: Prompt leakage risk assessment - `risk_profanity` string: Profanity risk assessment - `accuracy` string: Response accuracy assessment - `stakeholder_status` string: Stakeholder status classification - `browser` string: User's browser information - `created_at` string, date-time: The date and time the prompt history was created. - `updated_at` string, date-time: The date and time the prompt history was last updated. ## Other responses - `400`: Bad Argument - `401`: API Token is either missing or invalid - `404`: Conversation message not found - `429`: Too many requests. You have exceeded your API rate limit. - `500`: Internal Server Error ## Changes - **2026-11-03** `77aab4354382`: 1 breaking, 7 warning, 7 info - the response property `data/response_feedback` became nullable for the status `200` - added the new `422.00` enum value to the `data/code` response property for the response status `400` - added the new `422.00` enum value to the `data/code` response property for the response status `401` - added the new `422.00` enum value to the `data/code` response property for the response status `404` - …11 more - **2026-07-17** `b80e6dfcf78d`: 1 info - endpoint added - **2023-06-02** `1842d7fd0430`: 1 breaking - api path removed without deprecation [Operation history](https://skmtc.dev/poll-the-people/apis/customgpt-ai/changes/api/v1/projects/:projectId/conversations/:sessionId/messages/:promptId/get.md) --- [API](https://skmtc.dev/poll-the-people/apis/customgpt-ai.md) - [All operations](https://skmtc.dev/poll-the-people/apis/customgpt-ai/llms.txt) - [OpenAPI document](https://skmtc.dev/poll-the-people/apis/customgpt-ai/revisions/77aab4354382?raw)