Florality

GET

/api/v1/messaging/channels/{channelId}/messages/around

messaging: read1,000 requests/minute/key · all plans

Active API keys: Free 1, Pro 5, Pro+ 5. The request rate is the same on every plan.

Message storage

Message text is encrypted at rest and decrypted for authorised requests. Channel access is restricted to spaces owned by the API key’s account; missing or inaccessible channels return 404. Editing or deleting a message additionally checks its author and can return 403.

Parameters

Path parameters

Name	Type	Required	Description
`channelId`	`string (uuid)`	Required	Identifier of the channel.

Query parameters

Name	Type	Required	Description
`anchorMessageId`	`string (uuid)`	Required	Filter or option: anchor message id.
`beforeLimit`	`integer`	Optional	Filter or option: before limit. Default: 50. Minimum: 1. Maximum: 100.
`afterLimit`	`integer`	Optional	Filter or option: after limit. Default: 50. Minimum: 1. Maximum: 100.

Behaviour and pagination

anchorMessageId identifies the message around which to load context. beforeLimit and afterLimit control each side of the anchor.

Response schema

200

Successful response.

Name	Type	Required	Description
`items`	`array<object>`	Required	Items returned by this request.
`items[].id`	`string`	Required	Unique identifier.
`items[].userId`	`null \| string`	Required	Owning account identifier.
`items[].updatedAt`	`number`	Required	Most recent update time.
`items[].createdAt`	`number`	Required	Creation time.
`items[].deletedAt`	`null \| number`	Required	Deletion time; null when active.
`items[].version`	`number`	Required	Version used for optimistic concurrency checks.
`items[].spaceId`	`string`	Required	Space Id.
`items[].channelId`	`string`	Required	Channel Id.
`items[].authorUserId`	`string`	Required	Author User Id.
`items[].authorMemberId`	`null \| string`	Required	Author Member Id.
`items[].authorMemberDisplayName`	`null \| string`	Required	Author Member Display Name.
`items[].authorMemberAvatarRef`	`null \| string`	Required	Author Member Avatar Ref.
`items[].messageType`	`string`	Required	Message Type.
`items[].replyToMessageId`	`null \| string`	Required	Reply To Message Id.
`items[].encryptionVersion`	`number`	Required	Encryption Version.
`items[].encryptionKeyId`	`string`	Required	Encryption Key Id.
`items[].encryptionIv`	`string`	Required	Encryption Iv.
`items[].encryptionAuthTag`	`string`	Required	Encryption Auth Tag.
`items[].contentFormat`	`string`	Required	Content Format.
`items[].gifMetadata`	`JSON value`	Required	Gif Metadata.
`items[].editedAt`	`null \| number`	Required	Edited At.
`items[].content`	`string`	Required	Text content.
`items[].attachments`	`array<object>`	Required	Attachments.
`items[].attachments[].id`	`string`	Required	Unique identifier.
`items[].attachments[].userId`	`null \| string`	Required	Owning account identifier.
`items[].attachments[].createdAt`	`number`	Required	Creation time.
`items[].attachments[].sortOrder`	`number`	Required	Sort Order.
`items[].attachments[].spaceId`	`string`	Required	Space Id.
`items[].attachments[].messageId`	`string`	Required	Message Id.
`items[].attachments[].storageRef`	`string`	Required	Storage Ref.
`items[].attachments[].fileName`	`string`	Required	File Name.
`items[].attachments[].mimeType`	`string`	Required	Mime Type.
`items[].attachments[].byteSize`	`number`	Required	Byte Size.
`items[].attachments[].width`	`null \| number`	Required	Width.
`items[].attachments[].height`	`null \| number`	Required	Height.
`items[].attachments[].durationMs`	`null \| number`	Required	Duration Ms.
`items[].attachments[].attachmentKind`	`string`	Required	Attachment Kind.
`items[].linkPreviews`	`array<object>`	Required	Link Previews.
`items[].linkPreviews[].id`	`string`	Required	Unique identifier.
`items[].linkPreviews[].spaceId`	`string`	Required	Space Id.
`items[].linkPreviews[].channelId`	`string`	Required	Channel Id.
`items[].linkPreviews[].messageId`	`string`	Required	Message Id.
`items[].linkPreviews[].url`	`string`	Required	Url.
`items[].linkPreviews[].canonicalUrl`	`null \| string`	Required	Canonical Url.
`items[].linkPreviews[].finalUrl`	`null \| string`	Required	Final Url.
`items[].linkPreviews[].domain`	`string`	Required	Domain.
`items[].linkPreviews[].siteName`	`null \| string`	Required	Site Name.
`items[].linkPreviews[].title`	`null \| string`	Required	Display title.
`items[].linkPreviews[].description`	`null \| string`	Required	Description of the resource.
`items[].linkPreviews[].imageUrl`	`null \| string`	Required	Image Url.
`items[].linkPreviews[].imageWidth`	`null \| number`	Required	Image Width.
`items[].linkPreviews[].imageHeight`	`null \| number`	Required	Image Height.
`items[].linkPreviews[].faviconUrl`	`null \| string`	Required	Favicon Url.
`items[].linkPreviews[].providerName`	`null \| string`	Required	Provider Name.
`items[].linkPreviews[].status`	`string`	Required	Status. Allowed values: "pending", "blocked", "success", "failed", "dismissed".
`items[].linkPreviews[].errorCode`	`null \| string`	Required	Error Code.
`items[].linkPreviews[].contentType`	`null \| string`	Required	Content Type.
`items[].linkPreviews[].httpStatus`	`null \| number`	Required	Http Status.
`items[].linkPreviews[].previewOrder`	`number`	Required	Preview Order.
`items[].linkPreviews[].fetchedAt`	`null \| number`	Required	Fetched At.
`items[].linkPreviews[].createdAt`	`number`	Required	Creation time.
`items[].linkPreviews[].updatedAt`	`number`	Required	Most recent update time.
`items[].authorMemberAvatarUrl`	`null \| string`	Required	Author Member Avatar Url.
`items[].authorMemberProfileStyle`	`null \| object`	Required	Author Member Profile Style.
`items[].authorMemberProfileStyle.avatarRing`	`object`	Optional	Avatar Ring.
`items[].authorMemberProfileStyle.bannerFrame`	`object`	Optional	Banner Frame.
`items[].authorMemberProfileStyle.memberName`	`object`	Optional	Member Name.
`items[].authorMemberProfileStyle.bannerImage`	`object`	Optional	Banner Image.
`items[].authorMemberProfileStyle.avatarImage`	`object`	Optional	Avatar Image.
`items[].authorMemberProfileStyle.bannerOverlay`	`string`	Optional	Banner Overlay. Allowed values: "none", "vignette", "soft-gradient", "film-grain", "glass-blur", "pattern-dots", "pattern-grid".
`items[].authorMemberProfileStyle.profileBackgroundPattern`	`string`	Optional	Profile Background Pattern. Allowed values: "grid", "none", "dots", "noise".
`items[].authorMemberProfileStyle.heroLayout`	`string`	Optional	Hero Layout. Allowed values: "shell-default", "avatar-centered", "avatar-left".
`items[].authorMemberProfileStyle.accentColorHex`	`null \| string`	Optional	Accent Color Hex.
`items[].authorMemberProfileStyle.profileBackgroundFill`	`object`	Optional	Profile Background Fill.
`items[].authorMemberProfileStyle.pageBackgroundFill`	`object`	Optional	Page Background Fill. Friend-only: full Friends viewport backdrop (solid/gradient).
`items[].authorMemberProfileStyle.panelBackgroundFill`	`object`	Optional	Panel Background Fill. Friend-only: profile card panel fill (free: preset solids; Pro+: custom solid/gradient).
`items[].authorMemberProfileStyle.panelFillAccentHex`	`null \| string`	Optional	Panel Fill Accent Hex. Friend-only: optional accent mixed into the profile panel backdrop (Pro+).
`items[].authorMemberProfileStyle.panelCardAccentHex`	`null \| string`	Optional	Panel Card Accent Hex. Friend-only: optional accent mixed into section cards (Pro+).
`items[].authorMemberSystemTag`	`null \| object`	Required	Author Member System Tag.
`items[].authorMemberSystemTag.name`	`string`	Required	Name of the resource.
`items[].authorMemberSystemTag.code`	`string`	Required	Code.
`items[].authorMemberSystemTag.color`	`string`	Required	Color.
`items[].authorMemberSystemTag.icon`	`string`	Optional	Icon.
`items[].replyTo`	`null \| object`	Required	Reply To.
`items[].replyTo.id`	`string`	Required	Unique identifier.
`items[].replyTo.authorMemberId`	`null \| string`	Required	Author Member Id.
`items[].replyTo.authorMemberDisplayName`	`null \| string`	Required	Author Member Display Name.
`items[].replyTo.authorMemberAvatarUrl`	`null \| string`	Required	Author Member Avatar Url.
`items[].replyTo.authorMemberProfileStyle`	`null \| object`	Required	Author Member Profile Style.
`items[].replyTo.authorMemberSystemTag`	`null \| object`	Required	Author Member System Tag.
`items[].replyTo.snippet`	`string`	Required	Snippet.
`items[].replyTo.deletedAt`	`null \| number`	Required	Deletion time; null when active.
`items[].mentions`	`array<object>`	Required	Mentions.
`items[].mentions[].type`	`string`	Required	Type. Allowed values: "dynamic", "member".
`items[].mentions[].id`	`string`	Required	Unique identifier.
`items[].mentions[].label`	`string`	Required	Label.
`items[].mentions[].href`	`null \| string`	Required	Href.
`items[].mentions[].isVisible`	`boolean`	Required	Is Visible.
`items[].mentions[].fallbackReason`	`string`	Optional	Fallback Reason. Allowed values: "unknown", "hidden", "deleted".
`items[].encryptedContent`	`string`	Required	Encrypted Content. Encrypted stored content included by the current service response.
`hasOlder`	`boolean`	Required	Has Older.
`hasNewer`	`boolean`	Required	Has Newer.
`anchorMessageId`	`string`	Required	Anchor Message Id.
`nextCursor`	`null \| object`	Required	Cursor for the next page; null when there are no further results.
`nextCursor.beforeCreatedAt`	`number`	Required	Creation time in milliseconds of the last message from the previous page.
`nextCursor.beforeId`	`string`	Required	Identifier of the last message from the previous page.

Errors

400 · JSON error: Request failed (BAD_REQUEST).
401 · JSON error: Missing or invalid API key. Use Authorization: Bearer <token>.
403 · JSON error: Requires messaging: read; ownership or feature restrictions may also deny access.
404 · JSON error: Request failed (NOT_FOUND).
409 · JSON error: conflict.
429 · JSON error: API rate limit exceeded (1000 requests per minute). Retry shortly.
500 · JSON error: internal server error.
503 · JSON error: Object storage is not configured. Set MinIO (or compatible S3) env vars to upload files.

Request example

Set FLORALITY_KEY in your environment. These examples use demo identifiers.

Shell

curl --request GET 'https://floralitys.com/api/v1/messaging/channels/11111111-1111-4111-8111-111111111111/messages/around?anchorMessageId=11111111-1111-4111-8111-111111111111' \
  --header "Authorization: Bearer $FLORALITY_KEY"

Responses

Successful response.

JSON

{
  "items": [
    {
      "id": "11111111-1111-4111-8111-111111111111",
      "userId": null,
      "updatedAt": 1767225600000,
      "createdAt": 1767225600000,
      "deletedAt": null,
      "version": 0,
      "spaceId": "11111111-1111-4111-8111-111111111111",
      "channelId": "11111111-1111-4111-8111-111111111111",
      "authorUserId": "11111111-1111-4111-8111-111111111111",
      "authorMemberId": null,
      "authorMemberDisplayName": null,
      "authorMemberAvatarRef": null,
      "messageType": "demo",
      "replyToMessageId": null,
      "encryptionVersion": 0,
      "encryptionKeyId": "11111111-1111-4111-8111-111111111111",
      "encryptionIv": "demo",
      "encryptionAuthTag": "demo",
      "contentFormat": "A note from our demo system.",
      "gifMetadata": {},
      "editedAt": null,
      "content": "A note from our demo system.",
      "attachments": [
        {
          "id": "11111111-1111-4111-8111-111111111111",
          "userId": null,
          "createdAt": 1767225600000,
          "sortOrder": 0,
          "spaceId": "11111111-1111-4111-8111-111111111111",
          "messageId": "11111111-1111-4111-8111-111111111111",
          "storageRef": "demo",
          "fileName": "demo.png",
          "mimeType": "image/png",
          "byteSize": 0,
          "width": null,
          "height": null,
          "durationMs": null,
          "attachmentKind": "demo"
        }
      ],
      "linkPreviews": [
        {
          "id": "11111111-1111-4111-8111-111111111111",
          "spaceId": "11111111-1111-4111-8111-111111111111",
          "channelId": "11111111-1111-4111-8111-111111111111",
          "messageId": "11111111-1111-4111-8111-111111111111",
          "url": "https://example.com/demo",
          "canonicalUrl": null,
          "finalUrl": null,
          "domain": "demo",
          "siteName": null,
          "title": null,
          "description": null,
          "imageUrl": null,
          "imageWidth": null,
          "imageHeight": null,
          "faviconUrl": null,
          "providerName": null,
          "status": "pending",
          "errorCode": null,
          "contentType": null,
          "httpStatus": null,
          "previewOrder": 0,
          "fetchedAt": null,
          "createdAt": 1767225600000,
          "updatedAt": 1767225600000
        }
      ],
      "authorMemberAvatarUrl": null,
      "authorMemberProfileStyle": null,
      "authorMemberSystemTag": null,
      "replyTo": null,
      "mentions": [
        {
          "type": "dynamic",
          "id": "11111111-1111-4111-8111-111111111111",
          "label": "demo",
          "href": null,
          "isVisible": false,
          "fallbackReason": "unknown"
        }
      ],
      "encryptedContent": "A note from our demo system."
    }
  ],
  "hasOlder": false,
  "hasNewer": false,
  "anchorMessageId": "11111111-1111-4111-8111-111111111111",
  "nextCursor": null
}

Example values are illustrative demo data.

GET

/api/v1/messaging/channels/{channelId}/messages/around

messaging: read1,000 requests/minute/key · all plans

Active API keys: Free 1, Pro 5, Pro+ 5. The request rate is the same on every plan.

Message storage

Parameters

Path parameters

Name	Type	Required	Description
`channelId`	`string (uuid)`	Required	Identifier of the channel.

Query parameters

Name	Type	Required	Description
`anchorMessageId`	`string (uuid)`	Required	Filter or option: anchor message id.
`beforeLimit`	`integer`	Optional	Filter or option: before limit. Default: 50. Minimum: 1. Maximum: 100.
`afterLimit`	`integer`	Optional	Filter or option: after limit. Default: 50. Minimum: 1. Maximum: 100.

Behaviour and pagination

anchorMessageId identifies the message around which to load context. beforeLimit and afterLimit control each side of the anchor.

Response schema

200

Successful response.

Name	Type	Required	Description
`items`	`array<object>`	Required	Items returned by this request.
`items[].id`	`string`	Required	Unique identifier.
`items[].userId`	`null \| string`	Required	Owning account identifier.
`items[].updatedAt`	`number`	Required	Most recent update time.
`items[].createdAt`	`number`	Required	Creation time.
`items[].deletedAt`	`null \| number`	Required	Deletion time; null when active.
`items[].version`	`number`	Required	Version used for optimistic concurrency checks.
`items[].spaceId`	`string`	Required	Space Id.
`items[].channelId`	`string`	Required	Channel Id.
`items[].authorUserId`	`string`	Required	Author User Id.
`items[].authorMemberId`	`null \| string`	Required	Author Member Id.
`items[].authorMemberDisplayName`	`null \| string`	Required	Author Member Display Name.
`items[].authorMemberAvatarRef`	`null \| string`	Required	Author Member Avatar Ref.
`items[].messageType`	`string`	Required	Message Type.
`items[].replyToMessageId`	`null \| string`	Required	Reply To Message Id.
`items[].encryptionVersion`	`number`	Required	Encryption Version.
`items[].encryptionKeyId`	`string`	Required	Encryption Key Id.
`items[].encryptionIv`	`string`	Required	Encryption Iv.
`items[].encryptionAuthTag`	`string`	Required	Encryption Auth Tag.
`items[].contentFormat`	`string`	Required	Content Format.
`items[].gifMetadata`	`JSON value`	Required	Gif Metadata.
`items[].editedAt`	`null \| number`	Required	Edited At.
`items[].content`	`string`	Required	Text content.
`items[].attachments`	`array<object>`	Required	Attachments.
`items[].attachments[].id`	`string`	Required	Unique identifier.
`items[].attachments[].userId`	`null \| string`	Required	Owning account identifier.
`items[].attachments[].createdAt`	`number`	Required	Creation time.
`items[].attachments[].sortOrder`	`number`	Required	Sort Order.
`items[].attachments[].spaceId`	`string`	Required	Space Id.
`items[].attachments[].messageId`	`string`	Required	Message Id.
`items[].attachments[].storageRef`	`string`	Required	Storage Ref.
`items[].attachments[].fileName`	`string`	Required	File Name.
`items[].attachments[].mimeType`	`string`	Required	Mime Type.
`items[].attachments[].byteSize`	`number`	Required	Byte Size.
`items[].attachments[].width`	`null \| number`	Required	Width.
`items[].attachments[].height`	`null \| number`	Required	Height.
`items[].attachments[].durationMs`	`null \| number`	Required	Duration Ms.
`items[].attachments[].attachmentKind`	`string`	Required	Attachment Kind.
`items[].linkPreviews`	`array<object>`	Required	Link Previews.
`items[].linkPreviews[].id`	`string`	Required	Unique identifier.
`items[].linkPreviews[].spaceId`	`string`	Required	Space Id.
`items[].linkPreviews[].channelId`	`string`	Required	Channel Id.
`items[].linkPreviews[].messageId`	`string`	Required	Message Id.
`items[].linkPreviews[].url`	`string`	Required	Url.
`items[].linkPreviews[].canonicalUrl`	`null \| string`	Required	Canonical Url.
`items[].linkPreviews[].finalUrl`	`null \| string`	Required	Final Url.
`items[].linkPreviews[].domain`	`string`	Required	Domain.
`items[].linkPreviews[].siteName`	`null \| string`	Required	Site Name.
`items[].linkPreviews[].title`	`null \| string`	Required	Display title.
`items[].linkPreviews[].description`	`null \| string`	Required	Description of the resource.
`items[].linkPreviews[].imageUrl`	`null \| string`	Required	Image Url.
`items[].linkPreviews[].imageWidth`	`null \| number`	Required	Image Width.
`items[].linkPreviews[].imageHeight`	`null \| number`	Required	Image Height.
`items[].linkPreviews[].faviconUrl`	`null \| string`	Required	Favicon Url.
`items[].linkPreviews[].providerName`	`null \| string`	Required	Provider Name.
`items[].linkPreviews[].status`	`string`	Required	Status. Allowed values: "pending", "blocked", "success", "failed", "dismissed".
`items[].linkPreviews[].errorCode`	`null \| string`	Required	Error Code.
`items[].linkPreviews[].contentType`	`null \| string`	Required	Content Type.
`items[].linkPreviews[].httpStatus`	`null \| number`	Required	Http Status.
`items[].linkPreviews[].previewOrder`	`number`	Required	Preview Order.
`items[].linkPreviews[].fetchedAt`	`null \| number`	Required	Fetched At.
`items[].linkPreviews[].createdAt`	`number`	Required	Creation time.
`items[].linkPreviews[].updatedAt`	`number`	Required	Most recent update time.
`items[].authorMemberAvatarUrl`	`null \| string`	Required	Author Member Avatar Url.
`items[].authorMemberProfileStyle`	`null \| object`	Required	Author Member Profile Style.
`items[].authorMemberProfileStyle.avatarRing`	`object`	Optional	Avatar Ring.
`items[].authorMemberProfileStyle.bannerFrame`	`object`	Optional	Banner Frame.
`items[].authorMemberProfileStyle.memberName`	`object`	Optional	Member Name.
`items[].authorMemberProfileStyle.bannerImage`	`object`	Optional	Banner Image.
`items[].authorMemberProfileStyle.avatarImage`	`object`	Optional	Avatar Image.
`items[].authorMemberProfileStyle.bannerOverlay`	`string`	Optional	Banner Overlay. Allowed values: "none", "vignette", "soft-gradient", "film-grain", "glass-blur", "pattern-dots", "pattern-grid".
`items[].authorMemberProfileStyle.profileBackgroundPattern`	`string`	Optional	Profile Background Pattern. Allowed values: "grid", "none", "dots", "noise".
`items[].authorMemberProfileStyle.heroLayout`	`string`	Optional	Hero Layout. Allowed values: "shell-default", "avatar-centered", "avatar-left".
`items[].authorMemberProfileStyle.accentColorHex`	`null \| string`	Optional	Accent Color Hex.
`items[].authorMemberProfileStyle.profileBackgroundFill`	`object`	Optional	Profile Background Fill.
`items[].authorMemberProfileStyle.pageBackgroundFill`	`object`	Optional	Page Background Fill. Friend-only: full Friends viewport backdrop (solid/gradient).
`items[].authorMemberProfileStyle.panelBackgroundFill`	`object`	Optional	Panel Background Fill. Friend-only: profile card panel fill (free: preset solids; Pro+: custom solid/gradient).
`items[].authorMemberProfileStyle.panelFillAccentHex`	`null \| string`	Optional	Panel Fill Accent Hex. Friend-only: optional accent mixed into the profile panel backdrop (Pro+).
`items[].authorMemberProfileStyle.panelCardAccentHex`	`null \| string`	Optional	Panel Card Accent Hex. Friend-only: optional accent mixed into section cards (Pro+).
`items[].authorMemberSystemTag`	`null \| object`	Required	Author Member System Tag.
`items[].authorMemberSystemTag.name`	`string`	Required	Name of the resource.
`items[].authorMemberSystemTag.code`	`string`	Required	Code.
`items[].authorMemberSystemTag.color`	`string`	Required	Color.
`items[].authorMemberSystemTag.icon`	`string`	Optional	Icon.
`items[].replyTo`	`null \| object`	Required	Reply To.
`items[].replyTo.id`	`string`	Required	Unique identifier.
`items[].replyTo.authorMemberId`	`null \| string`	Required	Author Member Id.
`items[].replyTo.authorMemberDisplayName`	`null \| string`	Required	Author Member Display Name.
`items[].replyTo.authorMemberAvatarUrl`	`null \| string`	Required	Author Member Avatar Url.
`items[].replyTo.authorMemberProfileStyle`	`null \| object`	Required	Author Member Profile Style.
`items[].replyTo.authorMemberSystemTag`	`null \| object`	Required	Author Member System Tag.
`items[].replyTo.snippet`	`string`	Required	Snippet.
`items[].replyTo.deletedAt`	`null \| number`	Required	Deletion time; null when active.
`items[].mentions`	`array<object>`	Required	Mentions.
`items[].mentions[].type`	`string`	Required	Type. Allowed values: "dynamic", "member".
`items[].mentions[].id`	`string`	Required	Unique identifier.
`items[].mentions[].label`	`string`	Required	Label.
`items[].mentions[].href`	`null \| string`	Required	Href.
`items[].mentions[].isVisible`	`boolean`	Required	Is Visible.
`items[].mentions[].fallbackReason`	`string`	Optional	Fallback Reason. Allowed values: "unknown", "hidden", "deleted".
`items[].encryptedContent`	`string`	Required	Encrypted Content. Encrypted stored content included by the current service response.
`hasOlder`	`boolean`	Required	Has Older.
`hasNewer`	`boolean`	Required	Has Newer.
`anchorMessageId`	`string`	Required	Anchor Message Id.
`nextCursor`	`null \| object`	Required	Cursor for the next page; null when there are no further results.
`nextCursor.beforeCreatedAt`	`number`	Required	Creation time in milliseconds of the last message from the previous page.
`nextCursor.beforeId`	`string`	Required	Identifier of the last message from the previous page.

Errors

400 · JSON error: Request failed (BAD_REQUEST).
401 · JSON error: Missing or invalid API key. Use Authorization: Bearer <token>.
403 · JSON error: Requires messaging: read; ownership or feature restrictions may also deny access.
404 · JSON error: Request failed (NOT_FOUND).
409 · JSON error: conflict.
429 · JSON error: API rate limit exceeded (1000 requests per minute). Retry shortly.
500 · JSON error: internal server error.
503 · JSON error: Object storage is not configured. Set MinIO (or compatible S3) env vars to upload files.

Request example

Set FLORALITY_KEY in your environment. These examples use demo identifiers.

Shell

curl --request GET 'https://floralitys.com/api/v1/messaging/channels/11111111-1111-4111-8111-111111111111/messages/around?anchorMessageId=11111111-1111-4111-8111-111111111111' \
  --header "Authorization: Bearer $FLORALITY_KEY"

Responses

Successful response.

JSON

{
  "items": [
    {
      "id": "11111111-1111-4111-8111-111111111111",
      "userId": null,
      "updatedAt": 1767225600000,
      "createdAt": 1767225600000,
      "deletedAt": null,
      "version": 0,
      "spaceId": "11111111-1111-4111-8111-111111111111",
      "channelId": "11111111-1111-4111-8111-111111111111",
      "authorUserId": "11111111-1111-4111-8111-111111111111",
      "authorMemberId": null,
      "authorMemberDisplayName": null,
      "authorMemberAvatarRef": null,
      "messageType": "demo",
      "replyToMessageId": null,
      "encryptionVersion": 0,
      "encryptionKeyId": "11111111-1111-4111-8111-111111111111",
      "encryptionIv": "demo",
      "encryptionAuthTag": "demo",
      "contentFormat": "A note from our demo system.",
      "gifMetadata": {},
      "editedAt": null,
      "content": "A note from our demo system.",
      "attachments": [
        {
          "id": "11111111-1111-4111-8111-111111111111",
          "userId": null,
          "createdAt": 1767225600000,
          "sortOrder": 0,
          "spaceId": "11111111-1111-4111-8111-111111111111",
          "messageId": "11111111-1111-4111-8111-111111111111",
          "storageRef": "demo",
          "fileName": "demo.png",
          "mimeType": "image/png",
          "byteSize": 0,
          "width": null,
          "height": null,
          "durationMs": null,
          "attachmentKind": "demo"
        }
      ],
      "linkPreviews": [
        {
          "id": "11111111-1111-4111-8111-111111111111",
          "spaceId": "11111111-1111-4111-8111-111111111111",
          "channelId": "11111111-1111-4111-8111-111111111111",
          "messageId": "11111111-1111-4111-8111-111111111111",
          "url": "https://example.com/demo",
          "canonicalUrl": null,
          "finalUrl": null,
          "domain": "demo",
          "siteName": null,
          "title": null,
          "description": null,
          "imageUrl": null,
          "imageWidth": null,
          "imageHeight": null,
          "faviconUrl": null,
          "providerName": null,
          "status": "pending",
          "errorCode": null,
          "contentType": null,
          "httpStatus": null,
          "previewOrder": 0,
          "fetchedAt": null,
          "createdAt": 1767225600000,
          "updatedAt": 1767225600000
        }
      ],
      "authorMemberAvatarUrl": null,
      "authorMemberProfileStyle": null,
      "authorMemberSystemTag": null,
      "replyTo": null,
      "mentions": [
        {
          "type": "dynamic",
          "id": "11111111-1111-4111-8111-111111111111",
          "label": "demo",
          "href": null,
          "isVisible": false,
          "fallbackReason": "unknown"
        }
      ],
      "encryptedContent": "A note from our demo system."
    }
  ],
  "hasOlder": false,
  "hasNewer": false,
  "anchorMessageId": "11111111-1111-4111-8111-111111111111",
  "nextCursor": null
}

Example values are illustrative demo data.

List messages around anchor

Parameters

Path parameters

Query parameters

Behaviour and pagination

Response schema

200

Errors

Request example

Responses

List messages around anchor

Parameters

Path parameters

Query parameters

Behaviour and pagination

Response schema

200

Errors

Request example

Responses