Evaluations

Endpoints to evaluate expressions and manage active evaluations.

Method	Path	Description	Parameters	Payload
POST	/evaluations	Evaluate an expression	-	-	expression
GET	/evaluations	Retrieve active evaluations	-	-	-
GET	/evaluations/id	Retrieve the evaluation with a given ID	-	-	-
DELETE	/evaluations/id	Cancel the evaluation with a given ID	-	-	-
POST	/evaluations/id/pause	Pause the evaluation with a given ID	-	-
POST	/evaluations/id/resume	Resume the evaluation with a given ID	-	-

About evaluations and processes

The term evaluation in the context of this API is rather vague as it encompasses both an expression issued for its evaluation and the actual process of such evaluation. It is likely that the target Smalltalk system implements this by means of some sort of process. In this sense, an evaluation can suspended and resumed, or even terminated, much as its corresponding process in the backend can. See /evaluations/id/pause and /evaluations/id/resume for an example on pausing, debugging and resuming an evaluation.