# DurableTaskAddress

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/DurableTasks/DurableTaskAddress.cs#L30)

```csharp
[Orleans.GenerateSerializer]
[Orleans.Immutable]
[Orleans.Alias(Orleans.Durable.Tasks.DurableTaskAddress)]
public readonly struct DurableTaskAddress : IDurableTaskReference, IEquatable<DurableTaskAddress>
```

The address of a durable task which other parties reach: the grain which stores the task and the task's identifier on that grain.

## Remarks

An address is a value which code stores and sends: Orleans serializes it in grain calls and journaled state, and System.Text.Json serializes it as `{"Target":"{grain type}/{grain key}","Id":"{task ID}"}`, so JSON journals and HTTP payloads carry it without registration. [DurableTaskAddressExtensions](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.tasks.durabletaskaddressextensions/) turns it back into a reference, which awaits, polls, cancels, or aborts the task.

An address names a task which its grain retains for other parties: a root task, which a client, a grain, or a durable execution started, including a detached task, or a task which a client or another grain invoked. A grain retains a terminal root task for `DurableTaskOptions.ResultRetentionPeriod`, after which a lookup throws [DurableTaskNotFoundException](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.tasks.durabletasknotfoundexception/).

## Constructors

- [DurableTaskAddress(GrainId, TaskId)](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.tasks.durabletaskaddress/constructors/constructor-orleans-runtime-grainid-orleans-durable-tasks-taskid-cd3d4bb5/)

## Properties

- [Id](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.tasks.durabletaskaddress/properties/id-fffc0f65/)
- [Target](/orleans/docs/api/csharp/microsoft.orleans.durable/orleans.durable.tasks.durabletaskaddress/properties/target-d772a97f/)
