Create engagement transcript comment | AskElephant

curl -X POST https://app.askelephant.ai/api/v2/engagements/engagement_id/transcript_comments \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "body": "This section needs a follow-up discussion.",
  "anchor": {
    "start_seconds": 62.5,
    "end_seconds": 78,
    "quote_text": "We should revisit the pricing model next quarter."
  }
}'

{
  "object": "transcript_comment",
  "id": "tano_9f8b7c6d5e4a3b2c1d0e",
  "engagement_id": "ngmt_123abc456def789ghi",
  "transcript_timeline_id": "tt_987zyx654wvu321tsr",
  "body": "This section needs a follow-up discussion.",
  "status": "active",
  "anchor": {
    "start_citation": "Speaker 1, 01:02:30",
    "end_citation": "Speaker 1, 01:03:00",
    "start_seconds": 62.5,
    "end_seconds": 78,
    "quote_text": "We should revisit the pricing model next quarter.",
    "speaker_index": 0
  },
  "created_by": "usr_5a4b3c2d1e0f9g8h7i6j",
  "resolved_by": "usr_7h8i9j0k1l2m3n4o5p6q",
  "resolved_at": "2024-01-15T09:30:00Z",
  "created_at": "2024-01-10T14:22:00Z",
  "updated_at": "2024-01-15T09:30:00Z"
}

Creates a transcript comment on a workspace engagement’s transcript timeline. When transcript_timeline_id is omitted, the server resolves to the engagement’s primary transcript timeline. Requires both engagements:read and transcript_comments:write scopes.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

engagement_idstringRequired

Request

This endpoint expects an object.

bodystringRequired1-50000 characters

Transcript comment body text. Leading and trailing whitespace is trimmed server-side; the trimmed value must be at least 1 character. Whitespace-only strings are rejected with 422.

transcript_timeline_idstringOptionalformat: "^tt_[A-Za-z0-9]+$"

Transcript timeline identifier. When omitted, the server resolves to the engagement's primary transcript timeline.

anchorobjectOptional

Response headers

X-Api-Versionstring

Response

Created transcript comment response.

objectenum

Allowed values:

idstringformat: "^tano_[A-Za-z0-9]+$"

engagement_idstringformat: "^ngmt_[A-Za-z0-9]+$"

transcript_timeline_idstringformat: "^tt_[A-Za-z0-9]+$"

bodystring

statusenum

Allowed values:

anchorobject

created_bystringformat: "^usr_[A-Za-z0-9]+$"

resolved_bystring or nullformat: "^usr_[A-Za-z0-9]+$"

resolved_atdatetime or null

created_atdatetime

updated_atdatetime

Errors

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

422

Unprocessable Entity Error

429

Too Many Requests Error

500

Internal Server Error