Usage Activity

GET

/api/v1/usage/activity

GET

/api/v1/usage/activity

$ curl https://api.onepin.ai/api/v1/usage/activity \
>      -H "Authorization: Bearer <token>" \
>      -H "Content-Type: application/json"

1 {
2   "data": [
3     {
4       "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
5       "timestamp": "2024-04-20T14:22:00Z",
6       "action": "workflow_run",
7       "kind": "automation",
8       "resource": {
9         "type": "workflow",
10         "id": "wf_1234567890",
11         "name": "Monthly Report Generator"
12       },
13       "user": {
14         "id": "d290f1ee-6c54-4b01-90e6-d701748f0851",
15         "name": "Alice Johnson"
16       },
17       "metadata": {
18         "duration_seconds": 45,
19         "status": "success"
20       },
21       "ip": "192.168.1.15"
22     }
23   ],
24   "meta": {
25     "request_id": "req_7f8e9d6c-1234-4b56-8a9b-0c1d2e3f4a5b",
26     "timestamp": "2024-04-20T14:22:01Z"
27   },
28   "pagination": {
29     "limit": 20,
30     "next": "cursor_eyJpZCI6IjNmYTg1ZjY0NTcxNzQ1NjJiM2ZjMmM5NjNmNjZhZmE2IiwidGltZXN0YW1wIjoiMjAyNC0wNC0yMFQxNDoyMjowMFoifQ==",
31     "prev": null
32   }
33 }

Return the workspace usage activity feed with stable action filters and cursor pagination.

Authentication

AuthorizationBearer

Clerk JWT token

AuthorizationBearer

Onepin live API key (op_live_...). Test and public keys are reserved in Phase 1.

Query parameters

rangeenumOptionalDefaults to 30d

Rolling local calendar-day range.

Allowed values:

typeenum or nullOptional

Filter by usage activity type.

user_idstring or nullOptionalformat: "uuid"

Filter by actor user id.

limitintegerOptional1-100Defaults to 20

cursorstring or nullOptional

Opaque pagination cursor.

timezonestringOptionalDefaults to UTC

IANA timezone for local day bucketing.

Response

Successful Response

datalist of objects

metaobject

paginationobject

Errors

422

Unprocessable Entity Error

Authentication

Headers

Query parameters

Response

Errors