The operation journal, newest first: `total` (the matching operations) and `migrations`, each with

POST

/datanotes/operations/list_migrations/

curl --request POST \
  --url https://example.com/datanotes/operations/list_migrations/ \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "limit": null, "op": null, "table": null, "since": null }'

The operation journal, newest first: total (the matching operations) and migrations, each with migration_id (for undo_migration), op, summary, table (when it was about one), executed_at, notes_changed, files_changed, undone, undoes, files_failed, by (the agent), and members (a batch’s operations) or batch (the batch of an operation). Filters: op (e.g. “update_rows”), table (substring of the table name, e.g. “personal.tasks.task”), since (ISO date). limit default 50. The journal is kept in the engine’s store, outside the vault (store:journal/); entries older than 90 days are dropped.

Authorizations

• bearer

Request Body

Media typeapplication/json

object

limit

Any of:

integer

integer

null

null

op

Any of:

string

string

null

null

table

Any of:

string

string

null

null

since

Any of:

string

string

null

null

Responses

200

Done.

Media typeapplication/json

object

total

required

Matching operations (before limit).

integer

migrations

required

Newest first.

Array<object>

object

migration_id

required

string

op

required

string

summary

required

string

table

The table (or schema, or catalog) the operation was about, by its qualified name.

string

executed_at

required

ISO date-time.

string

notes_changed

required

integer

files_changed

required

Files created, moved, deleted or rewritten.

integer

undone

required

boolean

undoes

Operation this one undid.

string

files_failed

required

integer

by

Harness / model of the agent.

string

members

Operations of a batch.

Array<string>

batch

Batch this operation belongs to.

string

Example ^generated

{
  "total": 1,
  "migrations": [
    {
      "migration_id": "example",
      "op": "example",
      "summary": "example",
      "table": "example",
      "executed_at": "example",
      "notes_changed": 1,
      "files_changed": 1,
      "undone": true,
      "undoes": "example",
      "files_failed": 1,
      "by": "example",
      "members": [
        "example"
      ],
      "batch": "example"
    }
  ]
}

400

Bad input: the body is not a JSON object, or an argument is unknown, missing or of the wrong type.

Media typeapplication/json

object

error

required

What went wrong, for a person or an agent.

string

Example ^generated

{
  "error": "example"
}

401

Missing or wrong bearer token.

Media typeapplication/json

object

error

required

What went wrong, for a person or an agent.

string

Example ^generated

{
  "error": "example"
}

404

Unknown table, view, migration, note or folder.

Media typeapplication/json

object

error

required

What went wrong, for a person or an agent.

string

Example ^generated

{
  "error": "example"
}

409

Ambiguous table name: it matches several tables (paths or tables lists them).

Media typeapplication/json

object

error

required

string

paths

The tables’ folders the name matches.

Array<string>

tables

The qualified tables the name matches.

Array<string>

Example ^generated

{
  "error": "example",
  "paths": [
    "example"
  ],
  "tables": [
    "example"
  ]
}

500

Unexpected error.

Media typeapplication/json

object

error

required

What went wrong, for a person or an agent.

string

Example ^generated

{
  "error": "example"
}