/agents/{id}/query

Get Retrieval Info

Return metadata of the contents used to generate the response for a given message.

get/agents/{agent_id}/query/{message_id}/retrieval/info

Request

Base URL
https://api.contextual.ai/v1
URL
https://api.contextual.ai/v1/agents/{agent_id}/query/{message_id}/retrieval/info
Auth
HTTP bearer

agent_idstring uuid required

ID of the agent which sent the provided message.

message_idstring uuid required

ID of the message for which the content metadata needs to be retrieved.

content_idsstring[] required

List of content ids for which to get the metadata.

Successful Response

Oct 16, 20264abdda722de9 Revision changes
- breaking
  added to the / response property oneOf list for the response status
- info
  added contextual_agent_response discriminator mapping keys to the / response property for the response status
Oct 28, 2025c8152db45500 Revision changes
- breaking
  added to the / response property oneOf list for the response status
- info
  added file_analysis discriminator mapping keys to the / response property for the response status