Skip to main content

openai_interface/responses/
retrieve.rs

1//! Retrieve a stored response via `GET /responses/{response_id}`.
2//!
3//! Only responses created with `store: true` can be retrieved. Provider
4//! support varies: Qwen supports this endpoint, while DeepSeek's Responses
5//! API is stateless and does not store responses.
6
7use url::Url;
8
9use crate::{
10    errors::OapiError,
11    rest::get::{Get, GetNoStream},
12};
13
14/// Retrieves a previously created response by its ID.
15#[derive(Debug, Clone)]
16pub struct RetrieveRequest<'a> {
17    /// The ID of the response to retrieve, e.g. `resp_...`.
18    pub response_id: &'a str,
19}
20
21impl Get for RetrieveRequest<'_> {
22    /// Builds the URL for the request.
23    ///
24    /// `base_url` should be like <https://api.openai.com/v1>
25    fn build_url(&self, base_url: &str) -> Result<String, OapiError> {
26        let mut url = Url::parse(base_url.trim_end_matches('/')).map_err(OapiError::UrlError)?;
27        url.path_segments_mut()
28            .map_err(|_| OapiError::UrlCannotBeBase(base_url.to_string()))?
29            .push("responses")
30            .push(self.response_id);
31        Ok(url.to_string())
32    }
33}
34
35impl GetNoStream for RetrieveRequest<'_> {
36    type Response = crate::responses::Response;
37}