← All types
In Input object

UpsertArchiveJobInput

Input for creating or updating an archive job

Fields

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.

name

String!Required

Human-readable name for the job. Required.

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

slug

String!Required

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.

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.

Possible values (3)
ALLOW

Allow overlapping CRON executions

SKIP

Skip if previous execution still running

CANCEL

Cancel previous and start new

script

String!Required

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.

Possible values (2)
PARQUET

Apache Parquet — typed, columnar, DuckDB-friendly. Default.

CSV

RFC 4180 CSV with UTF-8 BOM. For Excel / Power BI. Schema must be scalars only.

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

Referenced by (1)
Exact type 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
}