Read the newest journal entry

GET

/chats/{chat}/wal/latest

const url = 'https://chat.work.optidata.cloud/api/chats/36/wal/latest';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://chat.work.optidata.cloud/api/chats/36/wal/latest \
  --header 'Authorization: Bearer <token>'

The most recent entry of the conversation’s journal — your starting point when you begin following it. Keep its id and pass it to since/{id}.

A conversation whose journal is still empty answers 200 with an empty object; start from 0 in that case.

Authorizations

bearerAuth

Parameters

Path Parameters

chat

required

integer format: int64

Numeric id of the conversation.

Responses

200

The newest journal entry, or an empty object when the journal is empty.

application/json

object

Monotonic position in the journal. Pass it to since/{id}.

integer format: int64

chat_id

integer format: int64

message_id

The message the entry is about.

integer | null format: int64

guid

string | null

optiwork_session_id

The client session that caused the change. Compare it with your own to skip the echo of your own writes.

string | null

event_class

The kind of change this entry records.

string

event_json

The payload of the change.

object | string | null

created_at

string format: date-time

updated_at

string format: date-time

Examples

empty

Empty journal

{}

401

Missing, malformed or expired authentication key.

application/json

Authentication failures — and a few permission denials — use an error key rather than message.

object

error

required

string

Examples

missing

No bearer token sent

{
  "error": "JWT passport exception: Missing bearer token in request"
}

403

The caller is not a participant of the conversation, or lacks the role the operation requires.

application/json

Generic error envelope used by policy, binding and framework failures.

object

message

required

Human-readable description of the failure.

string

Examples

denied

{
  "message": "This action is unauthorized."
}

404

The resource does not exist, or does not belong to the given conversation.

application/json

Generic error envelope used by policy, binding and framework failures.

object

message

required

Human-readable description of the failure.

string

Examples

missing

{
  "message": "No query results for model [App\\Models\\Chat\\Chat] 99999999"
}

429

Rate limit exceeded. Retry after the window resets.

application/json

Generic error envelope used by policy, binding and framework failures.

object

message

required

Human-readable description of the failure.

string

Examples

throttled

{
  "message": "Too Many Attempts."
}