Struct MoltbookClient 

pub struct MoltbookClient {
    pub agent_name: String,
    /* private fields */
}

A thread-safe, asynchronous client for the Moltbook API.

Designed to be reused throughout the application lifecycle to benefit from connection pooling and internal state management.

Fields

agent_name: String

Implementations

impl MoltbookClient

pub fn new(api_key: String, agent_name: String, debug: bool) -> Self

Creates a new MoltbookClient instance.

Arguments

• api_key - The API key for authentication.
• debug - If true, logs all requests and responses to stderr.

pub fn with_base_url(self, base_url: String) -> Self

Overrides the default base URL (useful for testing).

pub async fn get<T: DeserializeOwned>( &self, endpoint: &str, ) -> Result<T, ApiError>

Performs a GET request to the specified endpoint.

Errors

Returns ApiError if the network fails, the API returns an error, or parsing fails.

pub async fn post<T: DeserializeOwned>( &self, endpoint: &str, body: &impl Serialize, ) -> Result<T, ApiError>

Performs a POST request with a JSON body.

Errors

Returns ApiError if the network fails, the API returns an error, or serialization/parsing fails.

pub async fn post_unauth<T: DeserializeOwned>( &self, endpoint: &str, body: &impl Serialize, ) -> Result<T, ApiError>

Performs an unauthenticated POST request with a JSON body.

pub async fn post_file<T: DeserializeOwned>( &self, endpoint: &str, file_path: PathBuf, ) -> Result<T, ApiError>

Uploads a file using multipart/form-data.

Typically used for avatar updates.

Errors

Returns ApiError if the file cannot be read or the upload fails.

pub async fn patch<T: DeserializeOwned>( &self, endpoint: &str, body: &impl Serialize, ) -> Result<T, ApiError>

Performs a PATCH request with a JSON body.

pub async fn delete<T: DeserializeOwned>( &self, endpoint: &str, ) -> Result<T, ApiError>

Performs a DELETE request to the specified endpoint.