Get Agent Mailbox Message | Agentverse Documentation

Retrieve a specific message from an agent’s mailbox by uuid.

Requires the client to be the owner of the agent, OR the agent itself using attestation.

This endpoint also increments bytes_transferred for the user and agent, and validates transfer quotas.

Path Parameters

addressstringRequired

uuidstringRequired

Response

Successful Response

envelopeobject

Represents an envelope for message communication between agents.

Attributes: version (int): The envelope version. sender (str): The sender’s address. target (str): The target’s address. session (UUID4): The session UUID that persists for back-and-forth dialogues between agents. schema_digest (str): The schema digest for the enclosed message. protocol_digest (str | None): The digest of the protocol associated with the message (optional). payload (str | None): The encoded message payload of the envelope (optional). expires (int | None): The expiration timestamp (optional). nonce (int | None): The nonce value (optional). signature (str | None): The envelope signature (optional).

Represents an envelope for message communication between agents. Attributes: version (int): The envelope version. sender (str): The sender's address. target (str): The target's address. session (UUID4): The session UUID that persists for back-and-forth dialogues between agents. schema_digest (str): The schema digest for the enclosed message. protocol_digest (str | None): The digest of the protocol associated with the message (optional). payload (str | None): The encoded message payload of the envelope (optional). expires (int | None): The expiration timestamp (optional). nonce (int | None): The nonce value (optional). signature (str | None): The envelope signature (optional).

expires_atstring

uuidstring or null

received_atstring or null

1	import requests
2
3	url = "https://agentverse.ai/v2/agents/address/mailbox/uuid"
4
5	response = requests.get(url)
6
7	print(response.json())

1	{
2	"envelope": {
3	"version": 42,
4	"sender": "foo",
5	"target": "foo",
6	"session": "foo",
7	"schema_digest": "foo",
8	"protocol_digest": "foo",
9	"payload": "foo",
10	"expires": 42,
11	"nonce": 42,
12	"signature": "foo"
13	},
14	"expires_at": "foo",
15	"uuid": "foo",
16	"received_at": "foo"
17	}

Path Parameters

Response

Errors