Store an encrypted message - Talaria Developer Documentation

curl --request POST \
  --url "https://cache.example.com/cache/store" \
  --header "Content-Type: application/json" \
  --data '{
    "message_id": "9f8d6f08-bce5-4df5-b22b-bf8c6bd4e143",
    "to": "did:talaria:1111111111111111111111",
    "timestamp": "2026-07-24T16:30:00Z",
    "ttl": "24h",
    "payload": {"ciphertext_b64":"<encrypted-message>"},
    "encrypted_header": "<base64-encrypted-header>",
    "header_nonce": "<base64-nonce>",
    "header_key_id": "recipient-key-1",
    "schema_version": "1"
  }'

{
  "accepted": true,
  "deduped": false,
  "message_id": "9f8d6f08-bce5-4df5-b22b-bf8c6bd4e143",
  "recipient": "did:talaria:1111111111111111111111",
  "expires_at": "2026-07-25T16:30:00Z",
  "max_ttl": "PT24H",
  "applied_ttl": "PT24H",
  "chunked": false,
  "proof": {
    "event_type": "delivery",
    "message_id": "9f8d6f08-bce5-4df5-b22b-bf8c6bd4e143",
    "recipient_did": "did:talaria:1111111111111111111111",
    "timestamp": "2026-07-24T16:30:01Z",
    "reason": null,
    "signature": null
  }
}

curl --request POST \
  --url "https://cache.example.com/cache/store" \
  --header "Content-Type: application/json" \
  --data '{
    "message_id": "9f8d6f08-bce5-4df5-b22b-bf8c6bd4e143",
    "to": "did:talaria:1111111111111111111111",
    "timestamp": "2026-07-24T16:30:00Z",
    "ttl": "24h",
    "payload": {"ciphertext_b64":"<encrypted-message>"},
    "encrypted_header": "<base64-encrypted-header>",
    "header_nonce": "<base64-nonce>",
    "header_key_id": "recipient-key-1",
    "schema_version": "1"
  }'

{
  "accepted": true,
  "deduped": false,
  "message_id": "9f8d6f08-bce5-4df5-b22b-bf8c6bd4e143",
  "recipient": "did:talaria:1111111111111111111111",
  "expires_at": "2026-07-25T16:30:00Z",
  "max_ttl": "PT24H",
  "applied_ttl": "PT24H",
  "chunked": false,
  "proof": {
    "event_type": "delivery",
    "message_id": "9f8d6f08-bce5-4df5-b22b-bf8c6bd4e143",
    "recipient_did": "did:talaria:1111111111111111111111",
    "timestamp": "2026-07-24T16:30:01Z",
    "reason": null,
    "signature": null
  }
}

This endpoint stores the same encrypted DDN envelope accepted by a Relay. The Cache validates the outer format and public policy without decrypting the message. Storage is allowed only when the recipient exists, is active, permits Cache use, permits the message tag, and lists this Cache endpoint in an appropriate public service.

Request

curl --request POST \
  --url "https://cache.example.com/cache/store" \
  --header "Content-Type: application/json" \
  --data '{
    "message_id": "9f8d6f08-bce5-4df5-b22b-bf8c6bd4e143",
    "to": "did:talaria:1111111111111111111111",
    "timestamp": "2026-07-24T16:30:00Z",
    "ttl": "24h",
    "payload": {"ciphertext_b64":"<encrypted-message>"},
    "encrypted_header": "<base64-encrypted-header>",
    "header_nonce": "<base64-nonce>",
    "header_key_id": "recipient-key-1",
    "schema_version": "1"
  }'

Response

boolean

required

true when the envelope is accepted.

boolean

required

true when this Cache already held the same message ID.

string

required

ISO-8601 expiration calculated from the message timestamp and applied TTL.

string

required

Maximum duration allowed by recipient and participation policy.

string

required

Duration applied to this entry.

{
  "accepted": true,
  "deduped": false,
  "message_id": "9f8d6f08-bce5-4df5-b22b-bf8c6bd4e143",
  "recipient": "did:talaria:1111111111111111111111",
  "expires_at": "2026-07-25T16:30:00Z",
  "max_ttl": "PT24H",
  "applied_ttl": "PT24H",
  "chunked": false,
  "proof": {
    "event_type": "delivery",
    "message_id": "9f8d6f08-bce5-4df5-b22b-bf8c6bd4e143",
    "recipient_did": "did:talaria:1111111111111111111111",
    "timestamp": "2026-07-24T16:30:01Z",
    "reason": null,
    "signature": null
  }
}

Straight to the point

POST /cache/store
Content-Type: application/json

<encrypted DDN envelope>

Accepted: 202
Same message_id: accepted with deduped: true
Expired or policy-ineligible: rejected

Talaria Cache API Get cached messages

⌘I

​Request

​Response

​Straight to the point

Request

Response

Straight to the point