Skip to content
Ordinal
Esc
↑↓navigate↵open⌘Jpreview

List inline comments on a post

Returns inline comments (text-anchored comments) from all channels on a post. Optionally filter by channel or resolution status.

GET/posts/{postId}/inline-comments
Authorization
AuthorizationBearer token · headerrequired

API key authentication. Generate an API key from your workspace settings.

Path parameters
postIdstring<uuid>required

Post ID (UUID)

Query parameters
channelstring

Filter by channel

Allowed:LinkedInTwitterInstagramFacebookThreadsTikTokDiscordSlackWebflowYouTubeShorts
resolvedboolean

Filter by resolution status

Responses
200

List of inline comments

inlineCommentsInlineComment[]
Show properties
Array of InlineComment
idstring

Unique identifier for the inline comment thread

resolvedboolean

Whether the comment thread has been marked as resolved

channelstring

The channel this comment is on (LinkedIn, Twitter, etc.)

highlightedTextstring

The text that was highlighted when the comment was created

repliesInlineCommentReply[]

Array of replies in the thread

Show properties
Array of InlineCommentReply
idstring

Unique identifier for the reply

userCommentUser

User who created a comment

Show properties
idstring<uuid>
firstNamestring | null
lastNamestring | null
emailstring<email>
messagestring

The reply text. Mentions use the format @[Display Name](userId)

createdAtstring<date-time>

When the reply was created

reactionsInlineCommentReaction[]

Array of emoji reactions on this reply

Show properties
Array of InlineCommentReaction
emojistring

The emoji used for the reaction

usersCommentUser[]

Array of users who added this reaction

createdAtstring<date-time>

When the thread was created

updatedAtstring<date-time> | null

When the thread was last updated

401

Unauthorized - Missing or invalid API key

codestring
messagestring
404

Not Found - Resource does not exist

codestring
messagestring
Try it
Server
Authorization
Parameters
Request
curl -X GET 'https://app.tryordinal.com/api/v1/posts/497f6eca-6276-4993-bfeb-53cbbbba6f08/inline-comments' \
  -H 'Authorization: Bearer YOUR_TOKEN'
Response
{
  "inlineComments": [
    {
      "id": "th_abc123xyz",
      "resolved": false,
      "channel": "LinkedIn",
      "highlightedText": "innovative approach to marketing",
      "replies": [
        {
          "id": "cm_def456uvw",
          "user": {
            "id": "550e8400-e29b-41d4-a716-446655440001",
            "firstName": "John",
            "lastName": "Doe",
            "email": "john@example.com"
          },
          "message": "Should we rephrase this? @[Jane Smith](550e8400-e29b-41d4-a716-446655440002)",
          "createdAt": "2026-02-04T10:30:00.000Z",
          "reactions": [
            {
              "emoji": "👍",
              "users": [
                {
                  "id": "550e8400-e29b-41d4-a716-446655440002",
                  "firstName": "Jane",
                  "lastName": "Smith",
                  "email": "jane@example.com"
                }
              ]
            }
          ]
        }
      ],
      "createdAt": "2026-02-04T10:30:00.000Z",
      "updatedAt": "2026-02-04T10:45:00.000Z"
    }
  ]
}