Get Editor Session Messages
GET/api/workspaces/:workspace_id/entities/:id/messages/
Fetch system and user messages within an editor session. User should have at least READ permission on the entity to fetch messages.
Request
Path Parameters
A unique integer value identifying this entity.
Query Parameters
Session identifier (UUID)
Responses
- 200
- 400
- 401
- 403
- application/json
- Schema
- Example (from schema)
Schema
Array [
Array [
]
]
Id of the job.
Creation date of the job.
Possible values: non-empty
Human readable label of the job.
Possible values: non-empty
Job method type. It can be one of: pdf, table, svg_and_data, web_and_data, plotly, image_and_data, chat-button, optimise-button, geojson_and_data, plotly_and_data, set-params-button, download-button, ifc_and_data, analyse-button, image, web, geojson, geometry_and_data, svg, data, step-next, ifc, geometry.
Possible values: non-empty
Type of completion. It can be one of: error, error_app_reloading, result, error_user, stopped, expired.
Shows whether error is reported. Errors can be reported when job is finished with ERROR completion type.
Possible values: non-empty
Error message of the job if finished with ERROR_USER completion type.
messages
object[]
required
List of last messages.
Possible values: non-empty
Type of the message. It can be one of success, info, warning, started, error, error_app_reloading, result, error_user, stopped, expired
Possible values: non-empty
Message content.
Timestamp of the message.
[
{
"job_id": 0,
"created_at": "2025-11-07T16:05:09.044Z",
"job_label": "string",
"job_method_type": "string",
"completion_type": "string",
"error_reported": true,
"error_message": "string",
"messages": [
{
"message_type": "string",
"message": "string",
"timestamp": "2025-11-07T16:05:09.044Z"
}
]
}
]
No associated editor session found.
No authentication found or authentication is not correct.
Specified path is not allowed
Permission evaluation:
((Is Authenticated Organization Admin OR Workspace Context Permission) OR Public Permission) AND Is Not App
Descriptions:
Public Permission : Checks corresponding workspace is used public.
Is Authenticated Organization Admin : User must be an Organization Admin.
Workspace Context Permission : Checks whether the user has access rights to the context workspace.
Is Not App : Client must not be a VIKTOR app.