ReportingMu Mutation

createRecordedCost

Topics: Costing

Create a new recorded cost. Requires recordedcost:write permission.

Returns

UpsertRecordedCostPayload!

Arguments

Recorded cost data

Examples

Record an actual job cost

mutation RecordERPJobCost($input: CreateRecordedCostInput!) {
  createRecordedCost(input: $input) {
    recordedCost {
      id jobId costCategoryId quantity unitRate totalCost currency recordedAt
    }
    errors { path message }
  }
}

Variables

{
  "input": {
    "costCategoryId": "cca_00000000008008000000000201",
    "jobId": "job_000000000080080000000000r1",
    "quantity": 2.5,
    "unitRate": 75,
    "currency": "EUR",
    "description": "Autumn brochure — recorded press time",
    "referenceType": "timesheet",
    "referenceId": "TS-2026-1042",
    "recordedAt": "2026-10-22T13:00:00Z"
  }
}
Exact field SDL
"""Create a new recorded cost. Requires recordedcost:write permission."""
createRecordedCost(
  """Recorded cost data"""
  input: CreateRecordedCostInput!
): UpsertRecordedCostPayload! @topic(names: ["costing"]) @topic_example(names: ["erp.record-job-cost"])

Declared on Mutation. Access is checked by the platform for each operation.