curl --request GET \
--url "https://directory.example.com/delivery-policies/personas/example.com"
Delivery policies
Get a Persona delivery policy
Read the optional ordered routing rules owned by a registered Persona
curl --request GET \
--url "https://directory.example.com/delivery-policies/personas/example.com"
Read the one optional policy attached to a DNS-backed Persona. The Persona must be registered and active, but it may have no policy. An expired or revoked Persona returns
409 persona_inactive rather than exposing an applicable policy.
Request
string
required
The canonical Persona DNS name.
curl --request GET \
--url "https://directory.example.com/delivery-policies/personas/example.com"
Response
200 Response
{
"scope": {
"type": "PERSONA",
"id": "example.com"
},
"policy": {
"policy_id": "0x<64-hex-policy-id>",
"scope": {
"type": "PERSONA",
"id": "example.com"
},
"revision": 4,
"operator_did": "did:openpayload:1111111111111111111111",
"ruleset": [
{
"id": "legal-delivery",
"priority": 100,
"conditions": [
{"type":"TagEquals","value":"Legal"}
],
"action": {
"type": "DeliveryPlan/v1",
"entry_step": "inspection",
"steps": [
{
"id": "inspection",
"operation": "Forward",
"targets": [
{
"service_did": "did:openpayload:1111111111111111111111",
"service_id": "did:openpayload:1111111111111111111111#inspection",
"priority": 100,
"weight": 100
}
]
}
],
"transitions": []
}
}
]
}
}
404 means the Persona has no policy or does not exist. Inspect the error field to distinguish policy_not_found from persona_not_found.
Straight to the point
GET /delivery-policies/personas/{persona}
- Authentication: none
- Persona identifier: DNS name, not a DID
- No policy: normal fall-through behavior