API Ryoma: account
The current user and their own metrics
This page is generated from
openapi.yamlbynpm run gen, so do not edit it by hand. Authentication is described on the overview page.
/v1/meCurrent user (from Tara)
Responses
| Code | Description | Type |
|---|---|---|
| 200 | User | application/json · object |
| 401 | Missing or invalid token | application/problem+json · object |
Example response
json
{
"id": "string",
"login": "string",
"name": "string",
"email": "string",
"isPlatformStaff": false
}Call with curl
bash
curl "https://ryoma.phillipcli.cloud/v1/me" \
-H "Authorization: Bearer $TARA_TOKEN"/v1/me/usageMy usage in the current cycle
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
period | query | day | week | month |
Responses
| Code | Description | Type |
|---|---|---|
| 200 | Total, by day and by project | application/json · object |
| 400 | Invalid parameters | application/problem+json · object |
| 401 | Missing or invalid token | application/problem+json · object |
| 503 | Tara did not answer the check of which projects the caller can see (private projects). Ryoma never treats this as "sees everything"; retry after the Retry-After header (30 seconds) | application/problem+json · object |
Example response
json
{
"period": "week",
"from": "2026-11-01T00:00:00Z",
"to": "2026-11-01T00:00:00Z",
"total": {
"costUsd": 0,
"tokens": {
"input": 0,
"output": 0,
"cacheRead": 0,
"cacheCreation": 0
},
"requests": 0,
"sessions": 0
},
"byDay": [
{
"costUsd": 0,
"tokens": {},
"requests": 0,
"sessions": 0,
"key": "string",
"label": "string"
}
],
"byProject": [
{
"costUsd": 0,
"tokens": {},
"requests": 0,
"sessions": 0,
"key": "string",
"label": "string"
}
],
"byIssue": [
{
"costUsd": 0,
"tokens": {},
"requests": 0,
"sessions": 0,
"key": "string",
"label": "string"
}
]
}Call with curl
bash
curl "https://ryoma.phillipcli.cloud/v1/me/usage" \
-H "Authorization: Bearer $TARA_TOKEN"/v1/me/requestsEach of my model requests (to reconcile with the local transcript)
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
from | query | string (date-time) | yes | |
to | query | string (date-time) | yes |
Responses
| Code | Description | Type |
|---|---|---|
| 200 | List of requests, at most 50,000 | application/json · object |
| 400 | Invalid parameters | application/problem+json · object |
| 401 | Missing or invalid token | application/problem+json · object |
| 503 | Tara did not answer the check of which projects the caller can see (private projects). Ryoma never treats this as "sees everything"; retry after the Retry-After header (30 seconds) | application/problem+json · object |
Example response
json
{
"items": [
{
"requestId": "string",
"sessionId": "string",
"time": "2026-11-01T00:00:00Z",
"model": "string",
"querySource": "string",
"tokens": {},
"costUsd": 0
}
],
"truncated": false
}Call with curl
bash
curl "https://ryoma.phillipcli.cloud/v1/me/requests?from=2026-11-01T00:00:00Z&to=2026-11-01T00:00:00Z" \
-H "Authorization: Bearer $TARA_TOKEN"