Texa DeskDevelopers

Texa API · Widgets

What was said since a line: late replies, people's answers

GET/v1/widget/conversations/{conversation_id}/lines

What was said after line after: replies that came later and people's answers; documents Texa AI sent after card after_card; screen actions this page should run now (requests). Poll it every few seconds while the chat is open. Pass the last changed as seen: a poll with nothing new is then cheap; fresh=1 reads everything (after a send, and every few polls).

Authorization

Authorizationheaderrequired

A widget session's token (wst_…), made on your server with POST /v1/widget-sessions, or a visitor session from your site key. It reaches only that customer's conversation.

Path parameters

conversation_idstringrequired

Query parameters

afterinteger
after_cardinteger
seenstring
freshboolean

Responses

200

OK

cardsarray of object
cards[].contentstring
cards[].idinteger
cards[].kindstring

One of: file, sheet.

cards[].namestring
cards[].rowsinteger
cards[].urlstring
changedstring
linesarray of object
lines[].fromstring

One of: customer, texa, person.

lines[].ninteger
lines[].textstring
previewboolean
requestsarray of object
requests[].actionstring
requests[].expires_atstring
requests[].inputsobject
requests[].request_idstring
withstring
400

400: The request is not valid; error.field names the part / 401: No key, or not a live one / 402: The account's prepaid credits are used up; top up in Texa Desk / 403: The key cannot do this (a sandbox route needs a test key) / 404: No such route, or nothing with that id in this account / 409: A conflict: the conversation's state, or an Idempotency-Key reused / 422: The body is not what this route takes / 429: Too many requests: wait Retry-After seconds / 503: Texa AI is not answering right now: retry after Retry-After seconds

errorobject
error.codestring
error.fieldstring
error.messagestring
error.typestring
401

400: The request is not valid; error.field names the part / 401: No key, or not a live one / 402: The account's prepaid credits are used up; top up in Texa Desk / 403: The key cannot do this (a sandbox route needs a test key) / 404: No such route, or nothing with that id in this account / 409: A conflict: the conversation's state, or an Idempotency-Key reused / 422: The body is not what this route takes / 429: Too many requests: wait Retry-After seconds / 503: Texa AI is not answering right now: retry after Retry-After seconds

errorobject
error.codestring
error.fieldstring
error.messagestring
error.typestring
402

400: The request is not valid; error.field names the part / 401: No key, or not a live one / 402: The account's prepaid credits are used up; top up in Texa Desk / 403: The key cannot do this (a sandbox route needs a test key) / 404: No such route, or nothing with that id in this account / 409: A conflict: the conversation's state, or an Idempotency-Key reused / 422: The body is not what this route takes / 429: Too many requests: wait Retry-After seconds / 503: Texa AI is not answering right now: retry after Retry-After seconds

errorobject
error.codestring
error.fieldstring
error.messagestring
error.typestring
403

400: The request is not valid; error.field names the part / 401: No key, or not a live one / 402: The account's prepaid credits are used up; top up in Texa Desk / 403: The key cannot do this (a sandbox route needs a test key) / 404: No such route, or nothing with that id in this account / 409: A conflict: the conversation's state, or an Idempotency-Key reused / 422: The body is not what this route takes / 429: Too many requests: wait Retry-After seconds / 503: Texa AI is not answering right now: retry after Retry-After seconds

errorobject
error.codestring
error.fieldstring
error.messagestring
error.typestring
404

400: The request is not valid; error.field names the part / 401: No key, or not a live one / 402: The account's prepaid credits are used up; top up in Texa Desk / 403: The key cannot do this (a sandbox route needs a test key) / 404: No such route, or nothing with that id in this account / 409: A conflict: the conversation's state, or an Idempotency-Key reused / 422: The body is not what this route takes / 429: Too many requests: wait Retry-After seconds / 503: Texa AI is not answering right now: retry after Retry-After seconds

errorobject
error.codestring
error.fieldstring
error.messagestring
error.typestring
409

400: The request is not valid; error.field names the part / 401: No key, or not a live one / 402: The account's prepaid credits are used up; top up in Texa Desk / 403: The key cannot do this (a sandbox route needs a test key) / 404: No such route, or nothing with that id in this account / 409: A conflict: the conversation's state, or an Idempotency-Key reused / 422: The body is not what this route takes / 429: Too many requests: wait Retry-After seconds / 503: Texa AI is not answering right now: retry after Retry-After seconds

errorobject
error.codestring
error.fieldstring
error.messagestring
error.typestring
422

400: The request is not valid; error.field names the part / 401: No key, or not a live one / 402: The account's prepaid credits are used up; top up in Texa Desk / 403: The key cannot do this (a sandbox route needs a test key) / 404: No such route, or nothing with that id in this account / 409: A conflict: the conversation's state, or an Idempotency-Key reused / 422: The body is not what this route takes / 429: Too many requests: wait Retry-After seconds / 503: Texa AI is not answering right now: retry after Retry-After seconds

errorobject
error.codestring
error.fieldstring
error.messagestring
error.typestring
429

400: The request is not valid; error.field names the part / 401: No key, or not a live one / 402: The account's prepaid credits are used up; top up in Texa Desk / 403: The key cannot do this (a sandbox route needs a test key) / 404: No such route, or nothing with that id in this account / 409: A conflict: the conversation's state, or an Idempotency-Key reused / 422: The body is not what this route takes / 429: Too many requests: wait Retry-After seconds / 503: Texa AI is not answering right now: retry after Retry-After seconds

errorobject
error.codestring
error.fieldstring
error.messagestring
error.typestring
503

400: The request is not valid; error.field names the part / 401: No key, or not a live one / 402: The account's prepaid credits are used up; top up in Texa Desk / 403: The key cannot do this (a sandbox route needs a test key) / 404: No such route, or nothing with that id in this account / 409: A conflict: the conversation's state, or an Idempotency-Key reused / 422: The body is not what this route takes / 429: Too many requests: wait Retry-After seconds / 503: Texa AI is not answering right now: retry after Retry-After seconds

errorobject
error.codestring
error.fieldstring
error.messagestring
error.typestring