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
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123

use crate::common::*;

#[tokio::test]
async fn create_domain_returns_records() {
    let (server, client) = client().await;
    Mock::given(method("POST"))
        .and(path("/v0/domains"))
        .and(body_json(serde_json::json!({ "domain": "mail.example.com" })))
        .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!({
            "domain_id": "dom_1",
            "domain": "mail.example.com",
            "status": "pending",
            "feedback_enabled": true,
            "subdomains_enabled": false,
            "records": [
                {"type": "TXT", "name": "mail", "value": "v=spf1 ...", "status": "pending"},
                {"type": "MX", "name": "mail", "value": "feedback-smtp", "status": "pending", "priority": 10}
            ],
            "updated_at": "2026-01-01T00:00:00Z",
            "created_at": "2026-01-01T00:00:00Z"
        })))
        .expect(1)
        .mount(&server)
        .await;

    let domain = client
        .org()
        .create_domain(agentmail::CreateDomain {
            domain: "mail.example.com".into(),
            ..Default::default()
        })
        .await
        .unwrap();
    assert_eq!(domain.domain_id, "dom_1");
    assert_eq!(domain.records.len(), 2);
    assert_eq!(domain.records[1].record_type, "MX");
    assert_eq!(domain.records[1].priority, Some(10));
}

#[tokio::test]
async fn list_get_update_delete_domain() {
    let (server, client) = client().await;
    Mock::given(method("GET"))
        .and(path("/v0/domains"))
        .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!({
            "count": 1, "domains": [{"domain_id": "dom_1", "domain": "a.com"}]
        })))
        .mount(&server)
        .await;
    Mock::given(method("GET"))
        .and(path("/v0/domains/dom_1"))
        .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!({
            "domain_id": "dom_1", "domain": "a.com", "status": "verified"
        })))
        .mount(&server)
        .await;
    Mock::given(method("PATCH"))
        .and(path("/v0/domains/dom_1"))
        .and(body_json(serde_json::json!({ "feedback_enabled": false })))
        .respond_with(ResponseTemplate::new(200).set_body_json(serde_json::json!({
            "domain_id": "dom_1"
        })))
        .mount(&server)
        .await;
    Mock::given(method("DELETE"))
        .and(path("/v0/domains/dom_1"))
        .respond_with(ResponseTemplate::new(200))
        .mount(&server)
        .await;

    assert_eq!(
        client
            .org()
            .list_domains(Default::default())
            .await
            .unwrap()
            .count,
        1
    );
    assert_eq!(
        client
            .org()
            .get_domain("dom_1")
            .await
            .unwrap()
            .status
            .as_deref(),
        Some("verified")
    );
    client
        .org()
        .update_domain(
            "dom_1",
            agentmail::UpdateDomain {
                feedback_enabled: Some(false),
                ..Default::default()
            },
        )
        .await
        .unwrap();
    client.org().delete_domain("dom_1").await.unwrap();
}

#[tokio::test]
async fn verify_domain_and_zone_file() {
    let (server, client) = client().await;
    Mock::given(method("POST"))
        .and(path("/v0/domains/dom_1/verify"))
        .respond_with(ResponseTemplate::new(200))
        .expect(1)
        .mount(&server)
        .await;
    Mock::given(method("GET"))
        .and(path("/v0/domains/dom_1/zone-file"))
        .respond_with(ResponseTemplate::new(200).set_body_string("mail 300 IN TXT \"v=spf1\"\n"))
        .expect(1)
        .mount(&server)
        .await;

    client.org().verify_domain("dom_1").await.unwrap();
    let zone = client.org().get_domain_zone_file("dom_1").await.unwrap();
    assert!(zone.contains("v=spf1"));
}