# IOutbox

Package: [Microsoft.Orleans.Durable](/orleans/docs/api/csharp/microsoft.orleans.durable/) 10.0.0-alpha.1

[Source](https://github.com/dotnet/orleans/blob/6a0e937f544c35ffcf11b37e4c2b7de5a1580a03/src/Orleans.Durable/Messaging/IOutbox.cs#L19)

```csharp
public interface IOutbox
```

Stages opaque durable messages alongside a grain's journaled business state.

## Remarks

The outbox state machine's asynchronous write preparation establishes a durable self-wakeup before capture. Its write-completion callback makes captured messages eligible for dispatch. Each wakeup checks the grain's messages and their retry deadlines. Messages remain pending until the destination acknowledges durable acceptance, recognizes a duplicate, or reports a terminal delivery outcome. The outbox journals each send's [InboxMessage](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.messaging.inboxmessage/); every attempt, backpressure, and recovery reuse it, and retries end `OutboxRetryTimeout` after it. Applications use [IOutbox](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.messaging.ioutbox/) and [IOutboxMessageSource](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.messaging.ioutboxmessagesource/) to stage crash-recoverable responses to terminal outcomes in the same journal write as retirement. Applications namespace command identities and define ordering in their protocols.

## Methods

- [Register(IOutboxMessageSource)](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.messaging.ioutbox/methods/register-orleans-durable-messaging-ioutboxmessagesource-11a1d48f/)
- [Send(MessageId)](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.messaging.ioutbox/methods/send-orleans-durable-messaging-messageid-00f5628d/)
- [Send(OutboxMessage)](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.messaging.ioutbox/methods/send-orleans-durable-messaging-outboxmessage-d5b84894/)
- [Withdraw(MessageId)](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.messaging.ioutbox/methods/withdraw-orleans-durable-messaging-messageid-ef7463a7/)
