Skip to content

AHDS Store API (1.0)

Animal Health Data Store - V1 API Documentation

Overview
Languages
Servers
Mock server

https://docs.heydonto.com/_mock/apis/animal-health/openapi/

Local Development

http://localhost:8083/

Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations

Request

Fully replaces an existing Message. All fields must be provided.

Security
bearer
Path
siteIdnumberrequired

Site identifier

messageIdstringrequired

Message unique identifier (UUID)

Bodyapplication/jsonrequired
bodystringrequired

Full content of the message.

channelstringrequired

Primary communication channel used to deliver the message.

Enum"internal""email""sms""phone""push""portal""other"
deliveredAtstringrequired

Timestamp when the message was delivered to the recipient's channel, if known.

Example: "2025-01-01T00:00:00.000Z"
extensionsobjectrequired

Vendor- or practice-specific extensions.

fromobjectrequired

Sender of the message, if known.

messageTypestringrequired

High-level classification of the message.

Enum"system""user""integration""alert""reminder""other"
prioritystringrequired

Relative importance of the message.

Enum"low""normal""high""urgent"
readAtstringrequired

Timestamp when the message was first read, if tracked.

Example: "2025-01-01T00:00:00.000Z"
relatedEntitiesArray of objects(RelatedEntitieDto)required

References to entities this message is about (e.g., animal, appointment, invoice).

relatedEntities[].​displaystring

Optional display label for the related entity.

relatedEntities[].​entityIdstringrequired

Identifier of the related entity.

Example: "123e4567-e89b-12d3-a456-426614174000"
relatedEntities[].​entityTypestringrequired

Type of the related entity.

Enum"animal""client""appointment""invoice""medicalRecord""task""other"
sentAtstringrequired

Timestamp when the message was sent or made available to recipients.

Example: "2025-01-01T00:00:00.000Z"
statusstringrequired

Current lifecycle status of the message.

Enum"draft""queued""sent""delivered""read""failed""cancelled""archived"
subjectstringrequired

Short subject or title of the message.

toArray of objects(ToDto)required

Primary recipients of the message.

to[].​contactIdstring

External contact recipient of the message.

Example: "123e4567-e89b-12d3-a456-426614174000"
to[].​displaystring

Human-readable name of the recipient.

to[].​userIdstring

User recipient of the message.

Example: "123e4567-e89b-12d3-a456-426614174000"
curl -i -X PUT \
  'https://docs.heydonto.com/_mock/apis/animal-health/openapi/site/{siteId}/ahds/v1/message/{messageId}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "body": "string",
    "channel": "internal",
    "deliveredAt": "2025-01-01T00:00:00.000Z",
    "extensions": {},
    "from": {},
    "messageType": "system",
    "priority": "low",
    "readAt": "2025-01-01T00:00:00.000Z",
    "relatedEntities": [
      {
        "display": "string",
        "entityId": "123e4567-e89b-12d3-a456-426614174000",
        "entityType": "animal"
      }
    ],
    "sentAt": "2025-01-01T00:00:00.000Z",
    "status": "draft",
    "subject": "string",
    "to": [
      {
        "contactId": "123e4567-e89b-12d3-a456-426614174000",
        "display": "string",
        "userId": "123e4567-e89b-12d3-a456-426614174000"
      }
    ]
  }'

Responses

Message replaced successfully

Bodyapplication/json
bodystringrequired

Full content of the message.

channelstringrequired

Primary communication channel used to deliver the message.

Enum"internal""email""sms""phone""push""portal""other"
createdAtstring(date-time)required

Timestamp when the message record was created.

Example: "2025-01-01T00:00:00.000Z"
deliveredAtstring(date-time)required

Timestamp when the message was delivered to the recipient's channel, if known.

Example: "2025-01-01T00:00:00.000Z"
extensionsobjectrequired

Vendor- or practice-specific extensions.

fromobjectrequired

Sender of the message, if known.

messageIdstringrequired

Canonical unique identifier for the message.

Example: "123e4567-e89b-12d3-a456-426614174000"
messageTypestringrequired

High-level classification of the message.

Enum"system""user""integration""alert""reminder""other"
prioritystringrequired

Relative importance of the message.

Enum"low""normal""high""urgent"
readAtstring(date-time)required

Timestamp when the message was first read, if tracked.

Example: "2025-01-01T00:00:00.000Z"
relatedEntitiesArray of objects(RelatedEntitieDto)required

References to entities this message is about (e.g., animal, appointment, invoice).

relatedEntities[].​displaystring

Optional display label for the related entity.

relatedEntities[].​entityIdstringrequired

Identifier of the related entity.

Example: "123e4567-e89b-12d3-a456-426614174000"
relatedEntities[].​entityTypestringrequired

Type of the related entity.

Enum"animal""client""appointment""invoice""medicalRecord""task""other"
sentAtstring(date-time)required

Timestamp when the message was sent or made available to recipients.

Example: "2025-01-01T00:00:00.000Z"
statusstringrequired

Current lifecycle status of the message.

Enum"draft""queued""sent""delivered""read""failed""cancelled""archived"
subjectstringrequired

Short subject or title of the message.

toArray of objects(ToDto)required

Primary recipients of the message.

to[].​contactIdstring

External contact recipient of the message.

Example: "123e4567-e89b-12d3-a456-426614174000"
to[].​displaystring

Human-readable name of the recipient.

to[].​userIdstring

User recipient of the message.

Example: "123e4567-e89b-12d3-a456-426614174000"
updatedAtstring(date-time)required

Timestamp when the message record was last updated.

Example: "2025-01-01T00:00:00.000Z"
Response
application/json
{ "body": "string", "channel": "internal", "createdAt": "2025-01-01T00:00:00.000Z", "deliveredAt": "2025-01-01T00:00:00.000Z", "extensions": {}, "from": {}, "messageId": "123e4567-e89b-12d3-a456-426614174000", "messageType": "system", "priority": "low", "readAt": "2025-01-01T00:00:00.000Z", "relatedEntities": [ { … } ], "sentAt": "2025-01-01T00:00:00.000Z", "status": "draft", "subject": "string", "to": [ { … } ], "updatedAt": "2025-01-01T00:00:00.000Z" }

Request

Permanently deletes a Message record.

Security
bearer
Path
siteIdnumberrequired

Site identifier

messageIdstringrequired

Message unique identifier (UUID)

curl -i -X DELETE \
  'https://docs.heydonto.com/_mock/apis/animal-health/openapi/site/{siteId}/ahds/v1/message/{messageId}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Message deleted successfully

Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations
Operations