Skip to content

File.generated

Emitted each time a File is generated.

File.generate emits File.generated when it completes on a File.

PropertyValue
Emitted byFile.generate
NounFile
WakesNone.

Payload

Each delivery is an Event record. data holds what File.generate returns.

FieldTypeRequiredDescription
namestringrequiredFile.generated.
atdatetimerequiredWhen it happened.
seqintegerIts position in the namespace, one more than the Event before; any seq is a cursor into the history.
datajsonrequiredThe Thing as the Action left it.
data.fileFilerequiredThe generated File, its bytes in Storage and its provenance recorded.
data.file.contentTypestringrequiredThe media type, such as application/pdf.
data.file.sizeintegerrequiredThe size in bytes.
data.file.namestringThe file name it was uploaded with.
data.file.visibilitystringWho may read it: Owner, Customer, or Public. The default is Owner.
data.file.uploadUrlurlThe signed URL to upload the bytes to, returned by File.create.

Example

JSON
{
  "$id": "https://api.sb/tutorloop.com/events/event_1",
  "$type": "Event",
  "name": "File.generated",
  "at": "2026-10-22T12:00:00Z",
  "data": {
    "file": {
      "$id": "https://api.sb/tutorloop.com/files/file_1",
      "$type": "File",
      "contentType": "Example content type",
      "size": 1,
      "name": "TutorLoop",
      "visibility": "Owner",
      "uploadUrl": "https://tutorloop.com"
    }
  },
  "seq": 1
}