ConnectCloud Developers

Take approvals back (line managers and deputies for their team, hr:work:manage for everyone)

POST /api/hr/v1/work-entries/unapprove

Module: HR · operationId: unapproveWorkEntries · Tag: Work entries · Auth: access token (Authorization: Bearer <accessToken>)

All or none; only approved entries no billing batch holds and nobody corrected (409 work_state).

Request body

application/json (required)

  • entries (array of object, required): Entries at the versions the caller saw; all or none
    • id (string (uuid), required): Id of the work entry
    • version (integer, required): Version of the entry the caller saw

Example:

{
  "entries": [
    {
      "id": "5e7a9c1e-3a5c-4e7a-9c1e-3a5c7e9a1c51",
      "version": 1
    },
    {
      "id": "7a9c1e3a-5c7e-4a9c-9e3a-5c7e9a1c3e53",
      "version": 1
    }
  ]
}

Responses

  • 200 Confirmed again (application/json)
  • 400 Error (application/json)
  • 403 Error (application/json)
  • 404 Error (application/json)
  • 409 Error (application/json)

Fields of the 200 answer:

  • items (array of WorkEntry, required): The changed entries
    • approvedAt (string (date-time), nullable): When the entry was approved
    • approvedBy (string): Who approved the entry (e-mail; the platform team acting in the tenant: „Plattformbetrieb (MBCOM) · “)
    • article (WorkArticleRef | null): Masterdata article a flat-rate entry is billed as
    • batchId (string (uuid), nullable): Billing batch the entry is billed in
    • billableMinutes (integer): Minutes billed
    • billedRate (number, nullable): Hourly rate (or article price) the entry was billed at
    • billing (string): Key of a billing type
    • contract (WorkContractRef | null): Trade contract that decides billing
    • correctionOf (string (uuid), nullable): The approved or billed entry this one corrects; its minutes are the difference (may be negative)
    • createdAt (string (date-time)): When the work entry was created
    • createdBy (string): Who booked the entry (e-mail)
    • customer (WorkCustomerRef | null): Customer the work is billed to
    • description (string): What was done
    • durationSeconds (integer): The exact length in seconds (the stopwatch's seconds, else minutes × 60)
    • employeeId (string (uuid)): Id of the employee
    • employeeName (string): Display name of the employee – only in listApprovableWorkEntries
    • endedAt (string (date-time), nullable): null for the running stopwatch and for an entry without a span
    • id (string (uuid)): Id of the work entry
    • kind (string): Key of a work kind (getWorkEntrySettings)
    • km (number): Kilometres travelled (kinds that allow travel)
    • minutes (integer): The length in minutes that sums and billing use (a correction's difference, may be negative; 0 for a stopwatch run that rounded to nothing)
    • origin (string): The call or appointment the time comes from: comms:interaction:<id> or comms:calendar:<id>; omitted for other work. Booked at most once per tenant (409 already_booked)
    • project (WorkProjectRef | null): Project the work counts for
    • running (boolean): The running stopwatch entry (start, no end)
    • source (string): How the entry was booked (one of manual, stopwatch, interaction, calendar, correction)
    • startedAt (string (date-time), nullable): null for an entry booked as a length only
    • state (string): suggested → confirmed → approved → billed (one of suggested, confirmed, approved, billed)
    • subject (string): What was worked on: desk:item:<id>, forge:item:<id>, crm:activity:<id>, a project desk:project:<id> / forge:project:<id>; empty for work on the customer only or internal work
    • subjectLabel (string): The subject's name at booking time (the origin's without a subject)
    • travelMinutes (integer): Travel time in minutes (kinds that allow travel)
    • updatedAt (string (date-time)): When the work entry was last changed
    • version (integer): Version for optimistic locking: send the version you read with a change (stale: 409 version_conflict)
    • workDate (string (date)): The day the work counts for (the person's choice; with a start its day in the tenant's time zone)

Example 200 answer:

{
  "items": [
    {
      "approvedAt": null,
      "approvedBy": "",
      "billableMinutes": 15,
      "billing": "quota",
      "createdAt": "2026-11-16T09:30:00Z",
      "createdBy": "sophie.huber@muster-it.example",
      "durationSeconds": 900,
      "employeeId": "e5a1c3d7-2b4f-4c6e-8a0b-1d3f5b7c9e02",
      "endedAt": "2026-11-16T09:27:00Z",
      "id": "5e7a9c1e-3a5c-4e7a-9c1e-3a5c7e9a1c51",
      "kind": "remote",
      "minutes": 15,
      "running": false,
      "source": "interaction",
      "startedAt": "2026-11-16T09:12:00Z",
      "state": "confirmed",
      "subject": "desk:item:6a8c0e2a-4b6d-4f8a-9c1e-3b5d7f9a1c3e",
      "subjectLabel": "#214 WLAN im Restaurant fällt aus",
      "updatedAt": "2026-11-17T10:20:00Z",
      "version": 3,
      "workDate": "2026-11-16"
    }
  ]
}

Example request

curl -X POST 'https://api.mbcom.cloud/api/hr/v1/work-entries/unapprove' \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  --data '{"entries":[{"id":"5e7a9c1e-3a5c-4e7a-9c1e-3a5c7e9a1c51","version":1},{"id":"7a9c1e3a-5c7e-4a9c-9e3a-5c7e9a1c3e53","version":1}]}'

View as Markdown · Interactive reference · OpenAPI