← API reference
CANONICAL TYPE REFERENCE

UpsertArchiveJobInput

Input for creating or updating an archive job

TypeID (prefix arj) of the job to overwrite. Omit to create a new job; if given and no such job exists for the tenant, the mutation fails.

nameString!

Human-readable name for the job. Required.

Optional free-text note about what the job archives. Max 1000 characters.

slugString!

URL-safe identifier matching [a-z0-9][a-z0-9-]*, unique per tenant, and used as the {slug} token of the key template.

TypeID (prefix sbk) of the storage backend to write to. Must already exist for the tenant.

Standard 5-field cron expression for the schedule. Rejected if it does not parse.

timezoneString

IANA timezone the cron expression is evaluated in (e.g. "Europe/Berlin"). Omit for UTC.

What to do when a tick fires while the previous run is still going. Omit to keep the existing value, or SKIP on create.

scriptString!

Lua source producing the rows to archive. Required and must be non-empty.

Storage key template; supports {slug}, {yyyy}, {mm}, {dd}, {yyyy-MM-dd}, {timestamp}, {executionId}. Omit to keep the existing value, or to default to {slug}/dt={yyyy-MM-dd}/run-{timestamp}.parquet on create.

Encoding of the archived output. Omit to keep the existing value, or PARQUET on create.

isEnabledBoolean

Whether the cron schedule is active. Omit to keep the existing value, or true on create.

View exact SDL
"""Input for creating or updating an archive job"""
input UpsertArchiveJobInput {
  """
  TypeID (prefix `arj`) of the job to overwrite. Omit to create a new job; if given and no such job exists for the tenant, the mutation fails.
  """
  id: ArchiveJobID
  """Human-readable name for the job. Required."""
  name: String!
  """
  Optional free-text note about what the job archives. Max 1000 characters.
  """
  description: String
  """
  URL-safe identifier matching `[a-z0-9][a-z0-9-]*`, unique per tenant, and used as the `{slug}` token of the key template.
  """
  slug: String!
  """
  TypeID (prefix `sbk`) of the storage backend to write to. Must already exist for the tenant.
  """
  storageBackendId: StorageBackendID!
  """
  Standard 5-field cron expression for the schedule. Rejected if it does not parse.
  """
  cronExpression: String!
  """
  IANA timezone the cron expression is evaluated in (e.g. "Europe/Berlin"). Omit for UTC.
  """
  timezone: String
  """
  What to do when a tick fires while the previous run is still going. Omit to keep the existing value, or SKIP on create.
  """
  overlapPolicy: OverlapPolicy
  """
  Lua source producing the rows to archive. Required and must be non-empty.
  """
  script: String!
  """
  Storage key template; supports `{slug}`, `{yyyy}`, `{mm}`, `{dd}`, `{yyyy-MM-dd}`, `{timestamp}`, `{executionId}`. Omit to keep the existing value, or to default to `{slug}/dt={yyyy-MM-dd}/run-{timestamp}.parquet` on create.
  """
  keyTemplate: String
  """
  Encoding of the archived output. Omit to keep the existing value, or PARQUET on create.
  """
  outputFormat: ArchiveOutputFormat
  """
  Whether the cron schedule is active. Omit to keep the existing value, or true on create.
  """
  isEnabled: Boolean
}

One stable address across all schema views. Follow a field’s type to explore connections between domains.