Trax .NET
View as MarkdownEdit on GitHub

Reference

operations.manifestGroups mutations

Package Trax.Api.GraphQLSurface GraphQL schemaSource ManifestGroupMutations.cs

ManifestGroupMutations, the type behind mutation { operations { manifestGroups { ... } } }.

The operations.manifestGroups namespace patches mutable fields on a manifest group and enables or disables groups in bulk. The dashboard calls the same underlying service, so a save from either surface produces an identical write.

updateManifestGroup

Patches one or more fields on a manifest group. Fields left out of input are unchanged; updatedAt is bumped only when at least one field actually changed.

mutation {
  operations {
    manifestGroups {
      updateManifestGroup(id: 7, input: {
        priority: 5
        isEnabled: false
      }) { success count message }
    }
  }
}
ParameterTypeRequiredDescription
idLong!YesThe manifest group's database ID
inputUpdateManifestGroupInput!YesPatch payload (fields below)

UpdateManifestGroupInput fields

FieldTypeDefaultDescription
maxActiveJobsIntnullNew per-group concurrency limit, at least 1. null means "no change". To clear the limit, use clearMaxActiveJobs instead
clearMaxActiveJobsBooleanfalseWhen true, sets maxActiveJobs to null (removes the per-group limit). Takes precedence if both this and maxActiveJobs are set
priorityIntnullNew priority, 0 to 31. null = no change
isEnabledBooleannullWhether the group is active. null = no change

Returns: OperationResponse. On success, count is the number of fields actually changed (zero if every supplied value already matched the persisted row). On failure (the group is not found, or a value is out of range), success is false, message explains, and no field is written.

setManifestGroupsEnabled

Enables or disables the listed groups. Only groups whose flag differs are written, with updatedAt bumped.

mutation {
  operations {
    manifestGroups {
      setManifestGroupsEnabled(ids: [1, 2], enabled: false) { success count message }
    }
  }
}
ParameterTypeRequiredDescription
ids[Long!]!Yes1 to 1000 manifest group ids
enabledBoolean!YesThe flag to set

Returns: OperationResponse. count is the number of groups changed, zero included. An empty list, or more than 1000 ids, returns success: false and changes nothing: an empty list never means "every group".

setAllManifestGroupsEnabled

Enables or disables every manifest group. It is a field of its own so that "all" is something a caller asks for by name.

mutation {
  operations {
    manifestGroups {
      setAllManifestGroupsEnabled(enabled: true) { success count message }
    }
  }
}
ParameterTypeRequiredDescription
enabledBoolean!YesThe flag to set

Returns: OperationResponse. count is the number of groups changed, zero included.

See also