openai/codex · error · RemoteControlServerRequestError

remote control {response_kind} failed at `{url}`: HTTP {stat

Error message

remote control {response_kind} failed at `{url}`: HTTP {status}, {headers_str}, body: {body_preview}

What it means

Error "remote control {response_kind} failed at `{url}`: HTTP {status}, {headers_str}, body: {body_preview}" thrown in openai/codex.

Source

Thrown at codex-rs/app-server-transport/src/transport/remote_control/server_api.rs:51

    status: Option<StatusCode>,
    retry_at: Option<OffsetDateTime>,
}

impl RemoteControlServerRequestError {
    fn io_error(
        message: String,
        status: Option<StatusCode>,
        retry_at: Option<OffsetDateTime>,
        timed_out: bool,
    ) -> io::Error {
        let kind = match status {
            Some(StatusCode::UNAUTHORIZED | StatusCode::FORBIDDEN) => ErrorKind::PermissionDenied,
            Some(StatusCode::NOT_FOUND) => ErrorKind::NotFound,
            Some(status) if timed_out && !status.is_client_error() => ErrorKind::TimedOut,
            None if timed_out => ErrorKind::TimedOut,
            Some(_) | None => ErrorKind::Other,
        };
        io::Error::new(
            kind,
            Self {
                message,
                status,
                retry_at,
            },
        )
    }

    fn is_transient(&self, kind: ErrorKind) -> bool {
        kind == ErrorKind::TimedOut
            || self.status.is_none()
            || self.status.is_some_and(|status| {
                status == StatusCode::TOO_MANY_REQUESTS || status.is_server_error()
            })
    }
}

View on GitHub (pinned to 339751715c)

When it happens

Trigger: Thrown at codex-rs/app-server-transport/src/transport/remote_control/server_api.rs:51 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of openai/codex@339751715c (2026-08-25). Data as JSON: /api/errors/2199d0482c63d906. Report an issue: GitHub.