agentmail-rs 0.3.0

Unofficial typed Rust client for AgentMail (agentmail.to), the email API for agents.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62

use crate::client::NoBody;
use crate::client::scope::{ApiKeys, Scoped};
use crate::{Error, Page, types::*, util::urlish};

impl<S: ApiKeys> Scoped<'_, S> {
    /// POST `{scope}/api-keys`, mint a new API key. The full secret is in
    /// [`CreatedApiKey::api_key`] and is shown only here; store it now.
    pub async fn create_api_key(&self, key: CreateApiKey) -> Result<CreatedApiKey, Error> {
        self.client
            .request(
                reqwest::Method::POST,
                &format!("{}/api-keys", self.base()),
                &[],
                Some(&key),
            )
            .await
    }

    /// GET `{scope}/api-keys`, one page.
    pub async fn list_api_keys(&self, page: Page) -> Result<ApiKeyList, Error> {
        self.client
            .request(
                reqwest::Method::GET,
                &format!("{}/api-keys", self.base()),
                &page.query(),
                None::<&NoBody>,
            )
            .await
    }

    /// Every API key, draining pagination.
    pub async fn list_all_api_keys(&self) -> Result<Vec<ApiKey>, Error> {
        let mut out = Vec::new();
        let mut token = None;
        loop {
            let resp = self
                .list_api_keys(Page {
                    limit: None,
                    page_token: token,
                })
                .await?;
            let next = resp.next_page_token;
            out.extend(resp.api_keys);
            match next {
                Some(t) => token = Some(t),
                None => return Ok(out),
            }
        }
    }

    /// DELETE `{scope}/api-keys/{api_key_id}`.
    pub async fn delete_api_key(&self, api_key_id: &str) -> Result<(), Error> {
        self.client
            .request(
                reqwest::Method::DELETE,
                &format!("{}/api-keys/{}", self.base(), urlish(api_key_id)),
                &[],
                None::<&NoBody>,
            )
            .await
    }
}