Automations

Task templates that run on a schedule. Paths are relative to /api/v1.

GET /automations

List the automations: tasks that run on a schedule.

Answers The JSON envelope.

Errors1

Code	Status	Meaning
QUERY_INVALID	400	The request is not valid: a query parameter or a body field is missing, unknown or malformed.

Any operation can also answer the common errors.

POST /automations

Create an automation: a task template that runs every so many minutes, with an optional daily limit and model.

Body

istruzioni

Not yet described.

modello

The model it runs with, as vendor/model-name.

coordinazione

Not yet described.

ripeti

Not yet described.

pianificazione

Not yet described.

taskIdrequired

The task template to start from: an id from GET /api/v1/tasks.

nome

A name for the automation.

intervalloMinutirequired

How often it runs, in minutes.

limiteAlGiorno

The most runs per day.

Answers The JSON envelope.

Errors2

Code	Status	Meaning
AUTOMATION_ORIGIN_FORBIDDEN	403	—
QUERY_INVALID	400	The request is not valid: a query parameter or a body field is missing, unknown or malformed.

Any operation can also answer the common errors.

POST /automations/{automationId}/toggle

Turn an automation on or off.

Path

automationId

The automation.

Body

attivarequired

true or false.

Answers The JSON envelope.

Errors2

Code	Status	Meaning
NOT_FOUND	404	Nothing answers at this address, or the resource it names does not exist.
QUERY_INVALID	400	The request is not valid: a query parameter or a body field is missing, unknown or malformed.

Any operation can also answer the common errors.

POST /automations/{automationId}/coordinazione

Not yet described in this reference: the parameters, fields and errors below are read from the release.

Path

automationId

The automation.

Body

coordinazione

Not yet described.

Answers The JSON envelope.

Errors2

Code	Status	Meaning
NOT_FOUND	404	Nothing answers at this address, or the resource it names does not exist.
QUERY_INVALID	400	The request is not valid: a query parameter or a body field is missing, unknown or malformed.

Any operation can also answer the common errors.

POST /automations/{automationId}/elimina

Delete an automation.

Path

automationId

The automation.

Body

Answers The JSON envelope.

Errors2

Code	Status	Meaning
NOT_FOUND	404	Nothing answers at this address, or the resource it names does not exist.
QUERY_INVALID	400	The request is not valid: a query parameter or a body field is missing, unknown or malformed.

Any operation can also answer the common errors.

POST /automations/{automationId}/modifica

Not yet described in this reference: the parameters, fields and errors below are read from the release.

Path

automationId

The automation.

Body

decisione

Not yet described.

modello

The model, as OpenRouter names it (vendor/model-name), or <provider>:<model> for a provider’s own endpoint; default: the server’s.

coordinazione

Not yet described.

ripeti

Not yet described.

pianificazione

Not yet described.

contesto

Not yet described.

Answers The JSON envelope.

Errors3

Code	Status	Meaning
INTERNAL_ERROR	500	An unexpected error on the server; the Doctor has the detail, under the reference shown.
NOT_FOUND	404	Nothing answers at this address, or the resource it names does not exist.
QUERY_INVALID	400	The request is not valid: a query parameter or a body field is missing, unknown or malformed.

Any operation can also answer the common errors.

POST /automations/{automationId}/esegui

Not yet described in this reference: the parameters, fields and errors below are read from the release.

Path

automationId

The automation.

Body

decisione

Not yet described.

modello

The model, as OpenRouter names it (vendor/model-name), or <provider>:<model> for a provider’s own endpoint; default: the server’s.

coordinazione

Not yet described.

ripeti

Not yet described.

pianificazione

Not yet described.

contesto

Not yet described.

Answers The JSON envelope.

Errors3

Code	Status	Meaning
INTERNAL_ERROR	500	An unexpected error on the server; the Doctor has the detail, under the reference shown.
NOT_FOUND	404	Nothing answers at this address, or the resource it names does not exist.
QUERY_INVALID	400	The request is not valid: a query parameter or a body field is missing, unknown or malformed.

Any operation can also answer the common errors.

POST /automations/{automationId}/ferma

Not yet described in this reference: the parameters, fields and errors below are read from the release.

Path

automationId

The automation.

Body

decisione

Not yet described.

modello

The model, as OpenRouter names it (vendor/model-name), or <provider>:<model> for a provider’s own endpoint; default: the server’s.

coordinazione

Not yet described.

ripeti

Not yet described.

pianificazione

Not yet described.

contesto

Not yet described.

Answers The JSON envelope.

Errors3

Code	Status	Meaning
INTERNAL_ERROR	500	An unexpected error on the server; the Doctor has the detail, under the reference shown.
NOT_FOUND	404	Nothing answers at this address, or the resource it names does not exist.
QUERY_INVALID	400	The request is not valid: a query parameter or a body field is missing, unknown or malformed.

Any operation can also answer the common errors.

POST /automations/{automationId}/runs/{runId}/letta

Not yet described in this reference: the parameters, fields and errors below are read from the release.

Path

automationId

The automation.

runId

The workflow run.

Body

decisione

Not yet described.

modello

The model, as OpenRouter names it (vendor/model-name), or <provider>:<model> for a provider’s own endpoint; default: the server’s.

coordinazione

Not yet described.

ripeti

Not yet described.

pianificazione

Not yet described.

contesto

Not yet described.

Answers The JSON envelope.

Errors3

Code	Status	Meaning
INTERNAL_ERROR	500	An unexpected error on the server; the Doctor has the detail, under the reference shown.
NOT_FOUND	404	Nothing answers at this address, or the resource it names does not exist.
QUERY_INVALID	400	The request is not valid: a query parameter or a body field is missing, unknown or malformed.

Any operation can also answer the common errors.

POST /automations/{automationId}/runs/{runId}/proposta

Not yet described in this reference: the parameters, fields and errors below are read from the release.

Path

automationId

The automation.

runId

The workflow run.

Body

decisione

Not yet described.

modello

The model, as OpenRouter names it (vendor/model-name), or <provider>:<model> for a provider’s own endpoint; default: the server’s.

coordinazione

Not yet described.

ripeti

Not yet described.

pianificazione

Not yet described.

contesto

Not yet described.

Answers The JSON envelope.

Errors3

Code	Status	Meaning
INTERNAL_ERROR	500	An unexpected error on the server; the Doctor has the detail, under the reference shown.
NOT_FOUND	404	Nothing answers at this address, or the resource it names does not exist.
QUERY_INVALID	400	The request is not valid: a query parameter or a body field is missing, unknown or malformed.

Any operation can also answer the common errors.

GET /automations/{automationId}/runs

Not yet described in this reference: the parameters, fields and errors below are read from the release.

Path

automationId

The automation.

Answers The JSON envelope.

Errors2

Code	Status	Meaning
NOT_FOUND	404	Nothing answers at this address, or the resource it names does not exist.
QUERY_INVALID	400	The request is not valid: a query parameter or a body field is missing, unknown or malformed.

Any operation can also answer the common errors.

GET /automations/inbox

Not yet described in this reference: the parameters, fields and errors below are read from the release.

Answers The JSON envelope.

Errors1

Code	Status	Meaning
QUERY_INVALID	400	The request is not valid: a query parameter or a body field is missing, unknown or malformed.

Any operation can also answer the common errors.