Skip to content

Open a signed single-prompt chat

GET
/ai/text/chat
curl --request GET \
--url 'https://ai.work.optidata.cloud/api/ai/text/chat?request_guid=a305082f-f339-4825-9a40-144077d1f9fa&signature=example'

The target of the URL returned by POST /ai/text/chat/signed. Open the URL exactly as returned — every query parameter is covered by the signature — and the answer streams back as server-sent events. No authentication key is needed.

A URL that was altered answers 403. Once the stored prompt has expired (one hour), the URL answers 401.

request_guid
required
string

Identifies the stored prompt. Part of the signed URL — do not change it.

signature
required
string

Signature over the path and query. Part of the signed URL — do not change it. The signed URL also carries a company identifier parameter (for example owt1=1); keep it as returned.

The answer, streamed as server-sent events. Each message event’s data is a JSON-encoded piece of text; a final content-end event closes the stream.

Media typetext/event-stream
string
Examples
Exampleanswer
id: 0
event: message
data: ""
id: 1
event: message
data: "OK"
id: -1
event: content-end
data: {"time": "2026-10-19 11:27:46"}

The stored prompt is gone — the signed URL is older than one hour. Request a new one.

Media typeapplication/json

Error raised by the application itself.

object
error
required

What went wrong, in the caller’s language.

string
status
required

The HTTP status, repeated.

integer
help

A hint on how to fix the request; may be empty.

string
Examples
Exampleexpired
{
"error": "The request parameters could not be found.",
"status": 401,
"help": "Check if the request GUID is correct and has not expired."
}

The URL was altered or is not a signed URL.

Media typeapplication/json
object
message
string
Examples
Exampleinvalid
{
"message": "Invalid signature."
}