Backend API route map - Pinter

All v2 backend routes are mounted under:

/api/v2

Route registration lives in pinter-be/routes/v2/__init__.py.

Route groups

Prefix	File	Purpose
`/agents`	`agents.py`	Agent CRUD, publish, versions, export, import, restore, instruction generation.
`/conversations`	`conversations.py`	Conversations, messages, attachments, promote, send.
`/models`	`models.py`	Model CRUD, catalog, provider list, pricing sync.
`/tools`	`tools.py`	Tool CRUD, tool library, documents, document upload.
`/mcp-servers`	`mcp_servers.py`	MCP server CRUD, connection test, tool listing.
`/templates`	`templates.py`	Marketplace and template lifecycle.
`/evaluations`	`evaluations.py`	Eval sets, eval cases, eval runs, comparisons.
`/quotas`	`quotas.py`	Quotas, usage, alerts.
`/execution-traces`	`execution_traces.py`	Message and conversation traces.
`/users`	`users.py`	User search, create, update, delete, role groups.
`/integrations`	`integrations.py`	Integration CRUD and webhook receive.
`/budget-requests`	`budget_requests.py`	Budget request create, list, review.
`/api-keys`	`api_keys.py`	Personal and admin API keys.
`/grants`	`grants.py`	Access requests, mapping, approvals, fast grant, revoke.
`/auth/sso`	`auth_sso.py`	SSO JWT exchange.
`/api-studio`	`api_studio.py`	API Studio CRUD, versions, run.
`/share`	`share.py`	Direct share and claim code flow.
`/applications`	`applications.py`	Application credentials and secret rotation.

Common frontend mappings

Frontend area	Backend route groups
Chat	`/conversations`, `/execution-traces`, `/quotas/usage`
Builder	`/agents`, `/tools`, `/models`, `/mcp-servers`, `/templates`
Tools and documents	`/tools`, `/tools/documents`, `/integrations`, `/mcp-servers`
Evaluations	`/evaluations`, `/agents`
Marketplace	`/templates`, `/agents`
Admin users	`/users`, `/grants`
Admin models	`/models`, `/api-keys`
Admin quotas and usage	`/quotas`, `/budget-requests`
Applications	`/applications`

Endpoint-level reference

For endpoint-level details, use the generated pages in the API reference tab. They are built from the backend OpenAPI schema. To refresh the schema after backend route changes:

cd pinter-be
python scripts/export_openapi.py
cp docs/openapi.json ../pinter-fe/docs/openapi.json