agentmail-rs 0.2.1

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

use serde::{Deserialize, Serialize};

/// Request body for [`Client::create_webhook`](crate::Client::create_webhook).
#[derive(Clone, Debug, Default, Serialize)]
pub struct CreateWebhook {
    /// HTTPS endpoint to deliver events to.
    pub url: String,
    /// e.g. `["message.received"]`.
    pub event_types: Vec<String>,
    /// Limit delivery to these inboxes; empty means all.
    #[serde(skip_serializing_if = "Vec::is_empty")]
    pub inbox_ids: Vec<String>,
    /// Limit delivery to these pods; empty means all.
    #[serde(skip_serializing_if = "Vec::is_empty")]
    pub pod_ids: Vec<String>,
    /// Your own idempotency/reference id for this webhook.
    #[serde(skip_serializing_if = "Option::is_none")]
    pub client_id: Option<String>,
}

/// Request body for [`Client::update_webhook`](crate::Client::update_webhook). Every field is optional; leave
/// a field empty to keep it unchanged. Inbox and pod targeting is edited by
/// delta (add/remove lists) rather than by replacing the whole set.
#[derive(Clone, Debug, Default, Serialize)]
pub struct UpdateWebhook {
    /// Replace the subscribed event types.
    #[serde(skip_serializing_if = "Vec::is_empty")]
    pub event_types: Vec<String>,
    /// Inboxes to add to the subscription.
    #[serde(skip_serializing_if = "Vec::is_empty")]
    pub add_inbox_ids: Vec<String>,
    /// Inboxes to remove from the subscription.
    #[serde(skip_serializing_if = "Vec::is_empty")]
    pub remove_inbox_ids: Vec<String>,
    /// Pods to add to the subscription.
    #[serde(skip_serializing_if = "Vec::is_empty")]
    pub add_pod_ids: Vec<String>,
    /// Pods to remove from the subscription.
    #[serde(skip_serializing_if = "Vec::is_empty")]
    pub remove_pod_ids: Vec<String>,
}
/// A webhook subscription, as the API returns it.
#[derive(Clone, Debug, Deserialize)]
pub struct Webhook {
    /// Unique id, used to delete the subscription.
    pub webhook_id: String,
    /// The subscribed HTTPS endpoint.
    pub url: String,
    /// Signing secret, returned once, on creation.
    #[serde(default)]
    pub secret: Option<String>,
    /// Subscribed event types.
    #[serde(default)]
    pub event_types: Vec<String>,
    /// Inboxes the subscription is limited to; empty means all.
    #[serde(default)]
    pub inbox_ids: Vec<String>,
    /// Pods the subscription is limited to; empty means all.
    #[serde(default)]
    pub pod_ids: Vec<String>,
    /// Whether the subscription currently delivers.
    pub enabled: bool,
    /// Your own reference id, echoed back if set on creation.
    #[serde(default)]
    pub client_id: Option<String>,
    /// Timestamp the subscription was last updated (RFC 3339).
    #[serde(default)]
    pub updated_at: Option<String>,
    /// Timestamp the subscription was created (RFC 3339).
    #[serde(default)]
    pub created_at: Option<String>,
}
/// One page of webhooks from [`Client::list_webhooks_page`](crate::Client::list_webhooks_page).
#[derive(Clone, Debug, Deserialize)]
pub struct WebhookList {
    /// Total webhooks in the account (not just this page).
    pub count: u64,
    /// This page of webhooks.
    #[serde(default)]
    pub webhooks: Vec<Webhook>,
    /// Cursor for the next page; `None` on the last page.
    #[serde(default)]
    pub next_page_token: Option<String>,
}