Skip to content
Docs

Timecards

GET
/api/workspaces/{ws}/hires/{id}/timecards

Each task the hire worked on, newest first: who asked, where, when it started and ended, the steps, the outcome and the files shared. A step that finished a piece of work or a goal carries its evidence (links, ids, numbers), shown next to it. Page with before = the previous page's next.

Authorization

session
cookiebetter-auth.session_token<token>

Set by POST /api/auth/sign-in/email.

Path Parameters

ws*string

The workspace id (from GET /api/me).

id*string

The id of what the path names: a hire, a connection, a skill, a shared file, a department, a position, a goal or an approval.

Query Parameters

before?string
Lengthlength <= 200
limit?integer
Range1 <= value <= 100
Default20

Response Body

{ items, next }.

Example Request
curl -X GET 'https://app.useroster.work/api/workspaces/string/hires/string/timecards'
Example Response
Empty

The install link GET

Where to install (or re-install) the hire's app on more repositories.

One timecard GET

One task in full: the request, every step with its detail and evidence, the reply, and the files shared. What was said in a direct message shows only to the workspace's owners and admins.