Direct Messages (DMs)

Direct Message related API endpoints:

Create/Insert DM Chat Message (1-to-1 messaging)

post

For DMs, Chatitem data struct is used to store each message and associated info. REQUIRED: fromaddr, toaddr, message (see data struct section at bottom of page for more detailed info on each paramter) Other fields are generally filled in by the backed REST API and used as return parameters ID is auto generated and should never be used as input.

Authorizations

Body

encrypted_sym_lit_keystringoptional

USE IF USING LIT ENCRYPTION

fromaddrstringrequired

*** REQUIRED INPUT ***

idintegeroptional

AUTO-GENERATED (PRIMARY KEY)

lit_access_conditionsstringoptional

messagestringrequired

*** REQUIRED INPUT ***

nftaddrstringoptional

ONLY USED FOR NFT DM CONTEXT

nftidstringoptional

ONLY USED FOR NFT DM CONTEXT

readbooleanoptional

DEFAULT FALSE

sender_namestringoptional

AUTO-SET BY BACKED FOR RETURN VALUE

timestampstringoptional

AUTO-SET BY REST API

timestamp_dtmstringoptional

USED FOR SORTING WHEN TIME FORMAT NEEDED

toaddrstringrequired

*** REQUIRED INPUT ***

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url '/v1/create_chatitem' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "encrypted_sym_lit_key": "text",
    "fromaddr": "text",
    "id": 1,
    "lit_access_conditions": "text",
    "message": "text",
    "nftaddr": "text",
    "nftid": "text",
    "read": true,
    "sender_name": "text",
    "timestamp": "text",
    "timestamp_dtm": "text",
    "toaddr": "text"
  }'

application/json

200

200

[
  {
    "encrypted_sym_lit_key": "text",
    "fromaddr": "text",
    "id": 1,
    "lit_access_conditions": "text",
    "message": "text",
    "nftaddr": "text",
    "nftid": "text",
    "read": true,
    "sender_name": "text",
    "timestamp": "text",
    "timestamp_dtm": "text",
    "toaddr": "text"
  }
]

OK

Delete Single Chat Item (DM)

delete

Can only delete messages sent, cannot delete incoming messages

Authorizations

Path parameters

idanyrequired

message ID

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url '/v1/delete_chatitem/{id}' \
  --header 'Authorization: YOUR_API_KEY'

204

204

No body

No Content

Delete All Chat Items (DMs) between FROM and TO given addresses

delete

Currently deletes all chat items between these two addresses

Authorizations

Path parameters

toaddranyrequired

TO: Address

fromaddranyrequired

FROM: Address

Responses

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request DELETE \
  --url '/v1/deleteall_chatitems/{fromaddr}/{toaddr}' \
  --header 'Authorization: YOUR_API_KEY'

204

204

No body

No Content

Get Chat Item For Given Wallet Address

get

Get all Chat Items for DMs for a given wallet address

Authorizations

Path parameters

toaddranyrequired

Wallet Address

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v1/getall_chatitems/{address}' \
  --header 'Authorization: YOUR_API_KEY'

200

200

[
  {
    "encrypted_sym_lit_key": "text",
    "fromaddr": "text",
    "id": 1,
    "lit_access_conditions": "text",
    "message": "text",
    "nftaddr": "text",
    "nftid": "text",
    "read": true,
    "sender_name": "text",
    "timestamp": "text",
    "timestamp_dtm": "text",
    "toaddr": "text"
  }
]

OK

Get Chat Data Between Two Addresses

get

Get chat data between the given two addresses, TO and FROM and interchangable here

Authorizations

Path parameters

toaddranyrequired

TO: Wallet Address

fromanyrequired

FROM: Wallet Address

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v1/getall_chatitems/{fromaddr}/{toaddr}' \
  --header 'Authorization: YOUR_API_KEY'

200

200

[
  {
    "encrypted_sym_lit_key": "text",
    "fromaddr": "text",
    "id": 1,
    "lit_access_conditions": "text",
    "message": "text",
    "nftaddr": "text",
    "nftid": "text",
    "read": true,
    "sender_name": "text",
    "timestamp": "text",
    "timestamp_dtm": "text",
    "toaddr": "text"
  }
]

OK

Get Chat Data Between Two Addresses

get

Get chat data between the given two addresses, TO and FROM and interchangable here

Authorizations

Path parameters

toaddranyrequired

TO: Wallet Address

fromanyrequired

FROM: Wallet Address

timeanyrequired

Load only messages after this time

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url '/v1/getall_chatitems/{fromaddr}/{toaddr}/${time}' \
  --header 'Authorization: YOUR_API_KEY'

200

200

[
  {
    "encrypted_sym_lit_key": "text",
    "fromaddr": "text",
    "id": 1,
    "lit_access_conditions": "text",
    "message": "text",
    "nftaddr": "text",
    "nftid": "text",
    "read": true,
    "sender_name": "text",
    "timestamp": "text",
    "timestamp_dtm": "text",
    "toaddr": "text"
  }
]

OK

Update Message Read Status of a given DM chat message

put

Currently this only update the message read/unread status. It could update the entire JSON struct upon request, however we only needed this functionality currently and it saved re-encryption of the data. TODO: TO/FROM address in the URL is not needed/not used anymore.

Authorizations

Body

encrypted_sym_lit_keystringoptional

USE IF USING LIT ENCRYPTION

fromaddrstringrequired

*** REQUIRED INPUT ***

idintegeroptional

AUTO-GENERATED (PRIMARY KEY)

lit_access_conditionsstringoptional

messagestringrequired

*** REQUIRED INPUT ***

nftaddrstringoptional

ONLY USED FOR NFT DM CONTEXT

nftidstringoptional

ONLY USED FOR NFT DM CONTEXT

readbooleanoptional

DEFAULT FALSE

sender_namestringoptional

AUTO-SET BY BACKED FOR RETURN VALUE

timestampstringoptional

AUTO-SET BY REST API

timestamp_dtmstringoptional

USED FOR SORTING WHEN TIME FORMAT NEEDED

toaddrstringrequired

*** REQUIRED INPUT ***

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request PUT \
  --url '/v1/update_chatitem/{fromaddr}/{toaddr}' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json' \
  --data '{
    "encrypted_sym_lit_key": "text",
    "fromaddr": "text",
    "id": 1,
    "lit_access_conditions": "text",
    "message": "text",
    "nftaddr": "text",
    "nftid": "text",
    "read": true,
    "sender_name": "text",
    "timestamp": "text",
    "timestamp_dtm": "text",
    "toaddr": "text"
  }'

application/json

200

200

[
  {
    "encrypted_sym_lit_key": "text",
    "fromaddr": "text",
    "id": 1,
    "lit_access_conditions": "text",
    "message": "text",
    "nftaddr": "text",
    "nftid": "text",
    "read": true,
    "sender_name": "text",
    "timestamp": "text",
    "timestamp_dtm": "text",
    "toaddr": "text"
  }
]

OK