---
title: "mail.agent-inbox@1 · OpenVibe.Services"
canonical: "https://openvibe.services/docs/contracts/mail.agent-inbox"
updated: null
---

# mail.agent-inbox@1 · OpenVibe.Services

HTML: [mail.agent-inbox@1 · OpenVibe.Services](https://openvibe.services/docs/contracts/mail.agent-inbox)

# MailAgentInbox `mail.agent-inbox@1`

Generated at 2026-11-13 06:25:48 UTC from [`openvibe-contracts v0.419.0`](https://github.com/OpenVibers/OpenVibe.Contracts/tree/v0.419.0) and [`openvibe-sdk v0.161.0`](https://github.com/OpenVibers/OpenVibe.SDK/tree/v0.161.0).

- Version: 1.0.0
- Owner: mail
- Visibility: first-party
- Status: active
- Compatibility: backward
- Schema: [`https://openvibe.network/contracts/mail/agent-inbox.v1.json`](/docs/contracts/mail.agent-inbox.json)

An address an agent can read, on the person's own domain: <agent>.<user>@openvibe.email. The mail lands in the person's mailbox, like every other address OpenVibe.Mail hands out; what makes it an agent's inbox is that the service reads it back for the agent acting for that person. One agent has one inbox: asking twice returns the same resource.

## Fields

| Field | Type | Required | Description | Constraints |
| --- | --- | --- | --- | --- |
| `id` | string | yes | The inbox id. Opaque outside OpenVibe.Mail. | - `pattern ^agi_[0-9A-HJKMNP-TV-Z]{26}$` |
| `owner` | string | yes | The Network subject id of the person whose mailbox receives the agent's mail. | - `pattern ^usr_[0-9A-HJKMNP-TV-Z]{26}$` |
| `agent_id` | string | yes | The agent's name in the address, lowercased and cleaned (letters, digits and hyphens). | - `pattern ^[a-z0-9](?:[a-z0-9-]{0,30}[a-z0-9])?$`<br>- `maxLength 32` |
| `address` | string | yes | The agent's address. In M1 the user part is the person's Network username, falling back to their mailbox local when that readable address is already taken. | - `pattern ^[a-z0-9-]+\.[a-z0-9-]+@[a-z0-9](?:[a-z0-9-]*[a-z0-9])?(?:\.[a-z0-9](?:[a-z0-9-]*[a-z0-9])?)+$`<br>- `format email`<br>- `maxLength 254` |
| `created_at` | string | yes | When the inbox was made, ISO 8601 UTC. | - `format date-time` |

## Examples

From the contract's own test fixtures: valid ones validate, rejected ones must fail.

 Valid: helper

~~~~
{
  "id": "agi_01JAB2C3D4E5F6G7H8J9K0MNPQ",
  "owner": "usr_01JAB2C3D4E5F6G7H8J9K0MNPS",
  "agent_id": "helper",
  "address": "helper.alice@openvibe.email",
  "created_at": "2026-11-07T12:00:00Z"
}
~~~~

Rejected: bad-agent

~~~~
{
  "id": "agi_01JAB2C3D4E5F6G7H8J9K0MNPQ",
  "owner": "usr_01JAB2C3D4E5F6G7H8J9K0MNPS",
  "agent_id": "Helper!",
  "address": "helper.alice@openvibe.email",
  "created_at": "2026-11-07T12:00:00Z"
}
~~~~

Rejected: not-an-address

~~~~
{
  "id": "agi_01JAB2C3D4E5F6G7H8J9K0MNPQ",
  "owner": "usr_01JAB2C3D4E5F6G7H8J9K0MNPS",
  "agent_id": "helper",
  "address": "helper",
  "created_at": "2026-11-07T12:00:00Z"
}
~~~~

## Validate

~~~~
const contracts = require('openvibe-contracts');
contracts.validate('mail.agent-inbox@1', value);   // { valid, errors: [{ path, message }] }
~~~~