Skip to content
  • Auto
  • Light
  • Dark
Download Beeper

Shared

Shared

ModelsExpand Collapse
type Attachment struct{…}
Type AttachmentType

Attachment type.

Accepts one of the following:
const AttachmentTypeUnknown AttachmentType = "unknown"
const AttachmentTypeImg AttachmentType = "img"
const AttachmentTypeVideo AttachmentType = "video"
const AttachmentTypeAudio AttachmentType = "audio"
Duration float64optional

Duration in seconds (audio/video).

FileName stringoptional

Original filename if available.

FileSize float64optional

File size in bytes if known.

IsGif booloptional

True if the attachment is a GIF.

IsSticker booloptional

True if the attachment is a sticker.

IsVoiceNote booloptional

True if the attachment is a voice note.

MimeType stringoptional

MIME type if known (e.g., 'image/png').

PosterImg stringoptional

Preview image URL for video attachments (poster frame). May be temporary or local-only to this device; download promptly if durable access is needed.

Size AttachmentSizeoptional

Pixel dimensions of the attachment: width/height in px.

Height float64optional
Width float64optional
SrcURL stringoptional

Public URL or local file path to fetch the asset. May be temporary or local-only to this device; download promptly if durable access is needed.

type BaseResponse struct{…}
Success bool
Error stringoptional
type Error struct{…}
Error ErrorError

Error details

Code string

Machine-readable error code

Message string

Error message

Type string

Error type (e.g., invalid_request_error, authentication_error, not_found_error)

Param stringoptional

Parameter that caused the error

type Message struct{…}
ID string

Message ID.

AccountID string

Beeper account ID the message belongs to.

ChatID string

Unique identifier of the chat.

SenderID string

Sender user ID.

SortKey string

A unique key used to sort messages

Timestamp Time

Message timestamp.

formatdate-time
Attachments []Attachmentoptional

Attachments included with this message, if any.

Type AttachmentType

Attachment type.

Accepts one of the following:
const AttachmentTypeUnknown AttachmentType = "unknown"
const AttachmentTypeImg AttachmentType = "img"
const AttachmentTypeVideo AttachmentType = "video"
const AttachmentTypeAudio AttachmentType = "audio"
Duration float64optional

Duration in seconds (audio/video).

FileName stringoptional

Original filename if available.

FileSize float64optional

File size in bytes if known.

IsGif booloptional

True if the attachment is a GIF.

IsSticker booloptional

True if the attachment is a sticker.

IsVoiceNote booloptional

True if the attachment is a voice note.

MimeType stringoptional

MIME type if known (e.g., 'image/png').

PosterImg stringoptional

Preview image URL for video attachments (poster frame). May be temporary or local-only to this device; download promptly if durable access is needed.

Size AttachmentSizeoptional

Pixel dimensions of the attachment: width/height in px.

Height float64optional
Width float64optional
SrcURL stringoptional

Public URL or local file path to fetch the asset. May be temporary or local-only to this device; download promptly if durable access is needed.

IsSender booloptional

True if the authenticated user sent the message.

IsUnread booloptional

True if the message is unread for the authenticated user. May be omitted.

Reactions []Reactionoptional

Reactions to the message, if any.

ID string

Reaction ID, typically ${participantID}${reactionKey} if multiple reactions allowed, or just participantID otherwise.

ParticipantID string

User ID of the participant who reacted.

ReactionKey string

The reaction key: an emoji (😄), a network-specific key, or a shortcode like "smiling-face".

Emoji booloptional

True if the reactionKey is an emoji.

ImgURL stringoptional

URL to the reaction's image. May be temporary or local-only to this device; download promptly if durable access is needed.

SenderName stringoptional

Resolved sender display name (impersonator/full name/username/participant name).

Text stringoptional

Plain-text body if present. May include a JSON fallback with text entities for rich messages.

type Reaction struct{…}
ID string

Reaction ID, typically ${participantID}${reactionKey} if multiple reactions allowed, or just participantID otherwise.

ParticipantID string

User ID of the participant who reacted.

ReactionKey string

The reaction key: an emoji (😄), a network-specific key, or a shortcode like "smiling-face".

Emoji booloptional

True if the reactionKey is an emoji.

ImgURL stringoptional

URL to the reaction's image. May be temporary or local-only to this device; download promptly if durable access is needed.

type User struct{…}

User the account belongs to.

ID string

Stable Beeper user ID. Use as the primary key when referencing a person.

CannotMessage booloptional

True if Beeper cannot initiate messages to this user (e.g., blocked, network restriction, or no DM path). The user may still message you.

Email stringoptional

Email address if known. Not guaranteed verified.

FullName stringoptional

Display name as shown in clients (e.g., 'Alice Example'). May include emojis.

ImgURL stringoptional

Avatar image URL if available. May be temporary or local-only to this device; download promptly if durable access is needed.

IsSelf booloptional

True if this user represents the authenticated account's own identity.

PhoneNumber stringoptional

User's phone number in E.164 format (e.g., '+14155552671'). Omit if unknown.

Username stringoptional

Human-readable handle if available (e.g., '@alice'). May be network-specific and not globally unique.