← API reference
Mutation / admin

upsertArchiveJob

Create an archive job, or fully overwrite an existing one when input.id is given. Unlike updateArchiveJob, omitted optional fields fall back to the existing value and then to the default. Requires archiveJob:write permission.

Arguments

Full archive job definition; its id decides whether an existing job is overwritten or a new one created.

Returns UpsertArchiveJobPayload!

Explore in a view

Administration and IAM
View exact SDL
"""
Create an archive job, or fully overwrite an existing one when `input.id` is given. Unlike updateArchiveJob, omitted optional fields fall back to the existing value and then to the default. Requires archiveJob:write permission.
"""
upsertArchiveJob(
  """
  Full archive job definition; its `id` decides whether an existing job is overwritten or a new one created.
  """
  input: UpsertArchiveJobInput!
): UpsertArchiveJobPayload! @topic(names: ["admin"])

Schema reference describes the API contract. Actual access is checked by the platform for every operation.