Skip to content

Job timestamp properties

Preview

This feature is not subject to our service terms. Pre-GA features are available as is and might have limited support.

If a job request is not discarded and a job resource is created in the Modigie pipeline of your repository, the job has several date-timestamp properties that your application can use.

createTime read-only
Timestamp when this job was created in the Modigie pipeline.
updateTime read-only
Timestamp when this job was last modified in the Modigie pipeline. If you receive multiple job response messages for the same job, your application can use the updateTime to determine which message reflects the latest state of the job.
deleteTime read-only 1
The timestamp when this job was marked as deleted in Modigie.
purgeTime read-only 1
The approximate timestamp when this job will be irreversibly purged from Modigie.
expireTime read-only 1
The approximate timestamp when this job will expire unless processing in the real-time engine has started.
dispatchTime read-only 1
The timestamp when the job was dispatched to the engine.
startTime read-only 1
The timestamp when the processing of this job started in the real-time engine.
endTime read-only 1
The timestamp when the processing of this job finished in the real-time engine.

Format

Currently, all Modigie APIs provide date-timestamp values as a type: string (format: date-time) and are formatted exactly as described below.

Formatted as RFC 3339, section 5.6 / ISO 8601.

  • Years in 4 digits
  • Months, days, hours, minutes, seconds in two digits (with leading zero, e.g 07)
  • Hours in the 24 hour format, e.g. 13:00:00
  • Microseconds are shown (6 digits), but precision may be milliseconds, i.e. the first three digits only.
  • - as separator between year, month, day
  • : as separator between hour, minute, second
  • T as separator between date and time
  • Z suffix as time-zone (UTC/GMT) which translates to an offset of +00:00 (or -00:00)

For example, the value "2021-10-27T15:45:37.842000Z" is read as follows:

  • Year: 2021
  • Month: October
  • Day: 27
  • Hour: 15 (3 PM)
  • Minute: 45
  • Second: 37
  • Microsecond: 842
  • Time-zone: UTC/GMT

Example

modigieJobRequestId = personA_enrichMobile_1

The ID of the job request must be unique in your repository. If the repository creates the job, the request ID becomes the id value of the job resource.

Note

id, name, and repository are read-only properties.

modigieJobRequestId = personA_enrichMobile_1
The request ID from your original job request became the job's id value.
job-response.json
{
  "createTime": "2025-04-18T19:25:30.290329Z",
  "updateTime": "2025-04-18T19:25:40.290329Z",
  "deleteTime": null,
  "purgeTime": null,
  "expireTime": null,
  "startTime": "2025-04-18T19:25:32.290329Z",
  "endTime": "2025-04-18T19:25:40.290329Z",
  ...
}

  1. This property is experimental and may not be included when the Pub/Sub API becomes generally available. ↩↩↩↩↩↩