Inbox

Your inbox

GET
/v1/workspaces/{workspace_id}/inbox

Everything waiting for you in the workspace, across documents and time off (and expenses when it arrives): For me, or Team for what waits on the people below you. The same rows as the web app’s Inbox, worded in your language.

Authorization

bearer
headerAuthorizationBearer <token>

An access token from /v1/auth/token, or a personal token: opaque, beginning s2a_.

Path Parameters

workspace_id*string

wsp_…, from GET /v1/me

Lengthlength <= 40

Query Parameters

tab?string
Default"for_me"
Value in"for_me""team"
module?string
Value in"documents""timeoff""expenses"

Response Body

The items, oldest first

application/json
  1. response

The items, oldest first

data*array<>
decline_needs_reason*boolean

The workspace asks for a reason to decline leave

curl -X GET 'https://api.sign2approve.com/v1/workspaces/string/inbox'
{  "data": [    {      "id": "timeoff:01a16d3fd3507be78e41c4540aa20a3c",      "module": "timeoff",      "ask": "decide",      "assignment": "personal",      "who": "Sam Sender",      "title": "Annual leave, 3 to 5 November",      "detail": "Sales · takes 3 days · 12 days left after",      "since": "2026-10-24T09:30:00Z",      "assignee": null,      "can_act": true,      "entity": {        "type": "leave_request",        "id": "req_01a16d3fd3507be78e41c4540aa20a3c"      },      "web_url": "https://app.example.test/w/larkspur/inbox#request=01a16d3f-d350-7be7-8e41-c4540aa20a3c"    }  ],  "decline_needs_reason": false}