Documentation
API and MCP.
You do not need this page to use TORIN: everything here is also in the app. It is for whoever connects TORIN to other tools, through the API under /v1/ or the MCP server under /mcp (Claude and ChatGPT included).
Accounts open on 1 December 2026. Join the list and we will email you once.
- conversation7 endpoints
- read6 endpoints
- files3 endpoints
- usage2 endpoints
- any, log1 endpoint each
First call
Your credit balance in one request.
You create the key in your agency settings and can revoke it at any time. Send it in the Authorization or x-api-key header.
Request
curl https://app.hiretorin.com/v1/credits \
-H "Authorization: Bearer $TORIN_API_KEY"Response (sample values)
{
"object": "credits",
"balance": 240,
"buckets": {
"carried_over": 0,
"plan": 240,
"topped_up": 0
},
"tier": "probny",
"period": "2026-11",
"included_in_tier": 2000,
"renews_on": "2026-12-01",
"grosz_per_credit": 1,
"low": false,
"note": "240 credits left (worth 2.40 PLN)."
}probny is the id of the trial plan; grosz_per_credit is the price of one credit in grosze (1/100 of a zloty, PLN).
Counted from the product on 22 November 202613 response fields
Claude and ChatGPT
The MCP server.
A change to a client's account made through the API or MCP becomes a proposal, not an action: the same approvals apply as in the app.
MCP server address: https://app.hiretorin.com/mcp
Sign-in: OAuth (the connector finds the
authorization server under /.well-known/)
Scope: read (id: czytaj); change tools create proposalsEndpoints
What the API offers.

| Method | Path | Key scope | What it does |
|---|---|---|---|
GET | /v1/models | any dowolny | models you can order |
GET | /v1/credits | usage zuzycie | the agency's credit balance |
GET | /v1/usage | usage zuzycie | usage over a period |
POST | /v1/chat/completions | conversation rozmowa | a question in an OpenAI-compatible format |
POST | /v1/messages | conversation rozmowa | a question in an Anthropic-compatible format |
POST | /mcp | read czytaj | MCP server (read tools) |
GET | /v1/threads | read czytaj | the agency's conversations |
GET | /v1/threads/{id} | read czytaj | a single conversation |
POST | /v1/threads | conversation rozmowa | a new conversation |
POST | /v1/threads/{id}/messages | conversation rozmowa | a message in a conversation |
GET | /v1/runs | read czytaj | work runs |
GET | /v1/runs/{id} | read czytaj | a single run |
POST | /v1/runs | conversation rozmowa | a job to run in the background |
POST | /v1/runs/{id}/decyzja | conversation rozmowa | a decision in a run that is waiting for one |
POST | /v1/runs/{id}/anuluj | conversation rozmowa | stopping a run |
GET | /v1/tools | read czytaj | tools, and which of them need approval |
GET | /v1/files | files pliki | files from conversations |
GET | /v1/files/{id} | files pliki | a single file |
POST | /v1/files/{id}/link | files pliki | a link to a file, valid for fifteen minutes |
GET | /v1/audit | log dziennik | the agency's event log |
Counted from the product on 22 November 202620 endpoints
Tests
How we check it.
Every module has its own offline test suite. The full run happens with network access blocked, so no test depends on anyone else's API.
- 285
- suites
- 388,393
- checks
- 0
- attempts to reach the network
Counted from the product on 22 November 2026last full run, all green
Try it on one client's account.
No card and no password. The trial plan is €4.58 net of Torin's work.
