Reference API

Příklad

{
  "membership": {
    "membership_id": 12,
    "org_name": "Alpha Stavby",
    "role": "worker",
    "first_name": "Petra",
    "last_name": "Nováková",
    "emergency_responses_enabled": true,
    "cancellation_emails_enabled": true
  },
  "memberships": [
    {
      "membership_id": 12,
      "org_name": "Alpha Stavby",
      "role": "worker",
      "first_name": "Petra",
      "last_name": "Nováková",
      "emergency_responses_enabled": true,
      "cancellation_emails_enabled": true
    },
    {
      "membership_id": 27,
      "org_name": "Beta Montáže",
      "role": "manager",
      "first_name": "Petra",
      "last_name": "Nováková",
      "emergency_responses_enabled": false,
      "cancellation_emails_enabled": false
    },
    {
      "membership_id": 27,
      "org_name": "Beta Montáže",
      "role": "worker",
      "first_name": "Petra",
      "last_name": "Nováková",
      "emergency_responses_enabled": false,
      "cancellation_emails_enabled": false
    }
  ],
  "language": "cs"
}

Stavové kódy

Kód	Zpráva
200
400	email and code are required · invalid JSON body
401	that code is not valid
403	this account is not a member of any organization
500	internal server error

Vyzkoušet

POST `/api/auth/sign-out`

Revokes the session.

Jen relace: API klíč je odmítnut s 403.

It succeeds even for a token that was already invalid: signing out must never fail.

Odpověď

Bez těla.

Stavové kódy

Kód	Zpráva
204
500	internal server error

GET `/api/auth/me`

Describes the caller: their identity, the company they are acting as, and the other companies they could switch to, or that a key could name in X-Werzeick-Company.

API klíč nebo relace.

Odpověď

Příklad

{
  "membership": {
    "membership_id": 12,
    "org_name": "Alpha Stavby",
    "role": "worker",
    "first_name": "Petra",
    "last_name": "Nováková",
    "emergency_responses_enabled": true,
    "cancellation_emails_enabled": true
  },
  "memberships": [
    {
      "membership_id": 12,
      "org_name": "Alpha Stavby",
      "role": "worker",
      "first_name": "Petra",
      "last_name": "Nováková",
      "emergency_responses_enabled": true,
      "cancellation_emails_enabled": true
    },
    {
      "membership_id": 27,
      "org_name": "Beta Montáže",
      "role": "manager",
      "first_name": "Petra",
      "last_name": "Nováková",
      "emergency_responses_enabled": false,
      "cancellation_emails_enabled": false
    },
    {
      "membership_id": 27,
      "org_name": "Beta Montáže",
      "role": "worker",
      "first_name": "Petra",
      "last_name": "Nováková",
      "emergency_responses_enabled": false,
      "cancellation_emails_enabled": false
    }
  ],
  "language": "cs"
}

Stavové kódy

Kód	Zpráva
200
401	authentication required
500	internal server error

Vyzkoušet

POST `/api/auth/switch`

Moves the caller to another of their entries — another company, or the other role at the same one — rotating the session.

Jen relace: API klíč je odmítnut s 403.

The old token stops working immediately, so nothing cached against the previous organization or role can outlive the switch.

A role the membership does not hold answers 403, exactly like a membership that is not the caller's: neither says which of the two it was.

Tělo požadavku

Names the entry to move to: a membership and the role to act in there. Both are required, and both are proved by the service.

Pole	Typ	Co to je
`membership_id`	celé číslo
`role`	řetězec

Odpověď

Příklad

{
  "membership": {
    "membership_id": 12,
    "org_name": "Alpha Stavby",
    "role": "worker",
    "first_name": "Petra",
    "last_name": "Nováková",
    "emergency_responses_enabled": true,
    "cancellation_emails_enabled": true
  },
  "memberships": [
    {
      "membership_id": 12,
      "org_name": "Alpha Stavby",
      "role": "worker",
      "first_name": "Petra",
      "last_name": "Nováková",
      "emergency_responses_enabled": true,
      "cancellation_emails_enabled": true
    },
    {
      "membership_id": 27,
      "org_name": "Beta Montáže",
      "role": "manager",
      "first_name": "Petra",
      "last_name": "Nováková",
      "emergency_responses_enabled": false,
      "cancellation_emails_enabled": false
    },
    {
      "membership_id": 27,
      "org_name": "Beta Montáže",
      "role": "worker",
      "first_name": "Petra",
      "last_name": "Nováková",
      "emergency_responses_enabled": false,
      "cancellation_emails_enabled": false
    }
  ],
  "language": "cs"
}

Stavové kódy

Kód	Zpráva
200
400	invalid JSON body · role must be worker or manager
401	authentication required
403	not permitted
500	internal server error

PUT `/api/auth/me/emergency-responses`

Records whether this worker wants to hear about emergency cover at the company they are acting as.

API klíč nebo relace.

It names no membership: the acting one comes from the session, which is what stops this being a way to opt somebody else in or read whether they have.

Tělo požadavku

Pole	Typ	Co to je
`enabled`	boolean, nebo null

Odpověď

Příklad

{
  "membership": {
    "membership_id": 12,
    "org_name": "Alpha Stavby",
    "role": "worker",
    "first_name": "Petra",
    "last_name": "Nováková",
    "emergency_responses_enabled": true,
    "cancellation_emails_enabled": true
  },
  "memberships": [
    {
      "membership_id": 12,
      "org_name": "Alpha Stavby",
      "role": "worker",
      "first_name": "Petra",
      "last_name": "Nováková",
      "emergency_responses_enabled": true,
      "cancellation_emails_enabled": true
    },
    {
      "membership_id": 27,
      "org_name": "Beta Montáže",
      "role": "manager",
      "first_name": "Petra",
      "last_name": "Nováková",
      "emergency_responses_enabled": false,
      "cancellation_emails_enabled": false
    },
    {
      "membership_id": 27,
      "org_name": "Beta Montáže",
      "role": "worker",
      "first_name": "Petra",
      "last_name": "Nováková",
      "emergency_responses_enabled": false,
      "cancellation_emails_enabled": false
    }
  ],
  "language": "cs"
}

Stavové kódy

Kód	Zpráva
200
400	enabled is required · invalid JSON body
401	authentication required
403	only a worker can take emergency shifts
500	internal server error

Vyzkoušet

PUT `/api/auth/me/cancellation-emails`

Records whether this worker wants a cancelled shift emailed as well as pushed, at the company they are acting as.

API klíč nebo relace.

Its own endpoint rather than a second field on the emergency one: each takes {"enabled": …} and a missing key is refused, which only works when the key names one setting.

Tělo požadavku

Pole	Typ	Co to je
`enabled`	boolean, nebo null

Odpověď

Příklad

{
  "membership": {
    "membership_id": 12,
    "org_name": "Alpha Stavby",
    "role": "worker",
    "first_name": "Petra",
    "last_name": "Nováková",
    "emergency_responses_enabled": true,
    "cancellation_emails_enabled": true
  },
  "memberships": [
    {
      "membership_id": 12,
      "org_name": "Alpha Stavby",
      "role": "worker",
      "first_name": "Petra",
      "last_name": "Nováková",
      "emergency_responses_enabled": true,
      "cancellation_emails_enabled": true
    },
    {
      "membership_id": 27,
      "org_name": "Beta Montáže",
      "role": "manager",
      "first_name": "Petra",
      "last_name": "Nováková",
      "emergency_responses_enabled": false,
      "cancellation_emails_enabled": false
    },
    {
      "membership_id": 27,
      "org_name": "Beta Montáže",
      "role": "worker",
      "first_name": "Petra",
      "last_name": "Nováková",
      "emergency_responses_enabled": false,
      "cancellation_emails_enabled": false
    }
  ],
  "language": "cs"
}

Stavové kódy

Kód	Zpráva
200
400	enabled is required · invalid JSON body
401	authentication required
403	only a worker is sent cancellations
500	internal server error

Vyzkoušet

PUT `/api/auth/me/language`

Records the account's choice of language: PUT /api/auth/me/language, {"language": "cs"}.

Jen relace: API klíč je odmítnut s 403.

The app sends it from its own picker, which it has only on a phone with no per-app language setting (Android 12 and older); elsewhere the phone decides. The web client's menu records the same choice.

It names no user: the account is the session's. Answered with the whole session, like the other settings here.

Tělo požadavku

Pole	Typ	Co to je
`language`	řetězec

Odpověď

Příklad

{
  "membership": {
    "membership_id": 12,
    "org_name": "Alpha Stavby",
    "role": "worker",
    "first_name": "Petra",
    "last_name": "Nováková",
    "emergency_responses_enabled": true,
    "cancellation_emails_enabled": true
  },
  "memberships": [
    {
      "membership_id": 12,
      "org_name": "Alpha Stavby",
      "role": "worker",
      "first_name": "Petra",
      "last_name": "Nováková",
      "emergency_responses_enabled": true,
      "cancellation_emails_enabled": true
    },
    {
      "membership_id": 27,
      "org_name": "Beta Montáže",
      "role": "manager",
      "first_name": "Petra",
      "last_name": "Nováková",
      "emergency_responses_enabled": false,
      "cancellation_emails_enabled": false
    },
    {
      "membership_id": 27,
      "org_name": "Beta Montáže",
      "role": "worker",
      "first_name": "Petra",
      "last_name": "Nováková",
      "emergency_responses_enabled": false,
      "cancellation_emails_enabled": false
    }
  ],
  "language": "cs"
}

Stavové kódy

Kód	Zpráva
200
400	invalid JSON body · language must be cs or en
401	authentication required
500	internal server error

Váš účet

Lets somebody delete their own account from the app.

GET `/api/auth/me/deletion`

Says what deleting the caller's account would do, and changes nothing.

Jen relace: API klíč je odmítnut s 403.

The app asks this before it asks the person, so the numbers are in the question.

Odpověď

Deletion

Příklad

{
  "can_delete": false,
  "companies": [
    {
      "org_name": "Alpha Stavby",
      "upcoming_shifts": 2,
      "invitations": 1,
      "clocked_in": true,
      "last_manager": false
    },
    {
      "org_name": "Beta Montáže",
      "upcoming_shifts": 0,
      "invitations": 0,
      "clocked_in": false,
      "last_manager": true
    }
  ]
}

Stavové kódy

Kód	Zpráva
200
401	authentication required
500	internal server error

DELETE `/api/auth/me`

Erases the caller's account.

Jen relace: API klíč je odmítnut s 403.

204 when it is gone; every token the person held stops working with it, this one included.

The request has no body and names nobody. A refusal is 409 with the same shape the preview answers with, so the app can say which company would be left without a manager.

Odpověď

Bez těla.

Stavové kódy

Kód	Zpráva
204
401	authentication required
409
500	internal server error

Pozvánky do firmy

How people join a company. There is no sign-up: a manager invites somebody by email, and the link in that email is accepted here. An address that already has an account gains a membership; one that does not becomes an account.

POST `/api/invitations/preview`

Describes an invitation to whoever holds its link: which company, what they are invited to do, and the rate offered.

Veřejné: není potřeba klíč ani relace.

Nothing is accepted.

Tělo požadavku

Carries the invitation's token, for Preview and Accept.

Public by necessity: the invitee has no account yet. The token is read from the body rather than a query string, because a query string reaches proxy logs, browser history and Referer headers — and this token is a credential.

Pole	Typ	Co to je
`token`	řetězec

Odpověď

Preview invitation

S hodinovou sazbou

{
  "org_name": "Alpha Stavby",
  "is_manager": false,
  "is_worker": true,
  "first_name": "Petra",
  "email": "petra@example.test",
  "rate_amount": 4200000,
  "rate_currency": "CZK"
}

Bez sazby, do obou rolí

{
  "org_name": "Beta Montáže",
  "is_manager": true,
  "is_worker": true,
  "first_name": "Petra",
  "email": "petra@example.test",
  "rate_amount": null,
  "rate_currency": null
}

Stavové kódy

Kód	Zpráva
200
400	invalid JSON body
404	this invitation is invalid, expired, or already used
500	internal server error

Vyzkoušet

POST `/api/invitations/accept`

Turns an invitation into a membership, and says how the person gets in: the same three answers the web page gives, from the same place.

Veřejné: není potřeba klíč ani relace.

Public, like Preview: somebody invited has no account yet. It still looks at the request's own session when there is one, because somebody accepting from an app they are already signed in to has nothing left to prove. That identity comes from the bearer token and never from the body.

Tělo požadavku

Carries the invitation's token, for Preview and Accept.

Pole	Typ	Co to je
`token`	řetězec

Odpověď

Acceptance

Přijetí vytvořilo účet: přihlášeno

{
  "outcome": "signed_in",
  "email": "petra@example.test",
  "code_sent": false,
  "session": {
    "token": "not-a-real-token-only-this-fixture-has-it",
    "expires_at": "2026-11-06T07:30:00Z",
    "membership": {
      "membership_id": 12,
      "org_name": "Alpha Stavby",
      "role": "worker",
      "first_name": "Petra",
      "last_name": "Nováková",
      "emergency_responses_enabled": false,
      "cancellation_emails_enabled": true
    },
    "memberships": [
      {
        "membership_id": 12,
        "org_name": "Alpha Stavby",
        "role": "worker",
        "first_name": "Petra",
        "last_name": "Nováková",
        "emergency_responses_enabled": false,
        "cancellation_emails_enabled": true
      }
    ],
    "language": null
  },
  "membership": null
}

Účet už existoval: kód je na cestě

{
  "outcome": "needs_code",
  "email": "petra@example.test",
  "code_sent": true,
  "session": null,
  "membership": null
}

Už přihlášeno jako tento účet: připojeno

{
  "outcome": "joined",
  "email": "petra@example.test",
  "code_sent": false,
  "session": null,
  "membership": {
    "membership_id": 27,
    "org_name": "Beta Montáže",
    "role": "manager",
    "first_name": "Petra",
    "last_name": "Nováková",
    "emergency_responses_enabled": false,
    "cancellation_emails_enabled": true
  }
}

Stavové kódy

Kód	Zpráva
200
400	invalid JSON body
404	this invitation is invalid, expired, or already used
500	internal server error

Vyzkoušet

POST `/api/invitations`

Offers someone a job at the acting manager's company.

API klíč nebo relace.

There is no org field: the company comes from the session, so a manager cannot invite into a firm they do not belong to.

Tělo požadavku

Pole	Typ	Co to je
`email`	řetězec
`first_name`	řetězec
`last_name`	řetězec
`is_manager`	boolean	What they are invited to do: either, or both. At least one must be true.
`is_worker`	boolean
`rate_amount`	celé číslo, nebo null	Money crosses the wire as a raw int64 with 4 implied decimals plus its currency, never pre-formatted and never a float. Peníze: celé číslo se čtyřmi skrytými desetinnými místy, takže 4200000 je 420,00, a vedle něj měna.
`rate_currency`	řetězec, nebo null

Odpověď

Invitation

Stavové kódy

Kód	Zpráva
201
400	a rate needs both an amount and a currency · email, first_name and last_name are required · invalid JSON body · is_manager or is_worker must be true
401	authentication required
403	not permitted
409	that person is already in your organization
500	internal server error

Vyzkoušet

Tělo

GET `/api/invitations`

Shows who has been invited but has not yet accepted.

API klíč nebo relace.

Odpověď

seznam: Invitation

Stavové kódy

Kód	Zpráva
200
401	authentication required
403	not permitted
500	internal server error

Vyzkoušet

Váš týden

The worker's schedule lives here now, and so does taking an open shift, because that is where the app shows them.

GET `/api/dashboard`

Returns the caller's dashboard at the active company.

API klíč nebo relace.

A value that is not a number is a 400 rather than quietly the default: the app sent something it did not mean.

Parametry dotazu

weeks

Odpověď

Dashboard

Pracovníka

{
  "days": [
    "2026-09-07",
    "2026-09-08",
    "2026-09-09",
    "2026-09-10",
    "2026-09-11",
    "2026-09-12",
    "2026-09-13"
  ],
  "role": "worker",
  "today": "2026-09-09",
  "worker": {
    "awaiting_you": [
      {
        "can_take_from": "2026-09-10T11:00:00Z",
        "can_take_until": "2026-09-10T15:00:00Z",
        "collides_from": "2026-09-10T05:00:00Z",
        "collides_until": "2026-09-10T11:00:00Z",
        "collides_with_company": null,
        "collides_with_title": "Depot fit-out",
        "created_at": "2026-10-28T13:33:30.733171Z",
        "expires_at": "2026-09-10T07:00:00Z",
        "full": false,
        "gig_id": 1,
        "gig_title": "Warehouse roof",
        "id": 1,
        "invited_at": "2026-09-09T08:00:00Z",
        "membership_id": 2,
        "origin": "staffed",
        "rate_amount": 4200000,
        "rate_currency": "CZK",
        "responded_at": null,
        "role_id": 1,
        "role_label": "crane op",
        "status": "pending",
        "takes_from": null,
        "takes_until": null,
        "timeslot": {
          "accepted": 0,
          "created_at": "2026-10-28T13:33:30.731584Z",
          "day_id": 1,
          "ends_at": "2026-09-10T15:00:00Z",
          "gig_id": 1,
          "id": 1,
          "pending": 0,
          "required_workers": 1,
          "role_label": "crane op",
          "starts_at": "2026-09-10T07:00:00Z"
        },
        "timeslot_id": 1
      },
      {
        "can_take_from": null,
        "can_take_until": null,
        "collides_from": null,
        "collides_until": null,
        "collides_with_company": null,
        "collides_with_title": null,
        "created_at": "2026-10-28T13:33:30.781699Z",
        "expires_at": "2026-09-14T07:00:00Z",
        "full": false,
        "gig_id": 1,
        "gig_title": "Warehouse roof",
        "id": 9,
        "invited_at": "2026-09-09T08:00:00Z",
        "membership_id": 2,
        "origin": "staffed",
        "rate_amount": null,
        "rate_currency": null,
        "responded_at": null,
        "role_id": 11,
        "role_label": null,
        "status": "pending",
        "takes_from": null,
        "takes_until": null,
        "timeslot": {
          "accepted": 0,
          "created_at": "2026-10-28T13:33:30.78101Z",
          "day_id": 11,
          "ends_at": "2026-09-14T15:00:00Z",
          "gig_id": 1,
          "id": 11,
          "pending": 0,
          "required_workers": 1,
          "role_label": null,
          "starts_at": "2026-09-14T07:00:00Z"
        },
        "timeslot_id": 11
      },
      {
        "can_take_from": null,
        "can_take_until": null,
        "collides_from": null,
        "collides_until": null,
        "collides_with_company": null,
        "collides_with_title": null,
        "created_at": "2026-10-28T13:33:30.783787Z",
        "expires_at": "2026-09-15T07:00:00Z",
        "full": true,
        "gig_id": 1,
        "gig_title": "Warehouse roof",
        "id": 10,
        "invited_at": "2026-09-09T08:00:00Z",
        "membership_id": 2,
        "origin": "staffed",
        "rate_amount": null,
        "rate_currency": null,
        "responded_at": null,
        "role_id": 12,
        "role_label": null,
        "status": "pending",
        "takes_from": null,
        "takes_until": null,
        "timeslot": {
          "accepted": 1,
          "created_at": "2026-10-28T13:33:30.783093Z",
          "day_id": 12,
          "ends_at": "2026-09-15T15:00:00Z",
          "gig_id": 1,
          "id": 12,
          "pending": 0,
          "required_workers": 1,
          "role_label": null,
          "starts_at": "2026-09-15T07:00:00Z"
        },
        "timeslot_id": 12
      }
    ],
    "expiring_certificates": [
      {
        "days_left": 12,
        "expired": false,
        "expires_on": "2026-09-21",
        "id": 1,
        "kind": "weld_iso9606",
        "label": null,
        "name": "Welder qualification test (EN ISO 9606)"
      }
    ],
    "invitation_summaries": [
      {
        "count": 3,
        "first_day": "2026-09-10",
        "full_count": 1,
        "gig_id": 1,
        "gig_title": "Warehouse roof",
        "last_day": "2026-09-15",
        "minutes": 1440,
        "shift_summary": "Shifts Mon - Tue, Thu, 07:00 - 15:00",
        "unrated_minutes": 960,
        "would_earn": [
          {
            "amount": 33600000,
            "currency": "CZK"
          }
        ]
      }
    ],
    "later": [
      {
        "can_take_from": null,
        "can_take_until": null,
        "collides_from": null,
        "collides_until": null,
        "collides_with_company": null,
        "collides_with_title": null,
        "created_at": "2026-10-28T13:33:30.751859Z",
        "expires_at": "2026-09-16T07:00:00Z",
        "full": true,
        "gig_id": 1,
        "gig_title": "Warehouse roof",
        "id": 5,
        "invited_at": "2026-09-09T08:00:00Z",
        "membership_id": 2,
        "origin": "staffed",
        "rate_amount": 4200000,
        "rate_currency": "CZK",
        "responded_at": "2026-09-09T08:00:00Z",
        "role_id": 5,
        "role_label": null,
        "status": "accepted",
        "takes_from": null,
        "takes_until": null,
        "timeslot": {
          "accepted": 1,
          "created_at": "2026-10-28T13:33:30.751116Z",
          "day_id": 5,
          "ends_at": "2026-09-16T15:00:00Z",
          "gig_id": 1,
          "id": 5,
          "pending": 0,
          "required_workers": 1,
          "role_label": null,
          "starts_at": "2026-09-16T07:00:00Z"
        },
        "timeslot_id": 5
      }
    ],
    "open_shifts": [
      {
        "accepted": 0,
        "can_take_from": "2026-09-13T09:00:00Z",
        "can_take_until": "2026-09-13T15:00:00Z",
        "collides_from": "2026-09-13T05:00:00Z",
        "collides_until": "2026-09-13T09:00:00Z",
        "collides_with_company": "Beta Construction",
        "collides_with_title": "Beta depot",
        "created_at": "2026-10-28T13:33:30.755612Z",
        "day_id": 6,
        "ends_at": "2026-09-13T15:00:00Z",
        "gig_id": 1,
        "gig_title": "Warehouse roof",
        "id": 6,
        "mine_status": "",
        "pending": 0,
        "rate_amount": 5000000,
        "rate_currency": "CZK",
        "required_workers": 1,
        "role_id": 6,
        "role_label": "crane op",
        "starts_at": "2026-09-13T07:00:00Z",
        "taking_confirms": true
      },
      {
        "accepted": 0,
        "can_take_from": "2026-09-13T09:00:00Z",
        "can_take_until": "2026-09-13T15:00:00Z",
        "collides_from": "2026-09-13T05:00:00Z",
        "collides_until": "2026-09-13T09:00:00Z",
        "collides_with_company": "Beta Construction",
        "collides_with_title": "Beta depot",
        "created_at": "2026-10-28T13:33:30.757429Z",
        "day_id": 6,
        "ends_at": "2026-09-13T15:00:00Z",
        "gig_id": 1,
        "gig_title": "Warehouse roof",
        "id": 7,
        "mine_status": "",
        "pending": 0,
        "rate_amount": null,
        "rate_currency": null,
        "required_workers": 1,
        "role_id": 7,
        "role_label": "crane op",
        "starts_at": "2026-09-13T07:00:00Z",
        "taking_confirms": false
      }
    ],
    "still_to_earn": [
      {
        "amount": 92400000,
        "currency": "CZK"
      }
    ],
    "still_to_earn_unrated_minutes": 0,
    "this_week": [
      {
        "can_take_from": null,
        "can_take_until": null,
        "collides_from": null,
        "collides_until": null,
        "collides_with_company": null,
        "collides_with_title": null,
        "created_at": "2026-10-28T13:33:30.736907Z",
        "expires_at": "2026-09-10T05:00:00Z",
        "full": true,
        "gig_id": 2,
        "gig_title": "Depot fit-out",
        "id": 2,
        "invited_at": "2026-09-09T08:00:00Z",
        "membership_id": 2,
        "origin": "staffed",
        "rate_amount": 4200000,
        "rate_currency": "CZK",
        "responded_at": "2026-09-09T08:00:00Z",
        "role_id": 2,
        "role_label": null,
        "status": "accepted",
        "takes_from": null,
        "takes_until": null,
        "timeslot": {
          "accepted": 1,
          "created_at": "2026-10-28T13:33:30.736124Z",
          "day_id": 2,
          "ends_at": "2026-09-10T11:00:00Z",
          "gig_id": 2,
          "id": 2,
          "pending": 0,
          "required_workers": 1,
          "role_label": null,
          "starts_at": "2026-09-10T05:00:00Z"
        },
        "timeslot_id": 2
      },
      {
        "can_take_from": null,
        "can_take_until": null,
        "collides_from": null,
        "collides_until": null,
        "collides_with_company": null,
        "collides_with_title": null,
        "created_at": "2026-10-28T13:33:30.741932Z",
        "expires_at": "2026-09-11T07:00:00Z",
        "full": true,
        "gig_id": 1,
        "gig_title": "Warehouse roof",
        "id": 3,
        "invited_at": "2026-09-09T08:00:00Z",
        "membership_id": 2,
        "origin": "staffed",
        "rate_amount": 4200000,
        "rate_currency": "CZK",
        "responded_at": "2026-09-09T08:00:00Z",
        "role_id": 3,
        "role_label": null,
        "status": "accepted",
        "takes_from": null,
        "takes_until": null,
        "timeslot": {
          "accepted": 1,
          "created_at": "2026-10-28T13:33:30.741178Z",
          "day_id": 3,
          "ends_at": "2026-09-11T15:00:00Z",
          "gig_id": 1,
          "id": 3,
          "pending": 0,
          "required_workers": 1,
          "role_label": null,
          "starts_at": "2026-09-11T07:00:00Z"
        },
        "timeslot_id": 3
      },
      {
        "can_take_from": null,
        "can_take_until": null,
        "collides_from": null,
        "collides_until": null,
        "collides_with_company": null,
        "collides_with_title": null,
        "created_at": "2026-10-28T13:33:30.746586Z",
        "expires_at": "2026-09-12T07:00:00Z",
        "full": false,
        "gig_id": 1,
        "gig_title": "Warehouse roof",
        "id": 4,
        "invited_at": "2026-09-09T08:00:00Z",
        "membership_id": 2,
        "origin": "staffed",
        "rate_amount": 4200000,
        "rate_currency": "CZK",
        "responded_at": "2026-09-09T08:00:00Z",
        "role_id": 4,
        "role_label": null,
        "status": "cancelled",
        "takes_from": null,
        "takes_until": null,
        "timeslot": {
          "accepted": 0,
          "created_at": "2026-10-28T13:33:30.745806Z",
          "day_id": 4,
          "ends_at": "2026-09-12T15:00:00Z",
          "gig_id": 1,
          "id": 4,
          "pending": 0,
          "required_workers": 1,
          "role_label": null,
          "starts_at": "2026-09-12T07:00:00Z"
        },
        "timeslot_id": 4
      }
    ],
    "worked_this_month": {
      "earned": [
        {
          "amount": 16800000,
          "currency": "CZK"
        }
      ],
      "minutes": 240,
      "unrated_minutes": 0
    },
    "worked_this_week": {
      "earned": [
        {
          "amount": 16800000,
          "currency": "CZK"
        }
      ],
      "minutes": 240,
      "unrated_minutes": 0
    }
  }
}

Manažera

{
  "days": [
    "2026-09-07",
    "2026-09-08",
    "2026-09-09",
    "2026-09-10",
    "2026-09-11",
    "2026-09-12",
    "2026-09-13"
  ],
  "manager": {
    "attention": [
      {
        "accepted": 0,
        "created_at": "2026-10-28T13:33:30.731584Z",
        "day_id": 1,
        "ends_at": "2026-09-10T15:00:00Z",
        "gig_id": 1,
        "gig_title": "Warehouse roof",
        "id": 1,
        "pending": 1,
        "required_workers": 1,
        "role_label": "crane op",
        "starts_at": "2026-09-10T07:00:00Z"
      },
      {
        "accepted": 0,
        "created_at": "2026-10-28T13:33:30.76944Z",
        "day_id": 1,
        "ends_at": "2026-09-10T22:00:00Z",
        "gig_id": 1,
        "gig_title": "Warehouse roof",
        "id": 9,
        "pending": 0,
        "required_workers": 2,
        "role_label": null,
        "starts_at": "2026-09-10T14:00:00Z"
      },
      {
        "accepted": 0,
        "created_at": "2026-10-28T13:33:30.745806Z",
        "day_id": 4,
        "ends_at": "2026-09-12T15:00:00Z",
        "gig_id": 1,
        "gig_title": "Warehouse roof",
        "id": 4,
        "pending": 0,
        "required_workers": 1,
        "role_label": null,
        "starts_at": "2026-09-12T07:00:00Z"
      },
      {
        "accepted": 0,
        "created_at": "2026-10-28T13:33:30.755612Z",
        "day_id": 6,
        "ends_at": "2026-09-13T15:00:00Z",
        "gig_id": 1,
        "gig_title": "Warehouse roof",
        "id": 6,
        "pending": 0,
        "required_workers": 1,
        "role_label": "crane op",
        "starts_at": "2026-09-13T07:00:00Z"
      },
      {
        "accepted": 0,
        "created_at": "2026-10-28T13:33:30.757429Z",
        "day_id": 6,
        "ends_at": "2026-09-13T15:00:00Z",
        "gig_id": 1,
        "gig_title": "Warehouse roof",
        "id": 7,
        "pending": 0,
        "required_workers": 1,
        "role_label": "crane op",
        "starts_at": "2026-09-13T07:00:00Z"
      },
      {
        "accepted": 0,
        "created_at": "2026-10-28T13:33:30.78101Z",
        "day_id": 11,
        "ends_at": "2026-09-14T15:00:00Z",
        "gig_id": 1,
        "gig_title": "Warehouse roof",
        "id": 11,
        "pending": 1,
        "required_workers": 1,
        "role_label": null,
        "starts_at": "2026-09-14T07:00:00Z"
      },
      {
        "accepted": 1,
        "created_at": "2026-10-28T13:33:30.783093Z",
        "day_id": 12,
        "ends_at": "2026-09-15T15:00:00Z",
        "gig_id": 1,
        "gig_title": "Warehouse roof",
        "id": 12,
        "pending": 1,
        "required_workers": 1,
        "role_label": null,
        "starts_at": "2026-09-15T07:00:00Z"
      }
    ],
    "attention_summaries": [
      {
        "accepted": 1,
        "count": 7,
        "first_day": "2026-09-10",
        "gig_id": 1,
        "gig_title": "Warehouse roof",
        "imminent": true,
        "last_day": "2026-09-15",
        "pending": 3,
        "required": 8,
        "shift_summary": "Shifts Mon - Tue, Sat, 07:00 - 15:00, Thu 07:00 - 15:00, 14:00 - 22:00, Sun 07:00 - 15:00, 07:00 - 15:00",
        "short": 7
      }
    ],
    "hours_to_check": [
      {
        "entry": {
          "clock_in_at": "2026-09-02T07:00:00Z",
          "clock_out_at": "2026-09-02T22:00:00Z",
          "corrected_at": null,
          "created_at": "2026-10-28T13:33:30.768583Z",
          "earned_amount": 57000000,
          "gig_id": 1,
          "id": 3,
          "membership_id": 5,
          "rate_amount": 3800000,
          "rate_currency": "CZK",
          "source": "manual",
          "timeslot_id": 8
        },
        "gig_title": "Warehouse roof",
        "missing_clock_out": false,
        "outside_shift": true,
        "slot_ends_at": "2026-09-02T15:00:00Z",
        "slot_starts_at": "2026-09-02T07:00:00Z",
        "worker_name": "Second Alpha Stavby"
      },
      {
        "entry": {
          "clock_in_at": "2026-09-03T07:00:00Z",
          "clock_out_at": "2026-09-03T22:00:00Z",
          "corrected_at": null,
          "created_at": "2026-10-28T13:33:30.779978Z",
          "earned_amount": null,
          "gig_id": 1,
          "id": 4,
          "membership_id": 6,
          "rate_amount": null,
          "rate_currency": null,
          "source": "manual",
          "timeslot_id": 10
        },
        "gig_title": "Warehouse roof",
        "missing_clock_out": false,
        "outside_shift": true,
        "slot_ends_at": "2026-09-03T15:00:00Z",
        "slot_starts_at": "2026-09-03T07:00:00Z",
        "worker_name": "Unrated Alpha Stavby"
      },
      {
        "entry": {
          "clock_in_at": "2026-09-08T06:00:00Z",
          "clock_out_at": null,
          "corrected_at": null,
          "created_at": "2026-10-28T13:33:30.763173Z",
          "earned_amount": 0,
          "gig_id": 1,
          "id": 2,
          "membership_id": 2,
          "rate_amount": 4200000,
          "rate_currency": "CZK",
          "source": "manual",
          "timeslot_id": null
        },
        "gig_title": "Warehouse roof",
        "missing_clock_out": true,
        "outside_shift": false,
        "slot_ends_at": null,
        "slot_starts_at": null,
        "worker_name": "Worker Alpha Stavby"
      }
    ],
    "turned_down": [
      {
        "created_at": "2026-10-28T13:33:30.770123Z",
        "expires_at": "2026-09-10T14:00:00Z",
        "gig_title": "Warehouse roof",
        "id": 7,
        "invited_at": "2026-09-09T08:00:00Z",
        "membership_id": 5,
        "origin": "staffed",
        "rate_amount": 3800000,
        "rate_currency": "CZK",
        "responded_at": "2026-09-09T08:00:00Z",
        "role_id": 9,
        "role_label": null,
        "status": "withdrawn",
        "takes_from": null,
        "takes_until": null,
        "timeslot": {
          "accepted": 0,
          "created_at": "2026-10-28T13:33:30.76944Z",
          "day_id": 1,
          "ends_at": "2026-09-10T22:00:00Z",
          "gig_id": 1,
          "id": 9,
          "pending": 0,
          "required_workers": 2,
          "role_label": null,
          "starts_at": "2026-09-10T14:00:00Z"
        },
        "timeslot_id": 9,
        "worker_name": "Second Alpha Stavby"
      }
    ],
    "week": [
      {
        "accepted": 0,
        "day": "2026-09-07",
        "pending": 0,
        "required": 0,
        "short": 0,
        "slots": 0
      },
      {
        "accepted": 0,
        "day": "2026-09-08",
        "pending": 0,
        "required": 0,
        "short": 0,
        "slots": 0
      },
      {
        "accepted": 0,
        "day": "2026-09-09",
        "pending": 0,
        "required": 0,
        "short": 0,
        "slots": 0
      },
      {
        "accepted": 1,
        "day": "2026-09-10",
        "pending": 1,
        "required": 4,
        "short": 3,
        "slots": 3
      },
      {
        "accepted": 1,
        "day": "2026-09-11",
        "pending": 0,
        "required": 1,
        "short": 0,
        "slots": 1
      },
      {
        "accepted": 0,
        "day": "2026-09-12",
        "pending": 0,
        "required": 1,
        "short": 1,
        "slots": 1
      },
      {
        "accepted": 0,
        "day": "2026-09-13",
        "pending": 0,
        "required": 2,
        "short": 2,
        "slots": 2
      }
    ],
    "worked_this_week": {
      "earned": [
        {
          "amount": 16800000,
          "currency": "CZK"
        }
      ],
      "minutes": 240,
      "unrated_minutes": 0
    }
  },
  "role": "manager",
  "today": "2026-09-09"
}

Stavové kódy

Kód	Zpráva
200
400	weeks must be a whole number
401	authentication required
403	not permitted
500	internal server error

Vyzkoušet

POST `/api/timeslots/{id}/take`

Puts the caller on a shift a PM opened to the company.

API klíč nebo relace.

The body names the role being taken, role_id, as the dashboard's open shift row carried it: an open shift is listed once per role, each with its own places and figure. It may be left out for a shift with one role. The request carries no rate: the figure is resolved on the server at signup and snapshotted, exactly as the dashboard quoted it; a client never sends the number it believes it was offered. partial is consent to take only the free remainder of a shift that collides with accepted work.

What comes back is the assignment: accepted on a shift that confirms takers, pending on one where the manager picks. The app re-reads the dashboard either way.

V cestě

Parametr	Co to je
`id`	Id směny.

Tělo požadavku

Pole	Typ	Co to je
`partial`	boolean
`role_id`	celé číslo

Odpověď

Příklad

{
  "id": 2,
  "timeslot_id": 2,
  "membership_id": 2,
  "origin": "sos",
  "status": "accepted",
  "rate_amount": 6300000,
  "rate_currency": "CZK",
  "invited_at": "2026-09-07T09:00:00Z",
  "responded_at": "2026-09-07T09:05:00Z",
  "expires_at": "2026-09-10T05:00:00Z",
  "created_at": "2026-09-07T09:00:00Z",
  "takes_from": "2026-09-10T09:00:00Z",
  "takes_until": "2026-09-10T13:00:00Z",
  "role_id": 2,
  "role_label": "crane op"
}

Stavové kódy

Kód	Zpráva
201
400	invalid timeslot id · this shift has several roles; send role_id
401	authentication required
403	not permitted · this shift raises an hourly rate, and you have none here to raise
404	shift not found
409
500	internal server error

Vyzkoušet

Směny a odpovědi

The worker's side of staffing: what am I being asked to do, and my answer.

A PM's staffing screens live in the web client for now; the same services back both, so a manager overview in the app is rendering work, not new logic.

GET `/api/schedule`

Returns the caller's own assignments at the active company.

API klíč nebo relace.

Odpověď

seznam: Schedule entry

Příklad

[
  {
    "id": 1,
    "timeslot_id": 1,
    "membership_id": 2,
    "origin": "staffed",
    "status": "pending",
    "rate_amount": 4200000,
    "rate_currency": "CZK",
    "invited_at": "2026-09-07T08:00:00Z",
    "responded_at": null,
    "expires_at": "2026-09-09T07:00:00Z",
    "created_at": "2026-09-07T08:00:00Z",
    "takes_from": null,
    "takes_until": null,
    "role_id": 1,
    "role_label": null,
    "timeslot": {
      "id": 1,
      "gig_id": 1,
      "day_id": 1,
      "starts_at": "2026-09-09T07:00:00Z",
      "ends_at": "2026-09-09T15:00:00Z",
      "required_workers": 2,
      "role_label": null,
      "created_at": "2026-09-07T08:00:00Z",
      "accepted": 0,
      "pending": 1
    },
    "gig_id": 1,
    "gig_title": "Warehouse roof",
    "full": false,
    "collides_with_title": "Depot fit-out",
    "collides_with_company": null,
    "collides_from": "2026-09-09T05:00:00Z",
    "collides_until": "2026-09-09T11:00:00Z",
    "can_take_from": "2026-09-09T11:00:00Z",
    "can_take_until": "2026-09-09T15:00:00Z"
  },
  {
    "id": 2,
    "timeslot_id": 2,
    "membership_id": 2,
    "origin": "sos",
    "status": "accepted",
    "rate_amount": 6300000,
    "rate_currency": "CZK",
    "invited_at": "2026-09-07T09:00:00Z",
    "responded_at": "2026-09-07T09:05:00Z",
    "expires_at": "2026-09-10T05:00:00Z",
    "created_at": "2026-09-07T09:00:00Z",
    "takes_from": "2026-09-10T09:00:00Z",
    "takes_until": "2026-09-10T13:00:00Z",
    "role_id": 2,
    "role_label": "crane op",
    "timeslot": {
      "id": 2,
      "gig_id": 2,
      "day_id": 2,
      "starts_at": "2026-09-10T05:00:00Z",
      "ends_at": "2026-09-10T13:00:00Z",
      "required_workers": 1,
      "role_label": "crane op",
      "created_at": "2026-09-07T09:00:00Z",
      "accepted": 1,
      "pending": 0
    },
    "gig_id": 2,
    "gig_title": "Depot fit-out",
    "full": false,
    "collides_with_title": null,
    "collides_with_company": null,
    "collides_from": null,
    "collides_until": null,
    "can_take_from": null,
    "can_take_until": null
  },
  {
    "id": 3,
    "timeslot_id": 3,
    "membership_id": 2,
    "origin": "open",
    "status": "pending",
    "rate_amount": 6300000,
    "rate_currency": "CZK",
    "invited_at": "2026-09-07T10:00:00Z",
    "responded_at": null,
    "expires_at": "2026-09-11T05:00:00Z",
    "created_at": "2026-09-07T10:00:00Z",
    "takes_from": null,
    "takes_until": null,
    "role_id": 3,
    "role_label": null,
    "timeslot": {
      "id": 3,
      "gig_id": 1,
      "day_id": 3,
      "starts_at": "2026-09-11T05:00:00Z",
      "ends_at": "2026-09-11T13:00:00Z",
      "required_workers": 2,
      "role_label": null,
      "created_at": "2026-09-07T10:00:00Z",
      "accepted": 1,
      "pending": 1
    },
    "gig_id": 1,
    "gig_title": "Warehouse roof",
    "full": false,
    "collides_with_title": null,
    "collides_with_company": null,
    "collides_from": null,
    "collides_until": null,
    "can_take_from": null,
    "can_take_until": null
  },
  {
    "id": 4,
    "timeslot_id": 4,
    "membership_id": 2,
    "origin": "staffed",
    "status": "pending",
    "rate_amount": null,
    "rate_currency": null,
    "invited_at": "2026-09-07T11:00:00Z",
    "responded_at": null,
    "expires_at": "2026-09-14T05:00:00Z",
    "created_at": "2026-09-07T11:00:00Z",
    "takes_from": null,
    "takes_until": null,
    "role_id": 4,
    "role_label": null,
    "timeslot": {
      "id": 4,
      "gig_id": 1,
      "day_id": 4,
      "starts_at": "2026-09-14T05:00:00Z",
      "ends_at": "2026-09-14T13:00:00Z",
      "required_workers": 2,
      "role_label": null,
      "created_at": "2026-09-07T11:00:00Z",
      "accepted": 2,
      "pending": 1
    },
    "gig_id": 1,
    "gig_title": "Warehouse roof",
    "full": true,
    "collides_with_title": null,
    "collides_with_company": null,
    "collides_from": null,
    "collides_until": null,
    "can_take_from": null,
    "can_take_until": null
  }
]

Stavové kódy

Kód	Zpráva
200
401	authentication required
403	not permitted
500	internal server error

Vyzkoušet

POST `/api/assignments/{id}/respond`

Records a worker's answer to one assignment.

API klíč nebo relace.

Accept, decline and withdraw share a route because they share a lifecycle; the action is in the body rather than the path so a client cannot invent one.

V cestě

Parametr	Co to je
`id`	Id přiřazení: vašeho místa na směně.

Tělo požadavku

Pole	Typ	Co to je
`action`	řetězec
`partial`	boolean	`partial` is consent to take only the free remainder of a shift that collides with accepted work. The span itself is the server's to compute under its locks; a client never sends one.

Odpověď

Příklad

{
  "id": 2,
  "timeslot_id": 2,
  "membership_id": 2,
  "origin": "sos",
  "status": "accepted",
  "rate_amount": 6300000,
  "rate_currency": "CZK",
  "invited_at": "2026-09-07T09:00:00Z",
  "responded_at": "2026-09-07T09:05:00Z",
  "expires_at": "2026-09-10T05:00:00Z",
  "created_at": "2026-09-07T09:00:00Z",
  "takes_from": "2026-09-10T09:00:00Z",
  "takes_until": "2026-09-10T13:00:00Z",
  "role_id": 2,
  "role_label": "crane op"
}

Stavové kódy

Kód	Zpráva
200
400	action must be "accept", "decline" or "withdraw" · invalid JSON body · invalid assignment id
401	authentication required
403	not permitted · that application is the manager's to approve
404	assignment not found
409	that invitation is no longer open · that is an invitation, and only the worker can accept it · that shift collides with work you have accepted · that shift is already full
500	internal server error

Vyzkoušet

POST `/api/gigs/{id}/invitations/respond`

Answers every invitation the caller has not answered on one project: "Accept all" and "Decline all" beside a project's invitations.

API klíč nebo relace.

It names a project and an action and nothing else. Which invitations those are is decided here, at the moment of the tap, from the caller's own membership — a client never sends a list of ids it believes are its own. Another company's project, or one with nothing waiting, answers 200 with zeros: there was nothing to do, and that is all anybody is told.

V cestě

Parametr	Co to je
`id`	Id zakázky.

Tělo požadavku

Pole	Typ	Co to je
`action`	řetězec

Odpověď

Answered invitations

Příklad

{
  "answered": 2,
  "full": 1,
  "colliding": 0
}

Stavové kódy

Kód	Zpráva
200
400	action must be "accept" or "decline" · invalid JSON body · invalid project id
401	authentication required
403	not permitted · that application is the manager's to approve
404	assignment not found
409	that invitation is no longer open · that is an invitation, and only the worker can accept it · that shift collides with work you have accepted · that shift is already full
500	internal server error

Vyzkoušet

POST `/api/devices`

Records an FCM token so this phone can be reached.

Jen relace: API klíč je odmítnut s 403.

Tělo požadavku

Pole	Typ	Co to je
`token`	řetězec
`platform`	řetězec
`language`	řetězec

Odpověď

Bez těla.

Stavové kódy

Kód	Zpráva
204
400	invalid JSON body
401	authentication required

DELETE `/api/devices`

Drops this phone's token, on sign-out.

Jen relace: API klíč je odmítnut s 403.

Without it, a worker who signs out — or hands the phone on — keeps receiving shift notifications for a session they no longer have.

Tělo požadavku

Pole	Typ	Co to je
`token`	řetězec

Odpověď

Bez těla.

Stavové kódy

Kód	Zpráva
204
400	a device token is required · invalid JSON body
401	authentication required
403	not permitted
500	internal server error

Příchod a odchod

Clocking in and out, from the app.

This is the endpoint a worker uses standing on a building site, often with one bar of signal, sometimes with none. Two consequences run through it:

The device supplies the timestamp, and the server takes it. Stamping an entry with the moment it happened to sync would be wrong by hours for exactly the worker who most needs the record to be right.
Every write is idempotent on the device's own event id, so a retry after a dropped connection is harmless.

What is NOT here, and must never be: any coordinate. Geofence auto-clocking computes distance on the phone against the one site it was given and posts the same clock event a thumb would. source is the whole of the difference.

POST `/api/time/clock-in`

Starts a stretch of work.

API klíč nebo relace.

Tělo požadavku

The entire wire shape of a clock event. Keep it that way.

Pole	Typ	Co to je
`gig_id`	celé číslo
`at`	řetězec	`at` is the device's clock, RFC 3339 with an offset. Omitted means now.
`source`	řetězec	`source` is "manual" or "geofence"; empty means manual.
`client_event_id`	řetězec	`client_event_id` is the device's id for this event, and the reason a replayed push creates one row rather than two.

Odpověď

Time entry

Příklad

{
  "id": 2,
  "membership_id": 2,
  "gig_id": 1,
  "timeslot_id": null,
  "clock_in_at": "2026-09-09T06:20:00Z",
  "clock_out_at": null,
  "source": "geofence",
  "rate_amount": 4200000,
  "rate_currency": "CZK",
  "earned_amount": 0,
  "corrected_at": null,
  "created_at": "2026-09-09T06:20:00Z"
}

Stavové kódy

Kód	Zpráva
200
400	at must be an RFC 3339 timestamp · invalid JSON body
401	authentication required
403	not permitted
404	time entry not found
409
500	internal server error

Vyzkoušet

POST `/api/time/clock-out`

Ends one, naming it by the device's event id when the phone has been offline and by project otherwise.

API klíč nebo relace.

Tělo požadavku

The entire wire shape of a clock event. Keep it that way.

Pole	Typ	Co to je
`gig_id`	celé číslo
`at`	řetězec	`at` is the device's clock, RFC 3339 with an offset. Omitted means now.
`source`	řetězec	`source` is "manual" or "geofence"; empty means manual.
`client_event_id`	řetězec	`client_event_id` is the device's id for this event, and the reason a replayed push creates one row rather than two.

Odpověď

Time entry

Příklad

{
  "id": 1,
  "membership_id": 2,
  "gig_id": 1,
  "timeslot_id": 1,
  "clock_in_at": "2026-09-08T07:45:00Z",
  "clock_out_at": "2026-09-08T17:10:00Z",
  "source": "manual",
  "rate_amount": 4200000,
  "rate_currency": "CZK",
  "earned_amount": 39550000,
  "client_event_id": "9f8c1a2b3d4e5f60718293a4b5c6d7e8",
  "corrected_at": null,
  "created_at": "2026-09-08T07:45:00Z"
}

Stavové kódy

Kód	Zpráva
200
400	at must be an RFC 3339 timestamp · clock-out needs a gig_id or a client_event_id · invalid JSON body
401	authentication required
403	not permitted
404	time entry not found
409
500	internal server error

Vyzkoušet

GET `/api/time/entries`

The worker's own record of their hours.

API klíč nebo relace.

since defaults to four weeks back: enough to check a pay period, little enough that a phone on a slow connection is not downloading a year.

Parametry dotazu

since

Odpověď

seznam: Time entry

Příklad

[
  {
    "id": 1,
    "membership_id": 2,
    "gig_id": 1,
    "timeslot_id": 1,
    "clock_in_at": "2026-09-08T07:45:00Z",
    "clock_out_at": "2026-09-08T17:10:00Z",
    "source": "manual",
    "rate_amount": 4200000,
    "rate_currency": "CZK",
    "earned_amount": 39550000,
    "client_event_id": "9f8c1a2b3d4e5f60718293a4b5c6d7e8",
    "corrected_at": null,
    "created_at": "2026-09-08T07:45:00Z"
  },
  {
    "id": 2,
    "membership_id": 2,
    "gig_id": 1,
    "timeslot_id": null,
    "clock_in_at": "2026-09-09T06:20:00Z",
    "clock_out_at": null,
    "source": "geofence",
    "rate_amount": 4200000,
    "rate_currency": "CZK",
    "earned_amount": 0,
    "corrected_at": null,
    "created_at": "2026-09-09T06:20:00Z"
  },
  {
    "id": 3,
    "membership_id": 2,
    "gig_id": 1,
    "timeslot_id": null,
    "clock_in_at": "2026-09-10T06:00:00Z",
    "clock_out_at": "2026-09-10T14:30:00Z",
    "source": "manual",
    "rate_amount": null,
    "rate_currency": null,
    "earned_amount": null,
    "corrected_at": null,
    "created_at": "2026-09-10T06:00:00Z"
  }
]

Stavové kódy

Kód	Zpráva
200
400	since must be an RFC 3339 timestamp
401	authentication required
403	not permitted
404	time entry not found
409
500	internal server error

Vyzkoušet

POST `/api/time/entries/{id}/correct`

Fixes an entry's times.

API klíč nebo relace.

A worker owns their own hours; a manager may resolve anyone's, which is how discrepancies get settled.

V cestě

Parametr	Co to je
`id`	Id záznamu času.

Tělo požadavku

Pole	Typ	Co to je
`clock_in_at`	řetězec
`clock_out_at`	řetězec, nebo null

Odpověď

Time entry

Příklad

{
  "id": 1,
  "membership_id": 2,
  "gig_id": 1,
  "timeslot_id": 1,
  "clock_in_at": "2026-09-08T07:45:00Z",
  "clock_out_at": "2026-09-08T17:10:00Z",
  "source": "manual",
  "rate_amount": 4200000,
  "rate_currency": "CZK",
  "earned_amount": 39550000,
  "client_event_id": "9f8c1a2b3d4e5f60718293a4b5c6d7e8",
  "corrected_at": null,
  "created_at": "2026-09-08T07:45:00Z"
}

Stavové kódy

Kód	Zpráva
200
400	clock_in_at must be an RFC 3339 timestamp · clock_out_at must be an RFC 3339 timestamp or null · invalid JSON body · invalid time entry id
401	authentication required
403	not permitted
404	time entry not found
409
500	internal server error

Vyzkoušet

Zakázky a výdaje

Projects, which the API calls gigs: the unit of work a company plans, from one shift to months, with a site, a client and the expenses booked against it. A manager sees every project at the company; a worker sees the ones they have a part in and the ones with a shift they could take.

GET `/api/gigs`

Lists the caller's projects at the company they are acting in.

API klíč nebo relace.

A manager gets every live project. A worker gets the ones they have a part in, newest first, and after those the ones with an open shift they could take; each row says which with is_assigned, is_invited and shifts_to_take. Archived projects are not listed, though each still answers at its own address.

all=1 lists them at every company and role the caller holds, each entry's projects as that entry would list them, with company on each row naming the entry: send its entry as X-Werzeick-Company to act on the project. Somebody who both manages and works at one company sees such a project once for each. It cannot be combined with X-Werzeick-Company.

Parametry dotazu

all

Odpověď

seznam: Project

Příklad

{
  "id": 3,
  "title": "Foundation pour",
  "owner_id": 4,
  "project_manager": {
    "name": "Martin Dvořák",
    "phone": "+420603456789",
    "email": null
  },
  "client_id": 7,
  "client_name": "Kaufland Česká republika",
  "client_contact_name": "Petra Marková",
  "client_contact_phone": "+420602123456",
  "client_contact_email": "petra.markova@kaufland.cz",
  "job_contact": {
    "company": null,
    "name": "Jana Horáková, has the keys",
    "phone": "+420777111222"
  },
  "latitude": 49.8209,
  "longitude": 18.2625,
  "geofence_radius_m": 150,
  "site_address": "Gate 3, Průmyslová 1472/12, 702 00 Ostrava",
  "expected_minutes": 480,
  "is_assigned": true,
  "is_invited": false,
  "shifts_to_take": 2,
  "archived_at": null,
  "expenses": [],
  "created_at": "2026-09-07T16:06:11.113221+02:00",
  "site_outline": [
    {
      "lat": 49.8205,
      "lon": 18.2615
    },
    {
      "lat": 49.8205,
      "lon": 18.2636
    },
    {
      "lat": 49.82131,
      "lon": 18.2636
    },
    {
      "lat": 49.82131,
      "lon": 18.2615
    }
  ]
}

Stavové kódy

Kód	Zpráva
200
400	all=1 reads every company: leave out X-Werzeick-Company
401	authentication required
403	not permitted
500	internal server error

Vyzkoušet

GET `/api/gigs/{id}`

One project, in the same shape the list gives it.

API klíč nebo relace.

A project the caller cannot list, another company's included, answers 404: it does not exist for them.

V cestě

Parametr	Co to je
`id`	Id zakázky.

Odpověď

Project

Příklad

{
  "id": 3,
  "title": "Foundation pour",
  "owner_id": 4,
  "project_manager": {
    "name": "Martin Dvořák",
    "phone": "+420603456789",
    "email": null
  },
  "client_id": 7,
  "client_name": "Kaufland Česká republika",
  "client_contact_name": "Petra Marková",
  "client_contact_phone": "+420602123456",
  "client_contact_email": "petra.markova@kaufland.cz",
  "job_contact": {
    "company": null,
    "name": "Jana Horáková, has the keys",
    "phone": "+420777111222"
  },
  "latitude": 49.8209,
  "longitude": 18.2625,
  "geofence_radius_m": 150,
  "site_address": "Gate 3, Průmyslová 1472/12, 702 00 Ostrava",
  "expected_minutes": 480,
  "is_assigned": true,
  "is_invited": false,
  "shifts_to_take": 2,
  "archived_at": null,
  "expenses": [],
  "created_at": "2026-09-07T16:06:11.113221+02:00",
  "site_outline": [
    {
      "lat": 49.8205,
      "lon": 18.2615
    },
    {
      "lat": 49.8205,
      "lon": 18.2636
    },
    {
      "lat": 49.82131,
      "lon": 18.2636
    },
    {
      "lat": 49.82131,
      "lon": 18.2615
    }
  ]
}

Stavové kódy

Kód	Zpráva
200
400	invalid gig id
401	authentication required
403	not permitted
404	gig not found
500	internal server error

Vyzkoušet

GET `/api/gigs/{id}/earnings`

Answers "what has this project paid me, and what will it".

API klíč nebo relace.

Its own endpoint rather than a field on the gig, for two reasons. The list screen has no use for it and should not pay for it on every row; and a tool attached or an hour corrected changes this without changing the project, so the app can re-read one without the other.

The two figures come from two different tables, each carrying its own rate snapshot, and neither is ever rebuilt from the membership rate.

V cestě

Parametr	Co to je
`id`	Id zakázky.

Odpověď

Earnings

Příklad

{
  "earned": [
    {
      "amount": 33600000,
      "currency": "CZK"
    }
  ],
  "upcoming": [
    {
      "amount": 50400000,
      "currency": "CZK"
    }
  ],
  "earned_unrated_minutes": 0,
  "upcoming_unrated_minutes": 360,
  "running": null
}

Stavové kódy

Kód	Zpráva
200
400	invalid {thing} id
401	authentication required
403	not permitted
404	gig not found
500	internal server error

Vyzkoušet

POST `/api/gigs`

Makes a project at the caller's company, with the caller as its manager.

API klíč nebo relace.

Managers only.

Tělo požadavku

The JSON body of POST /api/gigs.

There is deliberately no owner_id or org_id here: the owner is the acting manager's own membership and the organization comes from the session. A client that could name either could create work in someone else's company.

Pole	Typ	Co to je
`title`	řetězec
`client_id`	celé číslo, nebo null
`latitude`	číslo, nebo null
`longitude`	číslo, nebo null
`geofence_radius_m`	celé číslo, nebo null
`site_outline`	seznam: Point

Odpověď

Project

Příklad

{
  "id": 2,
  "title": "Roof replacement",
  "owner_id": 1,
  "project_manager": {
    "name": "Tereza Nováková",
    "phone": null,
    "email": "tereza.novakova@example.com"
  },
  "client_id": null,
  "client_name": null,
  "client_contact_name": null,
  "client_contact_phone": null,
  "client_contact_email": null,
  "job_contact": null,
  "latitude": null,
  "longitude": null,
  "geofence_radius_m": null,
  "site_address": null,
  "expected_minutes": null,
  "is_assigned": false,
  "is_invited": true,
  "shifts_to_take": 0,
  "archived_at": null,
  "expenses": [
    {
      "id": 4,
      "gig_id": 2,
      "created_by_membership_id": 1,
      "created_by_name": "Tereza Nováková",
      "description": "Tiles",
      "cost_amount": 1250000,
      "cost_currency": "CZK",
      "created_at": "2026-09-07T12:52:03.941837+02:00"
    }
  ],
  "created_at": "2026-09-07T16:05:07.353539+02:00",
  "site_outline": null
}

Stavové kódy

Kód	Zpráva
201
400	invalid JSON body · title is required
401	authentication required
403	not permitted
500	internal server error

Vyzkoušet

Tělo

POST `/api/gigs/{id}/expenses`

Books a cost against a project.

API klíč nebo relace.

Workers may call this, not only managers: the app is where somebody standing in a builders' merchant records what they just bought. The service decides who may do what.

V cestě

Parametr	Co to je
`id`	Id zakázky.

Tělo požadavku

The JSON body of a create or an update.

Money crosses the wire as the raw int64 with its currency, never pre-formatted and never a float. There is no author field: the acting membership books it, and a client that could name the author could book a cost against somebody else.

Pole	Typ	Co to je
`description`	řetězec
`cost_amount`	celé číslo	Peníze: celé číslo se čtyřmi skrytými desetinnými místy, takže 4200000 je 420,00, a vedle něj měna.
`cost_currency`	řetězec

Odpověď

Expense

Příklad

{
  "id": 4,
  "gig_id": 2,
  "created_by_membership_id": 1,
  "created_by_name": "Tereza Nováková",
  "description": "Tiles",
  "cost_amount": 1250000,
  "cost_currency": "CZK",
  "created_at": "2026-09-07T12:52:03.941837+02:00"
}

Stavové kódy

Kód	Zpráva
201
400	invalid JSON body · invalid {thing} id
401	authentication required
403	not permitted
404	expense not found · gig not found
500	internal server error

Vyzkoušet

id Tělo

PATCH `/api/gigs/{id}/expenses/{expenseID}`

Corrects a cost already booked.

API klíč nebo relace.

V cestě

Parametr	Co to je
`id`	Id zakázky.
`expenseID`	Id výdaje.

Tělo požadavku

The JSON body of a create or an update.

Pole	Typ	Co to je
`description`	řetězec
`cost_amount`	celé číslo	Peníze: celé číslo se čtyřmi skrytými desetinnými místy, takže 4200000 je 420,00, a vedle něj měna.
`cost_currency`	řetězec

Odpověď

Expense

Příklad

{
  "id": 4,
  "gig_id": 2,
  "created_by_membership_id": 1,
  "created_by_name": "Tereza Nováková",
  "description": "Tiles",
  "cost_amount": 1250000,
  "cost_currency": "CZK",
  "created_at": "2026-09-07T12:52:03.941837+02:00"
}

Stavové kódy

Kód	Zpráva
200
400	invalid JSON body · invalid {thing} id
401	authentication required
403	not permitted
404	expense not found · gig not found
500	internal server error

Vyzkoušet

id expenseID Tělo

DELETE `/api/gigs/{id}/expenses/{expenseID}`

Deletes a cost.

API klíč nebo relace.

V cestě

Parametr	Co to je
`id`	Id zakázky.
`expenseID`	Id výdaje.

Odpověď

Bez těla.

Stavové kódy

Kód	Zpráva
204
400	invalid {thing} id
401	authentication required
403	not permitted
404	expense not found · gig not found
500	internal server error

Vyzkoušet

Nářadí

Serves a worker's own kit list.

Every route here answers for the ACTING MEMBERSHIP and nobody else. There is no endpoint that lists another person's tools, or everybody's tools on a project, and there is no role that would change that — a PM view of who owns what is precisely what this feature does not have.

GET `/api/tool-icons`

Returns the fixed set of icons the product ships.

Veřejné: není potřeba klíč ani relace.

It is the one definition both clients read, so a picker cannot offer a name the server would refuse. Deliberately not behind the session: it is a constant, discloses nothing, and an app that could not draw its own picker until sign-in would be worse for no gain.

Odpověď

seznam: Tool icon

Příklad

[
  {
    "name": "hammer",
    "label": "Hammer"
  },
  {
    "name": "wrench",
    "label": "Spanner"
  },
  {
    "name": "screwdriver",
    "label": "Screwdriver"
  },
  {
    "name": "pliers",
    "label": "Pliers"
  },
  {
    "name": "saw",
    "label": "Saw"
  },
  {
    "name": "trowel",
    "label": "Trowel"
  },
  {
    "name": "shovel",
    "label": "Shovel"
  },
  {
    "name": "drill",
    "label": "Drill"
  },
  {
    "name": "grinder",
    "label": "Angle grinder"
  },
  {
    "name": "breaker",
    "label": "Breaker"
  },
  {
    "name": "mixer",
    "label": "Mixer"
  },
  {
    "name": "measure",
    "label": "Tape measure"
  },
  {
    "name": "level",
    "label": "Spirit level"
  },
  {
    "name": "ladder",
    "label": "Ladder"
  },
  {
    "name": "paint",
    "label": "Paint roller"
  },
  {
    "name": "cable",
    "label": "Power lead"
  },
  {
    "name": "light",
    "label": "Work light"
  },
  {
    "name": "toolbox",
    "label": "Toolbox"
  },
  {
    "name": "safety",
    "label": "Safety gear"
  },
  {
    "name": "other",
    "label": "Other"
  }
]

Stavové kódy

Kód	Zpráva
200

Vyzkoušet

GET `/api/tools`

The caller's own kit list at this company, with the ids of the projects each tool is attached to.

API klíč nebo relace.

Odpověď

seznam: Tool

Příklad

[
  {
    "id": 12,
    "name": "SDS drill",
    "icon": "drill",
    "quantity": null,
    "created_at": "2026-09-08T14:22:41.117204+02:00",
    "gig_ids": [
      3,
      7
    ]
  },
  {
    "id": 11,
    "name": "Clamps",
    "icon": "other",
    "quantity": 6,
    "created_at": "2026-09-08T14:21:02.884113+02:00",
    "gig_ids": []
  }
]

Stavové kódy

Kód	Zpráva
200
400
401	authentication required
403	not permitted
404	tool not found
500	internal server error

Vyzkoušet

POST `/api/tools`

Adds a tool to the caller's kit list.

API klíč nebo relace.

The icon is a name from GET /api/tool-icons; the quantity is optional.

Tělo požadavku

The JSON body of a create or an update.

No membership or org field: both come from the session. A client that could name either could write somebody else's kit list.

Pole	Typ	Co to je
`name`	řetězec
`icon`	řetězec
`quantity`	celé číslo, nebo null

Odpověď

Tool

Příklad

{
  "id": 12,
  "name": "SDS drill",
  "icon": "drill",
  "quantity": null,
  "created_at": "2026-09-08T14:22:41.117204+02:00",
  "gig_ids": [
    3,
    7
  ]
}

Stavové kódy

Kód	Zpráva
201
400	invalid JSON body
401	authentication required
403	not permitted
404	tool not found
500	internal server error

Vyzkoušet

PATCH `/api/tools/{id}`

Renames a tool, or changes its icon or quantity.

API klíč nebo relace.

V cestě

Parametr	Co to je
`id`	Id nářadí.

Tělo požadavku

The JSON body of a create or an update.

No membership or org field: both come from the session. A client that could name either could write somebody else's kit list.

Pole	Typ	Co to je
`name`	řetězec
`icon`	řetězec
`quantity`	celé číslo, nebo null

Odpověď

Tool

Příklad

{
  "id": 11,
  "name": "Clamps",
  "icon": "other",
  "quantity": 6,
  "created_at": "2026-09-08T14:21:02.884113+02:00",
  "gig_ids": []
}

Stavové kódy

Kód	Zpráva
200
400	invalid JSON body · invalid {thing} id
401	authentication required
403	not permitted
404	tool not found
500	internal server error

Vyzkoušet

DELETE `/api/tools/{id}`

Deletes a tool from the kit list, and detaches it from every project it was taken to.

API klíč nebo relace.

V cestě

Parametr	Co to je
`id`	Id nářadí.

Odpověď

Bez těla.

Stavové kódy

Kód	Zpráva
204
400	invalid {thing} id
401	authentication required
403	not permitted
404	tool not found
500	internal server error

Vyzkoušet

GET `/api/gigs/{id}/tools`

Returns the caller's own tools attached to one project — what they have to load into the van for this job.

API klíč nebo relace.

V cestě

Parametr	Co to je
`id`	Id zakázky.

Odpověď

seznam: Tool

Příklad

[
  {
    "id": 12,
    "name": "SDS drill",
    "icon": "drill",
    "quantity": null,
    "created_at": "2026-09-08T14:22:41.117204+02:00",
    "gig_ids": [
      3,
      7
    ]
  },
  {
    "id": 11,
    "name": "Clamps",
    "icon": "other",
    "quantity": 6,
    "created_at": "2026-09-08T14:21:02.884113+02:00",
    "gig_ids": []
  }
]

Stavové kódy

Kód	Zpráva
200
400	invalid {thing} id
401	authentication required
403	not permitted
404	tool not found
500	internal server error

Vyzkoušet

POST `/api/gigs/{id}/tools`

Says "I am taking this to that job".

API klíč nebo relace.

Idempotent: attaching a tool that is already attached answers 204 rather than a conflict. Two taps on a building site is a bad radio, not a disagreement, and the second one meant the same as the first.

V cestě

Parametr	Co to je
`id`	Id zakázky.

Tělo požadavku

Names the tool being taken to a project.

Pole	Typ	Co to je
`tool_id`	celé číslo

Odpověď

Bez těla.

Stavové kódy

Kód	Zpráva
204
400	invalid JSON body · invalid {thing} id
401	authentication required
403	not permitted
404	tool not found
500	internal server error

Vyzkoušet

DELETE `/api/gigs/{id}/tools/{toolID}`

Removes the link and NOT the tool.

API klíč nebo relace.

Coming off one job must not cost the worker the entry.

V cestě

Parametr	Co to je
`id`	Id zakázky.
`toolID`	Id nářadí.

Odpověď

Bez těla.

Stavové kódy

Kód	Zpráva
204
400	invalid {thing} id
401	authentication required
403	not permitted
404	tool not found
500	internal server error

Vyzkoušet

Plánování kalendáře zakázky

A project's calendar, for its managers: which days it runs, the shifts on each, and laying shifts on days or taking them off again. Removing work people have accepted asks first: without confirm nothing changes and the answer says how many people would be told. A worker sees none of this; the project's days reach a worker as their shifts.

GET `/api/gigs/{id}/calendar`

A project's days in a range, each with its shifts, roles and staffing counts.

API klíč nebo relace.

from and to are calendar days, "2026-10-27", both inclusive; without them the four weeks from today on site. A range may be up to a year. A day is listed only if the project runs on it, so the gaps in a project that pauses are simply absent days. Who is on each shift is the shift's own endpoint. Managers only; a worker's week is the dashboard.

V cestě

Parametr	Co to je
`id`	Id zakázky.

Parametry dotazu

from
to

Odpověď

seznam: Calendar day

Příklad

[
  {
    "day": "2026-09-10",
    "day_id": 1,
    "shifts": [
      {
        "id": 1,
        "gig_id": 1,
        "day_id": 1,
        "starts_at": "2026-09-10T05:00:00Z",
        "ends_at": "2026-09-10T13:00:00Z",
        "required_workers": 3,
        "role_label": "1× crane op, 2× labourer",
        "created_at": "2026-09-07T09:00:00Z",
        "accepted": 1,
        "pending": 1,
        "short": 2,
        "is_open": false,
        "open_auto_accept": false,
        "offered_rate_multiplier": null,
        "roles": [
          {
            "id": 1,
            "label": "crane op",
            "headcount": 1,
            "rate_amount": 5200000,
            "rate_currency": "CZK",
            "accepted": 1,
            "pending": 0
          },
          {
            "id": 2,
            "label": "labourer",
            "headcount": 2,
            "rate_amount": null,
            "rate_currency": null,
            "accepted": 0,
            "pending": 1
          }
        ]
      }
    ]
  },
  {
    "day": "2026-09-11",
    "day_id": 2,
    "shifts": []
  }
]

Stavové kódy

Kód	Zpráva
200
400	from must be a calendar day, YYYY-MM-DD · invalid {thing} id · the range must run forwards and be at most a year · to must be a calendar day, YYYY-MM-DD
401	authentication required
403	not permitted · that application is the manager's to approve
404	assignment not found · certificate not found · certification not found · client not found · gig not found · shift not found
409	that invitation is no longer open · that is an invitation, and only the worker can accept it · that shift collides with work you have accepted · that shift is already full
500	internal server error

Vyzkoušet

POST `/api/gigs/{id}/days`

Puts days on a project's calendar.

API klíč nebo relace.

Days already on it are left as they are, so sending a range twice is harmless. Laying a shift on a day schedules the day too, so this is only needed for a day that runs with no shift planned yet. Up to a year of days in one request. The answer is the project's whole calendar. Managers only.

V cestě

Parametr	Co to je
`id`	Id zakázky.

Tělo požadavku

Names calendar days, "2026-10-27".

Pole	Typ	Co to je
`days`	seznam: řetězec
`confirm`	boolean	`confirm` is read by the removal only: without it nothing is removed and the answer says what would be.

Odpověď

seznam: Scheduled day

Stavové kódy

Kód	Zpráva
200
400	invalid JSON body · invalid {thing} id · name at least one day
401	authentication required
403	not permitted · that application is the manager's to approve
404	assignment not found · certificate not found · certification not found · client not found · gig not found · shift not found
409	that invitation is no longer open · that is an invitation, and only the worker can accept it · that shift collides with work you have accepted · that shift is already full
500	internal server error

Vyzkoušet

POST `/api/gigs/{id}/days/remove`

Takes days off a project's calendar, with their shifts.

API klíč nebo relace.

Anybody with a live place on them — accepted, or invited and not yet answered — is taken off and told once, however many of their shifts went; anybody who had accepted is emailed as well. So it asks first: without confirm nothing changes and the answer says how many people that is. A shift that has started is a record and its day cannot be removed. Managers only.

V cestě

Parametr	Co to je
`id`	Id zakázky.

Tělo požadavku

Names calendar days, "2026-10-27".

Pole	Typ	Co to je
`days`	seznam: řetězec
`confirm`	boolean	`confirm` is read by the removal only: without it nothing is removed and the answer says what would be.

Odpověď

Removed days

Stavové kódy

Kód	Zpráva
200
400	invalid JSON body · invalid {thing} id · name at least one day
401	authentication required
403	not permitted · that application is the manager's to approve
404	assignment not found · certificate not found · certification not found · client not found · gig not found · shift not found
409	that invitation is no longer open · that is an invitation, and only the worker can accept it · that shift collides with work you have accepted · that shift is already full
500	internal server error

Vyzkoušet

POST `/api/gigs/{id}/shifts`

Lays one shift on each of the days named, with its roles.

API klíč nebo relace.

The same clock times on each day, worked out day by day on site, so a week that crosses a change of the clocks is right on every day. The answer is each shift made, with its roles' ids, which an invitation names. Managers only; an archived project takes no new shifts.

V cestě

Parametr	Co to je
`id`	Id zakázky.

Tělo požadavku

One shift laid on each of several days.

Pole	Typ	Co to je
`days`	seznam: řetězec	`days` are calendar days, "2026-10-27". Each gets a shift; a day not yet on the calendar is scheduled by it.
`starts_at`	řetězec	`starts_at` and `ends_at` are clock times on site, "07:00" and "15:30". A shift that ends at or before it starts runs into the next day. The clock is kept on site whichever side of a change of the clocks a day falls.
`ends_at`	řetězec
`roles`	seznam: Role to add	`roles` are the shift's roles; the headcount is their sum. One role with no label is a plain shift. Leave empty and send `headcount` for a plain shift instead.
`headcount`	celé číslo	`headcount` is the places on a plain shift, read only when `roles` is empty.
`open`	boolean	`open` advertises every shift to the company at once; `open_auto_accept` confirms a taker outright rather than as an applicant.
`open_auto_accept`	boolean
`offered_rate_multiplier`	celé číslo, nebo null	`offered_rate_multiplier` raises each taker's usual rate on an open shift, with four implied decimals: 15000 is 1.5×. Null offers the rates as they stand. Násobek se čtyřmi skrytými desetinnými místy: 15000 je 1,5×.

Odpověď

Added shifts

Příklad

{
  "id": 1,
  "gig_id": 1,
  "day_id": 1,
  "starts_at": "2026-09-10T05:00:00Z",
  "ends_at": "2026-09-10T13:00:00Z",
  "required_workers": 3,
  "role_label": "1× crane op, 2× labourer",
  "created_at": "2026-09-07T09:00:00Z",
  "accepted": 1,
  "pending": 1,
  "short": 2,
  "is_open": false,
  "open_auto_accept": false,
  "offered_rate_multiplier": null,
  "roles": [
    {
      "id": 1,
      "label": "crane op",
      "headcount": 1,
      "rate_amount": 5200000,
      "rate_currency": "CZK",
      "accepted": 1,
      "pending": 0
    },
    {
      "id": 2,
      "label": "labourer",
      "headcount": 2,
      "rate_amount": null,
      "rate_currency": null,
      "accepted": 0,
      "pending": 1
    }
  ]
}

Stavové kódy

Kód	Zpráva
201
400	ends_at must be a time of day, as 15:00 · invalid JSON body · invalid {thing} id · name at least one day · starts_at must be a time of day, as 07:00, on a day written YYYY-MM-DD
401	authentication required
403	not permitted · that application is the manager's to approve
404	assignment not found · certificate not found · certification not found · client not found · gig not found · shift not found
409	that invitation is no longer open · that is an invitation, and only the worker can accept it · that shift collides with work you have accepted · that shift is already full
500	internal server error

Vyzkoušet

id Tělo

POST `/api/gigs/{id}/shifts/move`

Moves shifts to new dates, by a number of whole days.

API klíč nebo relace.

Clock times are kept on site. Everyone with an accepted place is asked again: their place goes back to pending with the new date as its deadline, they are told once, and anyone who had accepted is emailed. A shift that has started, or has an SOS running, stays where it is and is counted as skipped; a move that would land a shift in the past is refused whole. It asks first: without confirm nothing changes and the answer has the counts. Managers only.

V cestě

Parametr	Co to je
`id`	Id zakázky.

Tělo požadavku

Moves shifts by whole days.

Pole	Typ	Co to je
`timeslot_ids`	seznam: celé číslo	`timeslot_ids` are the shifts to move, all of this project.
`days`	celé číslo	`days` is the offset in whole days, forwards or back; never zero.
`confirm`	boolean	`confirm` says to go ahead. Without it nothing changes and the answer says what would.

Odpověď

Moved shifts

Stavové kódy

Kód	Zpráva
200
400	invalid JSON body · invalid {thing} id
401	authentication required
403	not permitted · that application is the manager's to approve
404	assignment not found · certificate not found · certification not found · client not found · gig not found · shift not found
409	that invitation is no longer open · that is an invitation, and only the worker can accept it · that shift collides with work you have accepted · that shift is already full
500	internal server error

Vyzkoušet

POST `/api/timeslots/{id}/remove`

Takes a shift off its day.

API klíč nebo relace.

Everybody with a live place on it is taken off and told, as removing a day tells them. It asks first: without confirm nothing changes and the answer counts the accepted and pending places. Managers only.

V cestě

Parametr	Co to je
`id`	Id směny.

Tělo požadavku

A removal's consent.

Pole	Typ	Co to je
`confirm`	boolean	`confirm` says to go ahead. Without it nothing changes and the answer says what would.

Odpověď

Removed shift

Stavové kódy

Kód	Zpráva
200
400	invalid JSON body · invalid {thing} id
401	authentication required
403	not permitted · that application is the manager's to approve
404	assignment not found · certificate not found · certification not found · client not found · gig not found · shift not found
409	that invitation is no longer open · that is an invitation, and only the worker can accept it · that shift collides with work you have accepted · that shift is already full
500	internal server error

Vyzkoušet

Obsazování zakázky

Staffing as a manager does it: who is on a shift, inviting people to one shift or to many, approving an applicant, taking somebody off a shift or off the whole project, opening a shift to the company, raising an SOS, and the shifts short of people. An invitation is a question — nobody counts as staffed until they accept — and every removal tells the person once. The worker's side, answering and taking shifts, is elsewhere.

GET `/api/timeslots/{id}`

One shift, with its roles and everyone on it.

API klíč nebo relace.

Each person's status is as it stands now: an unanswered invitation past the shift's start reads expired. Another company's shift is not found. Managers only.

V cestě

Parametr	Co to je
`id`	Id směny.

Odpověď

Shift with its people

Příklad

{
  "id": 1,
  "gig_id": 1,
  "day_id": 1,
  "starts_at": "2026-09-10T05:00:00Z",
  "ends_at": "2026-09-10T13:00:00Z",
  "required_workers": 3,
  "role_label": "1× crane op, 2× labourer",
  "created_at": "2026-09-07T09:00:00Z",
  "accepted": 1,
  "pending": 1,
  "short": 2,
  "is_open": true,
  "open_auto_accept": false,
  "offered_rate_multiplier": 15000,
  "roles": [
    {
      "id": 1,
      "label": "crane op",
      "headcount": 1,
      "rate_amount": 5200000,
      "rate_currency": "CZK",
      "accepted": 1,
      "pending": 0
    },
    {
      "id": 2,
      "label": "labourer",
      "headcount": 2,
      "rate_amount": null,
      "rate_currency": null,
      "accepted": 0,
      "pending": 1
    }
  ],
  "people": [
    {
      "id": 1,
      "timeslot_id": 1,
      "membership_id": 2,
      "origin": "staffed",
      "status": "accepted",
      "rate_amount": 5200000,
      "rate_currency": "CZK",
      "role_id": 1,
      "role_label": "crane op",
      "invited_at": "2026-09-07T09:00:00Z",
      "responded_at": "2026-09-07T09:05:00Z",
      "expires_at": "2026-09-10T05:00:00Z",
      "created_at": "2026-09-07T09:00:00Z",
      "takes_from": null,
      "takes_until": null,
      "worker_name": "Jana Horáková"
    },
    {
      "id": 2,
      "timeslot_id": 1,
      "membership_id": 3,
      "origin": "sos",
      "status": "pending",
      "rate_amount": null,
      "rate_currency": null,
      "role_id": 2,
      "role_label": "labourer",
      "invited_at": "2026-09-08T14:00:00Z",
      "responded_at": null,
      "expires_at": "2026-09-10T13:00:00Z",
      "created_at": "2026-09-08T14:00:00Z",
      "takes_from": null,
      "takes_until": null,
      "worker_name": "Petr Dvořák"
    }
  ]
}

Stavové kódy

Kód	Zpráva
200
400	invalid {thing} id
401	authentication required
403	not permitted · that application is the manager's to approve
404	assignment not found · certificate not found · certification not found · client not found · gig not found · shift not found
409	that invitation is no longer open · that is an invitation, and only the worker can accept it · that shift collides with work you have accepted · that shift is already full
500	internal server error

Vyzkoušet

POST `/api/timeslots/{id}/invitations`

Asks one person to one shift.

API klíč nebo relace.

The answer is the invitation, pending: it fills nothing until they accept, and it lapses at the shift's start if they never do. The rate on it is settled now — the role's, else the project's pay rate, else their own — and does not move afterwards. A person already live on the shift, a shift that has started, and somebody who does not work shifts here are each refused. The person is told once. Managers only.

V cestě

Parametr	Co to je
`id`	Id směny.

Tělo požadavku

Names who to invite to a shift, and for which role.

Pole	Typ	Co to je
`membership_id`	celé číslo	`membership_id` is the person, as the roster lists them.
`role_id`	celé číslo	`role_id` is the role on the shift they are invited for. It may be left out for a shift with one role.

Odpověď

Příklad

{
  "id": 2,
  "timeslot_id": 1,
  "membership_id": 3,
  "origin": "sos",
  "status": "pending",
  "rate_amount": null,
  "rate_currency": null,
  "role_id": 2,
  "role_label": "labourer",
  "invited_at": "2026-09-08T14:00:00Z",
  "responded_at": null,
  "expires_at": "2026-09-10T13:00:00Z",
  "created_at": "2026-09-08T14:00:00Z",
  "takes_from": null,
  "takes_until": null,
  "worker_name": "Petr Dvořák"
}

Stavové kódy

Kód	Zpráva
201
400	invalid JSON body · invalid {thing} id · membership_id is required
401	authentication required
403	not permitted · that application is the manager's to approve
404	assignment not found · certificate not found · certification not found · client not found · gig not found · shift not found
409	that invitation is no longer open · that is an invitation, and only the worker can accept it · that shift collides with work you have accepted · that shift is already full
500	internal server error

Vyzkoušet

POST `/api/gigs/{id}/invitations/batch`

Asks several people to several shifts of one project at once.

API klíč nebo relace.

Each pair becomes an ordinary invitation with its own rate and its own deadline; nothing records that they were made together. Somebody already live on a shift is skipped, not refused. More people than a shift has places, and a shift overlapping other work of theirs at this company, are allowed and said. Another project's shift, somebody who does not work shifts here, or a shift that has started refuses the whole batch and says which. Each person is told once. Send preview to see all of that without sending anything. Managers only.

V cestě

Parametr	Co to je
`id`	Id zakázky.

Tělo požadavku

Asks several people to several shifts at once.

Pole	Typ	Co to je
`membership_ids`	seznam: celé číslo	`membership_ids` are the people, from the roster.
`timeslot_ids`	seznam: celé číslo	`timeslot_ids` are the shifts, all of this project.
`role`	řetězec, nebo null	`role` names the role, by label, on a shift that has several; a shift with one role takes the batch as that role whatever the name. Null where every shift has one role.
`preview`	boolean	`preview` says to work out what the batch would do and send nothing.

Odpověď

Invitation batch

Příklad

{
  "preview": false,
  "people": 2,
  "shifts": 2,
  "invitations": 3,
  "skipped": [
    {
      "membership_id": 2,
      "worker_name": "Jana Horáková",
      "shift": {
        "timeslot_id": 1,
        "starts_at": "2026-09-10T05:00:00Z",
        "ends_at": "2026-09-10T13:00:00Z"
      }
    }
  ],
  "over_filled": [
    {
      "shift": {
        "timeslot_id": 2,
        "starts_at": "2026-09-11T05:00:00Z",
        "ends_at": "2026-09-11T13:00:00Z"
      },
      "invited": 2,
      "places": 1
    }
  ],
  "clashes": [
    {
      "membership_id": 3,
      "worker_name": "Petr Dvořák",
      "shift": {
        "timeslot_id": 2,
        "starts_at": "2026-09-11T05:00:00Z",
        "ends_at": "2026-09-11T13:00:00Z"
      },
      "with": {
        "timeslot_id": 7,
        "starts_at": "2026-09-11T10:00:00Z",
        "ends_at": "2026-09-11T14:00:00Z"
      },
      "in_batch": false
    }
  ],
  "sent": [
    {
      "id": 3,
      "timeslot_id": 2,
      "membership_id": 2,
      "origin": "staffed",
      "status": "pending",
      "rate_amount": 4200000,
      "rate_currency": "CZK",
      "role_id": 3,
      "role_label": null,
      "invited_at": "2026-09-08T14:00:00Z",
      "responded_at": null,
      "expires_at": "2026-09-11T05:00:00Z",
      "created_at": "2026-09-08T14:00:00Z",
      "takes_from": null,
      "takes_until": null,
      "worker_name": "Jana Horáková"
    }
  ]
}

Stavové kódy

Kód	Zpráva
200
400	invalid JSON body · invalid {thing} id
401	authentication required
403	not permitted · that application is the manager's to approve
404	assignment not found · certificate not found · certification not found · client not found · gig not found · shift not found
409	that invitation is no longer open · that is an invitation, and only the worker can accept it · that shift collides with work you have accepted · that shift is already full
500	internal server error

Vyzkoušet

id Tělo

POST `/api/assignments/{id}/approve`

Confirms an applicant on a shift the manager reviews takers for: an open shift or an SOS.

API klíč nebo relace.

The answer is the assignment, accepted, at the rate it was offered. A full role, an application that has lapsed, an invitation (which only the worker can accept), and an applicant who has since accepted colliding work are each refused. The person is told. Managers only.

V cestě

Parametr	Co to je
`id`	Id přiřazení: vašeho místa na směně.

Odpověď

Příklad

{
  "id": 1,
  "timeslot_id": 1,
  "membership_id": 2,
  "origin": "staffed",
  "status": "accepted",
  "rate_amount": 5200000,
  "rate_currency": "CZK",
  "role_id": 1,
  "role_label": "crane op",
  "invited_at": "2026-09-07T09:00:00Z",
  "responded_at": "2026-09-07T09:05:00Z",
  "expires_at": "2026-09-10T05:00:00Z",
  "created_at": "2026-09-07T09:00:00Z",
  "takes_from": null,
  "takes_until": null,
  "worker_name": "Jana Horáková"
}

Stavové kódy

Kód	Zpráva
200
400	invalid {thing} id
401	authentication required
403	not permitted · that application is the manager's to approve
404	assignment not found · certificate not found · certification not found · client not found · gig not found · shift not found
409	that invitation is no longer open · that is an invitation, and only the worker can accept it · that shift collides with work you have accepted · that shift is already full
500	internal server error

Vyzkoušet

POST `/api/assignments/{id}/cancel`

Takes one person off one shift.

API klíč nebo relace.

Their place is cancelled and reopens, and they are told once; if they had accepted they are emailed too, unless they turned that off. confirm is required: without it nothing changes and this answers 400, because the act is what tells a person not to come. A place already settled — declined, lapsed, withdrawn, cancelled — is refused. To take somebody off every upcoming shift of the project at once, use the project's people endpoint. Managers only.

V cestě

Parametr	Co to je
`id`	Id přiřazení: vašeho místa na směně.

Tělo požadavku

A removal's consent.

Pole	Typ	Co to je
`confirm`	boolean	`confirm` says to go ahead. Without it nothing changes and the answer says what would.

Odpověď

seznam: Person on a project

Stavové kódy

Kód	Zpráva
200
400	invalid JSON body · invalid {thing} id · send confirm: this cancels their place and tells them
401	authentication required
403	not permitted · that application is the manager's to approve
404	assignment not found · certificate not found · certification not found · client not found · gig not found · shift not found
409	that invitation is no longer open · that is an invitation, and only the worker can accept it · that shift collides with work you have accepted · that shift is already full
500	internal server error

Vyzkoušet

GET `/api/gigs/{id}/people`

Lists everyone with a live place on a project's shifts still to come: accepted, or asked and not yet answered, each once.

API klíč nebo relace.

A shift that has started is a record and is not counted; somebody whose only shifts are over is on the project's hours, not here. Managers only.

V cestě

Parametr	Co to je
`id`	Id zakázky.

Odpověď

Stavové kódy

Kód	Zpráva
200
400	invalid {thing} id
401	authentication required
403	not permitted · that application is the manager's to approve
404	assignment not found · certificate not found · certification not found · client not found · gig not found · shift not found
409	that invitation is no longer open · that is an invitation, and only the worker can accept it · that shift collides with work you have accepted · that shift is already full
500	internal server error

Vyzkoušet

POST `/api/gigs/{id}/people/{membershipID}/remove`

Takes one person off every upcoming shift of a project at once.

API klíč nebo relace.

Every live place of theirs on a shift of the project still to come is cancelled in one go, and they are told once: one push, and one email listing the accepted shifts. Their places on other projects, and on a shift of this project that has started, are not touched. It asks first: without confirm nothing changes and the answer counts the places. Managers only.

V cestě

Parametr	Co to je
`id`	Id zakázky.
`membershipID`	Id členství člověka, jak je uvádí seznam lidí.

Tělo požadavku

A removal's consent.

Pole	Typ	Co to je
`confirm`	boolean	`confirm` says to go ahead. Without it nothing changes and the answer says what would.

Odpověď

Taken off a project

Stavové kódy

Kód	Zpráva
200
400	invalid JSON body · invalid {thing} id
401	authentication required
403	not permitted · that application is the manager's to approve
404	assignment not found · certificate not found · certification not found · client not found · gig not found · shift not found
409	that invitation is no longer open · that is an invitation, and only the worker can accept it · that shift collides with work you have accepted · that shift is already full
500	internal server error

Vyzkoušet

POST `/api/timeslots/{id}/open`

Advertises a shift to the company: any worker there may take a place on it without being invited.

API klíč nebo relace.

A shift is open only because a manager said so; it is never open merely for being short. The manager chooses whether a taker is confirmed outright or reviewed, and may raise the rate. The answer is the shift as it now stands. Managers only.

V cestě

Parametr	Co to je
`id`	Id směny.

Tělo požadavku

The terms a shift is opened on.

Pole Typ Co to je

auto_accept

boolean

auto_accept confirms a taker outright, up to each role's headcount. Without it a taker lands as an applicant for the manager to approve.

offered_rate_multiplier

celé číslo, nebo null

offered_rate_multiplier raises each taker's usual rate, with four implied decimals: 15000 is 1.5×. Null offers each role's rate as it stands.

Násobek se čtyřmi skrytými desetinnými místy: 15000 je 1,5×.

Odpověď

Shift as a manager sees it

Příklad

{
  "id": 1,
  "gig_id": 1,
  "day_id": 1,
  "starts_at": "2026-09-10T05:00:00Z",
  "ends_at": "2026-09-10T13:00:00Z",
  "required_workers": 3,
  "role_label": "1× crane op, 2× labourer",
  "created_at": "2026-09-07T09:00:00Z",
  "accepted": 1,
  "pending": 1,
  "short": 2,
  "is_open": true,
  "open_auto_accept": false,
  "offered_rate_multiplier": 15000,
  "roles": [
    {
      "id": 1,
      "label": "crane op",
      "headcount": 1,
      "rate_amount": 5200000,
      "rate_currency": "CZK",
      "accepted": 1,
      "pending": 0
    },
    {
      "id": 2,
      "label": "labourer",
      "headcount": 2,
      "rate_amount": null,
      "rate_currency": null,
      "accepted": 0,
      "pending": 1
    }
  ]
}

Stavové kódy

Kód	Zpráva
200
400	a multiplier must be more than nothing · invalid JSON body · invalid {thing} id
401	authentication required
403	not permitted · that application is the manager's to approve
404	assignment not found · certificate not found · certification not found · client not found · gig not found · shift not found
409	that invitation is no longer open · that is an invitation, and only the worker can accept it · that shift collides with work you have accepted · that shift is already full
500	internal server error

Vyzkoušet

POST `/api/timeslots/{id}/close`

Stops advertising a shift.

API klíč nebo relace.

The people already on it stay on it. Managers only.

V cestě

Parametr	Co to je
`id`	Id směny.

Odpověď

Shift as a manager sees it

Příklad

{
  "id": 1,
  "gig_id": 1,
  "day_id": 1,
  "starts_at": "2026-09-10T05:00:00Z",
  "ends_at": "2026-09-10T13:00:00Z",
  "required_workers": 3,
  "role_label": "1× crane op, 2× labourer",
  "created_at": "2026-09-07T09:00:00Z",
  "accepted": 1,
  "pending": 1,
  "short": 2,
  "is_open": false,
  "open_auto_accept": false,
  "offered_rate_multiplier": null,
  "roles": [
    {
      "id": 1,
      "label": "crane op",
      "headcount": 1,
      "rate_amount": 5200000,
      "rate_currency": "CZK",
      "accepted": 1,
      "pending": 0
    },
    {
      "id": 2,
      "label": "labourer",
      "headcount": 2,
      "rate_amount": null,
      "rate_currency": null,
      "accepted": 0,
      "pending": 1
    }
  ]
}

Stavové kódy

Kód	Zpráva
200
400	invalid {thing} id
401	authentication required
403	not permitted · that application is the manager's to approve
404	assignment not found · certificate not found · certification not found · client not found · gig not found · shift not found
409	that invitation is no longer open · that is an invitation, and only the worker can accept it · that shift collides with work you have accepted · that shift is already full
500	internal server error

Vyzkoušet

POST `/api/timeslots/{id}/sos`

Raises an emergency on one short shift.

API klíč nebo relace.

An SOS is an open shift with the rate raised and a notification sent: every worker at the company who opted into emergency cover is told, and each may take a place at the raised rate until the shift ends. It is refused on a shift that is not short, that is over, or that has an SOS running; somebody who called in sick is taken off first, which is what makes the shift short. Managers only.

V cestě

Parametr	Co to je
`id`	Id směny.

Tělo požadavku

The terms an SOS is raised on.

Pole Typ Co to je

offered_rate_multiplier

celé číslo, nebo null

offered_rate_multiplier raises each taker's usual rate, with four implied decimals. Null is the default, 15000: half as much again. The project's maximum hourly rate caps what comes out.

Násobek se čtyřmi skrytými desetinnými místy: 15000 je 1,5×.

auto_accept

boolean

auto_accept confirms a responder outright, up to the role's headcount; without it responders are applicants for the manager to approve.

Odpověď

SOS raised

Příklad

{
  "id": 1,
  "timeslot_id": 1,
  "offered_rate_multiplier": 15000,
  "opened_at": "2026-09-09T16:00:00Z",
  "told": 0
}

Stavové kódy

Kód	Zpráva
201
400	a multiplier must be more than nothing · invalid JSON body · invalid {thing} id
401	authentication required
403	not permitted · that application is the manager's to approve
404	assignment not found · certificate not found · certification not found · client not found · gig not found · shift not found
409	that invitation is no longer open · that is an invitation, and only the worker can accept it · that shift collides with work you have accepted · that shift is already full
500	internal server error

Vyzkoušet

POST `/api/gigs/{id}/sos`

Raises one ordinary SOS on each of several short shifts of a project, in one go, and tells each person once.

API klíč nebo relace.

Name the shifts, or none for every short shift of the project that is not over, read now. A shift that filled, ended or has an SOS already is skipped and counted; a shift of another project refuses the lot. Managers only.

V cestě

Parametr	Co to je
`id`	Id zakázky.

Tělo požadavku

Raises an SOS over a project's short shifts.

Pole Typ Co to je

offered_rate_multiplier

celé číslo, nebo null

offered_rate_multiplier raises each taker's usual rate, with four implied decimals. Null is the default, 15000: half as much again. The project's maximum hourly rate caps what comes out.

Násobek se čtyřmi skrytými desetinnými místy: 15000 je 1,5×.

auto_accept

boolean

auto_accept confirms a responder outright, up to the role's headcount; without it responders are applicants for the manager to approve.

timeslot_ids

seznam: celé číslo

timeslot_ids are the shifts to cover, all of this project. Empty means every short shift of the project that is not over.

Odpověď

SOS over a project

Příklad

{
  "raised": [
    {
      "id": 1,
      "timeslot_id": 1,
      "offered_rate_multiplier": 15000,
      "opened_at": "2026-09-09T16:00:00Z",
      "told": 0
    }
  ],
  "already_raised": 0,
  "filled": 1,
  "over": 0,
  "told": 4
}

Stavové kódy

Kód	Zpráva
201
400	a multiplier must be more than nothing · invalid JSON body · invalid {thing} id
401	authentication required
403	not permitted · that application is the manager's to approve
404	assignment not found · certificate not found · certification not found · client not found · gig not found · shift not found
409	that invitation is no longer open · that is an invitation, and only the worker can accept it · that shift collides with work you have accepted · that shift is already full
500	internal server error

Vyzkoušet

id Tělo

GET `/api/staffing/short`

Lists the company's upcoming shifts that need attention: short of accepted people, or carrying invitations nobody has answered.

API klíč nebo relace.

days is how far ahead to look, 7 unless given, up to 92. Earliest first, across every live project. A shift whose places are all covered by unanswered invitations is listed: an invitation staffs nothing. Managers only.

all=1 lists them at every company the caller manages, earliest first within each, with company on each row naming the entry: send its entry as X-Werzeick-Company to act on the shift. A caller acting as a worker may ask too, and gets the companies they manage. It cannot be combined with X-Werzeick-Company.

Parametry dotazu

all
days

Odpověď

seznam: Shift needing attention

Příklad

[
  {
    "id": 1,
    "gig_id": 1,
    "day_id": 1,
    "starts_at": "2026-09-10T05:00:00Z",
    "ends_at": "2026-09-10T13:00:00Z",
    "required_workers": 3,
    "role_label": "1× crane op, 2× labourer",
    "created_at": "2026-09-07T09:00:00Z",
    "accepted": 1,
    "pending": 1,
    "gig_title": "Warehouse roof",
    "short": 2,
    "sos_open": true,
    "roles": [
      {
        "id": 1,
        "label": "crane op",
        "headcount": 1,
        "rate_amount": 5200000,
        "rate_currency": "CZK",
        "accepted": 1,
        "pending": 0
      },
      {
        "id": 2,
        "label": "labourer",
        "headcount": 2,
        "rate_amount": null,
        "rate_currency": null,
        "accepted": 0,
        "pending": 1
      }
    ]
  }
]

Stavové kódy

Kód	Zpráva
200
400	all=1 reads every company: leave out X-Werzeick-Company · days must be a whole number from 1 to 92
401	authentication required
403	not permitted · that application is the manager's to approve
404	assignment not found · certificate not found · certification not found · client not found · gig not found · shift not found
409	that invitation is no longer open · that is an invitation, and only the worker can accept it · that shift collides with work you have accepted · that shift is already full
500	internal server error

Vyzkoušet

Lidé ve firmě

The company's roster, for its managers: everyone with a membership at the company, what each may do here (manage projects, work shifts, or both), the default rate for anyone who works shifts, and what the company has noted each as certified for. An invitation to a shift names a person by the id listed here. Inviting somebody new to the company is the invitations endpoint.

GET `/api/people`

Lists everyone at the company, by name.

API klíč nebo relace.

rate_amount is each person's own default rate here, the fallback for a project with no pay rate of its own and a role with none; null is "no hourly rate". is_disabled marks somebody a manager has switched off, who cannot be invited. certifications is what the company has noted the person as certified for; such people are listed first in the web client's staffing picker, and nothing requires one. Somebody whose account was deleted is not listed. Managers only.

q narrows the list to the people a search finds, as the web client's person pickers do: every word of it has to be the start of a word of the person's name, or of the name, another common name or the scope of something they are certified for, with no case or accents needed. ?q=dvo finds Dvořák, ?q=vzv the forklift drivers, ?q=novák jeřáb a Novák noted for a crane, ?q=jeřáb 10 t a crane operator whose note's scope says 10 t. Without it, everybody.

Parametry dotazu

Odpověď

seznam: Person response

Příklad

[
  {
    "id": 1,
    "is_manager": true,
    "is_worker": false,
    "rate_amount": null,
    "rate_currency": null,
    "emergency_responses_enabled": false,
    "cancellation_emails_enabled": true,
    "is_disabled": false,
    "created_at": "2026-09-01T08:00:00Z",
    "org_name": "Alpha Stavby",
    "first_name": "Tomáš",
    "last_name": "Novák",
    "email": "tomas@alpha.test",
    "certifications": []
  },
  {
    "id": 2,
    "is_manager": false,
    "is_worker": true,
    "rate_amount": 4200000,
    "rate_currency": "CZK",
    "emergency_responses_enabled": true,
    "cancellation_emails_enabled": true,
    "is_disabled": false,
    "created_at": "2026-09-01T08:05:00Z",
    "org_name": "Alpha Stavby",
    "first_name": "Jana",
    "last_name": "Horáková",
    "email": "jana@alpha.test",
    "certifications": [
      {
        "id": 1,
        "membership_id": 2,
        "kind": "lift_crane_overhead",
        "label": null,
        "scope": "bridge cranes to 10 t",
        "expires_on": "2027-06-30",
        "granted_by_membership_id": 1,
        "granted_by_name": "Tomáš Novák",
        "created_at": "2026-10-28T09:00:00Z",
        "certificate_id": 1,
        "name": "Overhead or gantry crane operator"
      }
    ]
  }
]

Stavové kódy

Kód	Zpráva
200
401	authentication required
403	not permitted
500	internal server error

Vyzkoušet

POST `/api/people/{id}/certifications`

Notes a person as certified for something, by the manager's say-so, or by approving one of their certificates.

API klíč nebo relace.

Approving is sending certificate_id: the note copies what the document says and is linked to it. The note outlives the document: a certificate deleted later leaves it standing with certificate_id null.

One note per person and kind (per label for other_personal); a second of the same is refused. The person is pushed once. Nothing requires a note: it is the company's own record, shown to its managers when they staff a shift. Managers only.

V cestě

Parametr	Co to je
`id`	Id členství člověka, jak je uvádí seznam lidí.

Tělo požadavku

Notes somebody as certified for something: by the manager's say-so, or by approving one of the person's certificates.

Pole	Typ	Co to je
`certificate_id`	celé číslo	`certificate_id` approves one of the person's certificates, as the people certificates endpoint lists them: the note takes the document's kind, label, scope and expiry and points at it, and the other fields here are ignored. Leave it out for a note with no proof.
`kind`	řetězec	`kind` is a kind's `id` from the certificate kinds endpoint, or `other_personal` for one the list has no name for.
`label`	řetězec	`label` says what an `other_personal` note is for. Required for that kind, refused for any other, at most 120 characters.
`scope`	řetězec	At most 200 characters.
`expires_on`	řetězec, nebo null	`expires_on` is the day it stops being valid, "2027-06-30", or null for unknown. Blank never means "for ever".

Odpověď

Certification response

Příklad

{
  "id": 1,
  "membership_id": 2,
  "kind": "lift_crane_overhead",
  "label": null,
  "scope": "bridge cranes to 10 t",
  "expires_on": "2027-06-30",
  "granted_by_membership_id": 1,
  "granted_by_name": "Tomáš Novák",
  "created_at": "2026-10-28T09:00:00Z",
  "certificate_id": 1,
  "name": "Overhead or gantry crane operator"
}

Stavové kódy

Kód	Zpráva
201
400	expires_on must be YYYY-MM-DD or null · invalid JSON body · invalid {thing} id
401	authentication required
403	not permitted · that application is the manager's to approve
404	assignment not found · certificate not found · certification not found · client not found · gig not found · shift not found
409	that invitation is no longer open · that is an invitation, and only the worker can accept it · that shift collides with work you have accepted · that shift is already full
500	internal server error

Vyzkoušet

id Tělo

DELETE `/api/people/{id}/certifications/{certificationID}`

Takes a note away.

API klíč nebo relace.

Nobody is told. Managers only.

V cestě

Parametr	Co to je
`id`	Id členství člověka, jak je uvádí seznam lidí.
`certificationID`	ID certifikace, jak ji seznam lidí uvádí u osoby.

Odpověď

Bez těla.

Stavové kódy

Kód	Zpráva
204
400	invalid {thing} id
401	authentication required
403	not permitted · that application is the manager's to approve
404	assignment not found · certificate not found · certification not found · client not found · gig not found · shift not found
409	that invitation is no longer open · that is an invitation, and only the worker can accept it · that shift collides with work you have accepted · that shift is already full
500	internal server error

Vyzkoušet

GET `/api/people/{id}/certificates`

Lists a person's certificates: the documents they hold, with their pages' sizes, as the person themselves sees them.

API klíč nebo relace.

A certificate is the person's, not the company's, so this is the same list the person's other employers see; who uploaded one is named only when it was a manager at your own company. Managers only.

V cestě

Parametr	Co to je
`id`	Id členství člověka, jak je uvádí seznam lidí.

Odpověď

seznam: Certificate response

Příklad

[
  {
    "id": 1,
    "kind": "lift_crane_overhead",
    "label": null,
    "scope": "bridge cranes to 10 t",
    "number": "JB-4471",
    "issued_on": "2024-05-02",
    "expires_on": "2029-05-01",
    "pages": [
      {
        "position": 1,
        "content_type": "image/jpeg",
        "width": 1600,
        "height": 1067
      },
      {
        "position": 2,
        "content_type": "image/jpeg",
        "width": 1600,
        "height": 1067
      }
    ],
    "uploaded_by": {
      "membership_id": 1,
      "name": "Tomáš Novák",
      "company": "Alpha Stavby"
    },
    "created_at": "2026-10-28T09:00:00Z",
    "updated_at": "2026-10-28T09:04:00Z",
    "name": "Overhead or gantry crane operator"
  },
  {
    "id": 2,
    "kind": "other_personal",
    "label": "Drone pilot",
    "scope": null,
    "number": null,
    "issued_on": null,
    "expires_on": null,
    "pages": [],
    "uploaded_by": null,
    "created_at": "2026-10-28T10:00:00Z",
    "updated_at": "2026-10-28T10:00:00Z",
    "name": "Drone pilot"
  }
]

Stavové kódy

Kód	Zpráva
200
400	invalid {thing} id
401	authentication required
403	not permitted · that application is the manager's to approve
404	assignment not found · certificate not found · certification not found · client not found · gig not found · shift not found
409	that invitation is no longer open · that is an invitation, and only the worker can accept it · that shift collides with work you have accepted · that shift is already full
500	internal server error

Vyzkoušet

POST `/api/people/{id}/certificates`

Adds a certificate on a person's behalf, for when the office holds the scans.

API klíč nebo relace.

It is recorded as uploaded by you, shown to the person as such, and is theirs afterwards like one they uploaded: they may correct or delete it, and you may not. The pages are added afterwards, one by one. Managers only.

V cestě

Parametr	Co to je
`id`	Id členství člověka, jak je uvádí seznam lidí.

Tělo požadavku

What is typed about a certificate: what is printed on the card.

Pole	Typ	Co to je
`kind`	řetězec	`kind` is a kind's `id` from the certificate kinds endpoint, or `other_personal` for one the list has no name for.
`label`	řetězec	`label` says what an `other_personal` certificate is. Required for that kind, refused for any other, at most 120 characters.
`scope`	řetězec	At most 200 characters.
`number`	řetězec	`number` is the number printed on the card, if any. At most 60 characters; nothing is checked against it.
`issued_on`	řetězec, nebo null	`issued_on` is the day it was issued, "2024-05-02", or null.
`expires_on`	řetězec, nebo null	`expires_on` is the day it stops being valid, "2029-05-01", or null for unknown. Blank never means "for ever".

Odpověď

Příklad

{
  "id": 2,
  "kind": "other_personal",
  "label": "Drone pilot",
  "scope": null,
  "number": null,
  "issued_on": null,
  "expires_on": null,
  "pages": [],
  "uploaded_by": null,
  "created_at": "2026-10-28T10:00:00Z",
  "updated_at": "2026-10-28T10:00:00Z",
  "name": "Drone pilot"
}

Stavové kódy

Kód	Zpráva
201
400	invalid JSON body · invalid {thing} id
401	authentication required
403	not permitted · that application is the manager's to approve
404	assignment not found · certificate not found · certification not found · client not found · gig not found · shift not found
409	that invitation is no longer open · that is an invitation, and only the worker can accept it · that shift collides with work you have accepted · that shift is already full
500	internal server error

Vyzkoušet

id Tělo

POST `/api/people/{id}/certificates/{certificateID}/pages`

Adds the next page to a person's certificate, as the person's own pages endpoint does.

API klíč nebo relace.

The image comes as multipart/form-data with a part named page, or as JSON with the image in base64. At most 8 pages; what is kept is the pixels and nothing else. Managers only.

V cestě

Parametr	Co to je
`id`	Id členství člověka, jak je uvádí seznam lidí.
`certificateID`	ID dokladu, jak ho uvádí seznam dokladů.

Tělo požadavku

One page of a certificate as JSON: the image's bytes in base64. The same endpoint also takes multipart/form-data with the file in a part named page, which is what the app and the web client send.

Pole	Typ	Co to je
`image`	řetězec	A PDF is refused; a client with one renders its pages to images first. The server shrinks the image to about 1600 px on its long edge, re-encodes it as JPEG and keeps nothing else of it: no camera metadata, no position.

Odpověď

seznam: Certificate response

Příklad

{
  "id": 1,
  "kind": "lift_crane_overhead",
  "label": null,
  "scope": "bridge cranes to 10 t",
  "number": "JB-4471",
  "issued_on": "2024-05-02",
  "expires_on": "2029-05-01",
  "pages": [
    {
      "position": 1,
      "content_type": "image/jpeg",
      "width": 1600,
      "height": 1067
    },
    {
      "position": 2,
      "content_type": "image/jpeg",
      "width": 1600,
      "height": 1067
    }
  ],
  "uploaded_by": {
    "membership_id": 1,
    "name": "Tomáš Novák",
    "company": "Alpha Stavby"
  },
  "created_at": "2026-10-28T09:00:00Z",
  "updated_at": "2026-10-28T09:04:00Z",
  "name": "Overhead or gantry crane operator"
}

Stavové kódy

Kód	Zpráva
201
400	image must be base64 · invalid JSON body · invalid {thing} id · send the image as a part named page · the upload could not be read
401	authentication required
403	not permitted · that application is the manager's to approve
404	assignment not found · certificate not found · certification not found · client not found · gig not found · shift not found
409	that invitation is no longer open · that is an invitation, and only the worker can accept it · that shift collides with work you have accepted · that shift is already full
500	internal server error

Vyzkoušet

GET `/api/people/{id}/certificates/{certificateID}/pages/{position}`

Answers one page of a person's certificate as the image itself, not as JSON.

API klíč nebo relace.

Managers only.

The body is the JPEG, with its content type.

V cestě

Parametr	Co to je
`id`	Id členství člověka, jak je uvádí seznam lidí.
`certificateID`	ID dokladu, jak ho uvádí seznam dokladů.
`position`	Pořadí stránky na dokladu, počítáno od 1.

Odpověď

Bez těla.

Stavové kódy

Kód	Zpráva
200
400	invalid {thing} id
401	authentication required
403	not permitted · that application is the manager's to approve
404	assignment not found · certificate not found · certification not found · client not found · gig not found · page not found · shift not found
409	that invitation is no longer open · that is an invitation, and only the worker can accept it · that shift collides with work you have accepted · that shift is already full
500	internal server error

Vyzkoušet

Doklady

About certificates: the documents a person holds, a crane licence or a welding test, with their photos, and the kinds there are. The list of kinds is the server's, so that no client carries a copy that can drift. The certificates here are the caller's own, whichever company or role the key acts in: a certificate is the person's, and every company they work for sees the same one. A manager reads and adds a member's certificates on the people endpoints, and notes somebody as certified for one there too.

GET `/api/certificate-kinds`

Lists every kind of certificate there is, with its name in the request's language, the group it is listed under, the words people use for it, and the trades with the order each offers kinds in.

API klíč nebo relace.

One kind, other_personal, is for a certificate the list has no name for; a note or a certificate of that kind carries a typed label. Either role.

Odpověď

Certificate kinds

Příklad

{
  "groups": [
    {
      "id": "education",
      "name": "Education"
    },
    {
      "id": "qualification",
      "name": "Qualification"
    }
  ],
  "kinds": [
    {
      "id": "other_personal",
      "name": "Other document",
      "group": "other",
      "aliases": [
        "jiný certifikát",
        "jiné oprávnění",
        "neznámý doklad"
      ]
    },
    {
      "id": "lift_crane_overhead",
      "name": "Overhead or gantry crane operator",
      "group": "induction",
      "aliases": [
        "jeřábnický průkaz",
        "mostový jeřáb"
      ]
    },
    {
      "id": "weld_iso9606",
      "name": "Welder qualification test (EN ISO 9606)",
      "group": "qualification",
      "aliases": [
        "svářečský certifikát",
        "úřední zkouška",
        "ISO 9606",
        "EN 287"
      ]
    }
  ],
  "trades": [
    {
      "id": "crane_operator",
      "name": "Crane / loader crane operator",
      "preferred": [
        "lift_crane_overhead",
        "lift_crane_mobile",
        "lift_crane_tower",
        "lift_loader_crane"
      ],
      "related": [
        "lift_slinger",
        "lift_signaller",
        "driver_licence"
      ],
      "common": [
        "edu_apprenticeship",
        "edu_diploma",
        "qual_nsk",
        "edu_retraining",
        "training_manufacturer",
        "training_bozp",
        "training_fire",
        "training_first_aid",
        "training_heights",
        "training_fall_protection",
        "scheme_scc",
        "scheme_vca",
        "other_personal"
      ]
    }
  ]
}

Stavové kódy

Kód	Zpráva
200
401	authentication required

Vyzkoušet

GET `/api/certificates`

Lists the caller's own certificates, oldest first, each with its pages' sizes.

API klíč nebo relace.

The pages themselves are read one at a time. Either role: the documents are the person's, whatever the key acts as.

Odpověď

Příklad

[
  {
    "id": 1,
    "kind": "lift_crane_overhead",
    "label": null,
    "scope": "bridge cranes to 10 t",
    "number": "JB-4471",
    "issued_on": "2024-05-02",
    "expires_on": "2029-05-01",
    "pages": [
      {
        "position": 1,
        "content_type": "image/jpeg",
        "width": 1600,
        "height": 1067
      },
      {
        "position": 2,
        "content_type": "image/jpeg",
        "width": 1600,
        "height": 1067
      }
    ],
    "uploaded_by": {
      "membership_id": 1,
      "name": "Tomáš Novák",
      "company": "Alpha Stavby"
    },
    "created_at": "2026-10-28T09:00:00Z",
    "updated_at": "2026-10-28T09:04:00Z",
    "name": "Overhead or gantry crane operator"
  },
  {
    "id": 2,
    "kind": "other_personal",
    "label": "Drone pilot",
    "scope": null,
    "number": null,
    "issued_on": null,
    "expires_on": null,
    "pages": [],
    "uploaded_by": null,
    "created_at": "2026-10-28T10:00:00Z",
    "updated_at": "2026-10-28T10:00:00Z",
    "name": "Drone pilot"
  }
]

Stavové kódy

Kód	Zpráva
200
401	authentication required
403	not permitted
500	internal server error

Vyzkoušet

POST `/api/certificates`

Adds a certificate of the caller's own, with no pages yet: the photos are added one by one afterwards.

API klíč nebo relace.

The managers of every company the caller works for are pushed once when the first page lands, naming nothing. A person holds at most 50.

Tělo požadavku

What is typed about a certificate: what is printed on the card.

Pole	Typ	Co to je
`kind`	řetězec	`kind` is a kind's `id` from the certificate kinds endpoint, or `other_personal` for one the list has no name for.
`label`	řetězec	`label` says what an `other_personal` certificate is. Required for that kind, refused for any other, at most 120 characters.
`scope`	řetězec	At most 200 characters.
`number`	řetězec	`number` is the number printed on the card, if any. At most 60 characters; nothing is checked against it.
`issued_on`	řetězec, nebo null	`issued_on` is the day it was issued, "2024-05-02", or null.
`expires_on`	řetězec, nebo null	`expires_on` is the day it stops being valid, "2029-05-01", or null for unknown. Blank never means "for ever".

Odpověď

Příklad

{
  "id": 2,
  "kind": "other_personal",
  "label": "Drone pilot",
  "scope": null,
  "number": null,
  "issued_on": null,
  "expires_on": null,
  "pages": [],
  "uploaded_by": null,
  "created_at": "2026-10-28T10:00:00Z",
  "updated_at": "2026-10-28T10:00:00Z",
  "name": "Drone pilot"
}

Stavové kódy

Kód	Zpráva
201
400	invalid JSON body
401	authentication required
403	not permitted · that application is the manager's to approve
404	assignment not found · certificate not found · certification not found · client not found · gig not found · shift not found
409	that invitation is no longer open · that is an invitation, and only the worker can accept it · that shift collides with work you have accepted · that shift is already full
500	internal server error

Vyzkoušet

Tělo

POST `/api/certificates/read`

Reads the words off the photos of one document and proposes what the certificate's fields should say: its kind, the dates on it and its number, with how well each photo read.

API klíč nebo relace.

Nothing is stored; the client fills its form in from the answer and the person checks it before saving. Either role.

The photos come as multipart/form-data, each in a part named page, or as JSON with the images in base64; at most 8, each at most 4 MB. A photo is shrunk here before it is read, as it is before it is stored. Reading takes about a second a page. Answers 503 when reading is not set up on this server, in which case the form works by hand.

Tělo požadavku

The photos to read, as JSON. The same endpoint also takes multipart/form-data with each photo in a part named page, which is what the app and the web client send.

Pole	Typ	Co to je
`images`	seznam: řetězec	They are read and then forgotten; nothing is stored until the certificate is created.

Odpověď

Certificate reading

Příklad

{
  "kind": "lift_crane_overhead",
  "kind_name": "Overhead or gantry crane operator",
  "issued_on": "2024-05-02",
  "expires_on": "2029-05-01",
  "number": "JB-4471",
  "pages": [
    {
      "position": 1,
      "readability": 94,
      "legible": true
    },
    {
      "position": 2,
      "readability": 41,
      "legible": false
    },
    {
      "position": 3,
      "readability": null,
      "legible": false
    }
  ],
  "legible": false
}

Stavové kódy

Kód	Zpráva
200
400	image must be base64 · invalid JSON body · send at least one page to read · send the image as a part named page · the upload could not be read
401	authentication required
403	not permitted · that application is the manager's to approve
404	assignment not found · certificate not found · certification not found · client not found · gig not found · shift not found
409	that invitation is no longer open · that is an invitation, and only the worker can accept it · that shift collides with work you have accepted · that shift is already full
500	internal server error
503	reading photos is not set up on this server; fill the form in by hand

Vyzkoušet

PATCH `/api/certificates/{id}`

Corrects what is typed about one of the caller's certificates.

API klíč nebo relace.

Every field is written as sent, so send the whole record; the pages are untouched.

V cestě

Parametr	Co to je
`id`	ID dokladu, jak ho uvádí seznam dokladů.

Tělo požadavku

What is typed about a certificate: what is printed on the card.

Pole	Typ	Co to je
`kind`	řetězec	`kind` is a kind's `id` from the certificate kinds endpoint, or `other_personal` for one the list has no name for.
`label`	řetězec	`label` says what an `other_personal` certificate is. Required for that kind, refused for any other, at most 120 characters.
`scope`	řetězec	At most 200 characters.
`number`	řetězec	`number` is the number printed on the card, if any. At most 60 characters; nothing is checked against it.
`issued_on`	řetězec, nebo null	`issued_on` is the day it was issued, "2024-05-02", or null.
`expires_on`	řetězec, nebo null	`expires_on` is the day it stops being valid, "2029-05-01", or null for unknown. Blank never means "for ever".

Odpověď

Příklad

{
  "id": 1,
  "kind": "lift_crane_overhead",
  "label": null,
  "scope": "bridge cranes to 10 t",
  "number": "JB-4471",
  "issued_on": "2024-05-02",
  "expires_on": "2029-05-01",
  "pages": [
    {
      "position": 1,
      "content_type": "image/jpeg",
      "width": 1600,
      "height": 1067
    },
    {
      "position": 2,
      "content_type": "image/jpeg",
      "width": 1600,
      "height": 1067
    }
  ],
  "uploaded_by": {
    "membership_id": 1,
    "name": "Tomáš Novák",
    "company": "Alpha Stavby"
  },
  "created_at": "2026-10-28T09:00:00Z",
  "updated_at": "2026-10-28T09:04:00Z",
  "name": "Overhead or gantry crane operator"
}

Stavové kódy

Kód	Zpráva
200
400	invalid JSON body · invalid {thing} id
401	authentication required
403	not permitted · that application is the manager's to approve
404	assignment not found · certificate not found · certification not found · client not found · gig not found · shift not found
409	that invitation is no longer open · that is an invitation, and only the worker can accept it · that shift collides with work you have accepted · that shift is already full
500	internal server error

Vyzkoušet

id Tělo

DELETE `/api/certificates/{id}`

Removes one of the caller's certificates with its pages.

API klíč nebo relace.

A note a company made from it stays, saying it has no proof on file. Nobody is told.

V cestě

Parametr	Co to je
`id`	ID dokladu, jak ho uvádí seznam dokladů.

Odpověď

Bez těla.

Stavové kódy

Kód	Zpráva
204
400	invalid {thing} id
401	authentication required
403	not permitted · that application is the manager's to approve
404	assignment not found · certificate not found · certification not found · client not found · gig not found · shift not found
409	that invitation is no longer open · that is an invitation, and only the worker can accept it · that shift collides with work you have accepted · that shift is already full
500	internal server error

Vyzkoušet

POST `/api/certificates/{id}/pages`

Adds the next page to one of the caller's certificates: the front, the back, an attachment, at most 8.

API klíč nebo relace.

The image comes as multipart/form-data in a part named page, or as JSON with the bytes in base64. Whatever is sent, what is kept is a JPEG of the pixels and nothing else: no camera metadata, no position. Answers the certificate with its pages.

V cestě

Parametr	Co to je
`id`	ID dokladu, jak ho uvádí seznam dokladů.

Tělo požadavku

One page of a certificate as JSON: the image's bytes in base64. The same endpoint also takes multipart/form-data with the file in a part named page, which is what the app and the web client send.

Pole	Typ	Co to je
`image`	řetězec	A PDF is refused; a client with one renders its pages to images first. The server shrinks the image to about 1600 px on its long edge, re-encodes it as JPEG and keeps nothing else of it: no camera metadata, no position.

Odpověď

Příklad

{
  "id": 1,
  "kind": "lift_crane_overhead",
  "label": null,
  "scope": "bridge cranes to 10 t",
  "number": "JB-4471",
  "issued_on": "2024-05-02",
  "expires_on": "2029-05-01",
  "pages": [
    {
      "position": 1,
      "content_type": "image/jpeg",
      "width": 1600,
      "height": 1067
    },
    {
      "position": 2,
      "content_type": "image/jpeg",
      "width": 1600,
      "height": 1067
    }
  ],
  "uploaded_by": {
    "membership_id": 1,
    "name": "Tomáš Novák",
    "company": "Alpha Stavby"
  },
  "created_at": "2026-10-28T09:00:00Z",
  "updated_at": "2026-10-28T09:04:00Z",
  "name": "Overhead or gantry crane operator"
}

Stavové kódy

Kód	Zpráva
201
400	image must be base64 · invalid JSON body · invalid {thing} id · send the image as a part named page · the upload could not be read
401	authentication required
403	not permitted · that application is the manager's to approve
404	assignment not found · certificate not found · certification not found · client not found · gig not found · shift not found
409	that invitation is no longer open · that is an invitation, and only the worker can accept it · that shift collides with work you have accepted · that shift is already full
500	internal server error

Vyzkoušet

GET `/api/certificates/{id}/pages/{position}`

Answers one page of one of the caller's certificates as the image itself, not as JSON.

API klíč nebo relace.

The body is the JPEG, with its content type.

V cestě

Parametr	Co to je
`id`	ID dokladu, jak ho uvádí seznam dokladů.
`position`	Pořadí stránky na dokladu, počítáno od 1.

Odpověď

Bez těla.

Stavové kódy

Kód	Zpráva
200
400	invalid {thing} id
401	authentication required
403	not permitted · that application is the manager's to approve
404	assignment not found · certificate not found · certification not found · client not found · gig not found · page not found · shift not found
409	that invitation is no longer open · that is an invitation, and only the worker can accept it · that shift collides with work you have accepted · that shift is already full
500	internal server error

Vyzkoušet

DELETE `/api/certificates/{id}/pages/{position}`

Takes one page off one of the caller's certificates; the pages after it move up.

API klíč nebo relace.

Answers the certificate as it is now.

V cestě

Parametr	Co to je
`id`	ID dokladu, jak ho uvádí seznam dokladů.
`position`	Pořadí stránky na dokladu, počítáno od 1.

Odpověď