{ "openapi": "3.1.0", "info": { "title": "Polaris Core", "description": "Business core of Polaris, a personal job-hunting agent for LLM and Agent internships. Every model call and tool call is traced (tokens, latency, cost) and every job can be traced back to its source. Read-only tools are also exposed over MCP (streamable HTTP) at /mcp/ with a bearer token.", "version": "0.1.0" }, "paths": { "/health": { "get": { "tags": [ "system" ], "summary": "Service, database and model config", "operationId": "health_health_get", "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Health" } } } } } } }, "/api/llm-calls": { "get": { "tags": [ "tracing" ], "summary": "List traced model calls (newest first)", "operationId": "list_llm_calls_api_llm_calls_get", "parameters": [ { "name": "purpose", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Purpose" } }, { "name": "model", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Model" } }, { "name": "run_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Run Id" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 200, "minimum": 1, "default": 50, "title": "Limit" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "default": 0, "title": "Offset" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/LLMCallSummary" }, "title": "Response List Llm Calls Api Llm Calls Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/llm-calls/{call_id}": { "get": { "tags": [ "tracing" ], "summary": "One model call with full request and response, for replay", "operationId": "get_llm_call_api_llm_calls__call_id__get", "parameters": [ { "name": "call_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Call Id" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/LLMCallDetail" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/tool-calls": { "get": { "tags": [ "tracing" ], "summary": "List traced tool calls (newest first), including failed and replayed ones", "operationId": "list_tool_calls_api_tool_calls_get", "parameters": [ { "name": "run_id", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Run Id" } }, { "name": "tool", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Tool" } }, { "name": "ok", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Ok" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 200, "minimum": 1, "default": 50, "title": "Limit" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "default": 0, "title": "Offset" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/ToolCallOut" }, "title": "Response List Tool Calls Api Tool Calls Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/runs": { "get": { "tags": [ "tracing" ], "summary": "List runs (collect, extract, eval, seed, synth) with their metrics", "operationId": "list_runs_api_runs_get", "parameters": [ { "name": "kind", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Kind" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 200, "minimum": 1, "default": 50, "title": "Limit" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "default": 0, "title": "Offset" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/RunOut" }, "title": "Response List Runs Api Runs Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/runs/{run_id}": { "get": { "tags": [ "tracing" ], "summary": "One run", "operationId": "get_run_api_runs__run_id__get", "parameters": [ { "name": "run_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Run Id" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/raw-items": { "get": { "tags": [ "data" ], "summary": "List raw items as collected (text truncated; fetch one item for the full text)", "operationId": "list_raw_items_api_raw_items_get", "parameters": [ { "name": "source", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source" } }, { "name": "tier", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Tier" } }, { "name": "kind", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Kind" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "maximum": 200, "minimum": 1, "default": 50, "title": "Limit" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "minimum": 0, "default": 0, "title": "Offset" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/RawItemOut" }, "title": "Response List Raw Items Api Raw Items Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/raw-items/{item_id}": { "get": { "tags": [ "data" ], "summary": "One raw item", "operationId": "get_raw_item_api_raw_items__item_id__get", "parameters": [ { "name": "item_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Item Id" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RawItemOut" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/me/chat/tasks": { "post": { "tags": [ "personal" ], "summary": "Persist a message and start an independent background task", "operationId": "submit_chat_api_me_chat_tasks_post", "parameters": [ { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskIn" } } } }, "responses": { "202": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Submit Chat Api Me Chat Tasks Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/me/chat/{thread_id}/resume/tasks": { "post": { "tags": [ "personal" ], "summary": "Persist an approval decision (idempotent)", "operationId": "submit_resume_api_me_chat__thread_id__resume_tasks_post", "parameters": [ { "name": "thread_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Thread Id" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResumeTaskIn" } } } }, "responses": { "202": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Submit Resume Api Me Chat Thread Id Resume Tasks Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/me/chat/threads": { "get": { "tags": [ "personal" ], "summary": "Recent conversations, including background work and pending approvals", "operationId": "chat_threads_api_me_chat_threads_get", "parameters": [ { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "title": "Response Chat Threads Api Me Chat Threads Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/me/chat/tasks/{task_id}": { "get": { "tags": [ "personal" ], "summary": "Durable progress and result, available after reconnecting", "operationId": "task_status_api_me_chat_tasks__task_id__get", "parameters": [ { "name": "task_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Task Id" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Task Status Api Me Chat Tasks Task Id Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/me/chat/tasks/{task_id}/cancel": { "post": { "tags": [ "personal" ], "summary": "Stop a queued or running answer; the message itself is kept", "operationId": "cancel_task_api_me_chat_tasks__task_id__cancel_post", "parameters": [ { "name": "task_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Task Id" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Cancel Task Api Me Chat Tasks Task Id Cancel Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/me/chat": { "post": { "tags": [ "personal" ], "summary": "Say something to Polaris (memory first, then the agent answers)", "operationId": "chat_endpoint_api_me_chat_post", "parameters": [ { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChatIn" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Chat Endpoint Api Me Chat Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/me/chat/{thread_id}/resume": { "post": { "tags": [ "personal" ], "summary": "Approve or reject the action Polaris is waiting on", "operationId": "resume_endpoint_api_me_chat__thread_id__resume_post", "parameters": [ { "name": "thread_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Thread Id" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResumeIn" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Resume Endpoint Api Me Chat Thread Id Resume Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/me/chat/stream": { "post": { "tags": [ "personal" ], "summary": "Same as /chat, streamed as server-sent events: memory, tool, token, done", "operationId": "chat_stream_endpoint_api_me_chat_stream_post", "parameters": [ { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ChatIn" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Chat Stream Endpoint Api Me Chat Stream Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/me/chat/{thread_id}/resume/stream": { "post": { "tags": [ "personal" ], "summary": "Same as /resume, streamed", "operationId": "resume_stream_endpoint_api_me_chat__thread_id__resume_stream_post", "parameters": [ { "name": "thread_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Thread Id" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ResumeIn" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "title": "Response Resume Stream Endpoint Api Me Chat Thread Id Resume Stream Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/me/memory": { "get": { "tags": [ "personal" ], "summary": "What Polaris remembers about you (on a given day), plus what it is waiting to confirm", "operationId": "memory_card_endpoint_api_me_memory_get", "parameters": [ { "name": "on", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "On" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Memory Card Endpoint Api Me Memory Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/me/results/{reference}": { "get": { "tags": [ "personal" ], "summary": "Read a result directly, with full original sources and current followup state", "operationId": "result_detail_api_me_results__reference__get", "parameters": [ { "name": "reference", "in": "path", "required": true, "schema": { "type": "string", "title": "Reference" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Result Detail Api Me Results Reference Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/me/jobs/{reference}/followup": { "post": { "tags": [ "personal" ], "summary": "An explicit user action updates one job; retries are idempotent", "operationId": "update_followup_api_me_jobs__reference__followup_post", "parameters": [ { "name": "reference", "in": "path", "required": true, "schema": { "type": "string", "title": "Reference" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FollowupIn" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Update Followup Api Me Jobs Reference Followup Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/me/jobs/{reference}/followup/draft": { "post": { "tags": [ "personal" ], "summary": "Draft a follow-up message for one job; never sent by Polaris", "operationId": "draft_followup_api_me_jobs__reference__followup_draft_post", "parameters": [ { "name": "reference", "in": "path", "required": true, "schema": { "type": "string", "title": "Reference" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Draft Followup Api Me Jobs Reference Followup Draft Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/me/funnel": { "get": { "tags": [ "personal" ], "summary": "Application funnel: furthest step each job reached, by channel and week", "operationId": "funnel_endpoint_api_me_funnel_get", "parameters": [ { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Funnel Endpoint Api Me Funnel Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/me/watches": { "get": { "tags": [ "personal" ], "summary": "Follow-up cards (long-running goals): scope, targets, recent events, latest report", "operationId": "list_watches_api_me_watches_get", "parameters": [ { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "title": "Response List Watches Api Me Watches Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "post": { "tags": [ "personal" ], "summary": "Open a follow-up card; the first check only builds a baseline", "operationId": "create_watch_api_me_watches_post", "parameters": [ { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WatchIn" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Create Watch Api Me Watches Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/me/watches/{watch_id}": { "get": { "tags": [ "personal" ], "summary": "One follow-up card with its event timeline and latest report", "operationId": "get_watch_api_me_watches__watch_id__get", "parameters": [ { "name": "watch_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Watch Id" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Get Watch Api Me Watches Watch Id Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } }, "patch": { "tags": [ "personal" ], "summary": "Edit scope (bumps version), pause, resume or end a follow-up card", "operationId": "patch_watch_api_me_watches__watch_id__patch", "parameters": [ { "name": "watch_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Watch Id" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WatchPatch" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Patch Watch Api Me Watches Watch Id Patch" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/me/watches/{watch_id}/targets": { "post": { "tags": [ "personal" ], "summary": "Add or remove a target job; adding snapshots it right away", "operationId": "watch_target_api_me_watches__watch_id__targets_post", "parameters": [ { "name": "watch_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Watch Id" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WatchTargetIn" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Watch Target Api Me Watches Watch Id Targets Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/me/watches/{watch_id}/check": { "post": { "tags": [ "personal" ], "summary": "Check now (reads the local library; no model call)", "operationId": "check_watch_api_me_watches__watch_id__check_post", "parameters": [ { "name": "watch_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Watch Id" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Check Watch Api Me Watches Watch Id Check Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/me/watches/{watch_id}/report": { "post": { "tags": [ "personal" ], "summary": "Write a situation report now (rules first, then the model; falls back to rules)", "operationId": "report_watch_api_me_watches__watch_id__report_post", "parameters": [ { "name": "watch_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Watch Id" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Report Watch Api Me Watches Watch Id Report Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/me/watches/{watch_id}/events/read": { "post": { "tags": [ "personal" ], "summary": "Mark this card's events as read", "operationId": "read_watch_events_api_me_watches__watch_id__events_read_post", "parameters": [ { "name": "watch_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Watch Id" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Read Watch Events Api Me Watches Watch Id Events Read Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/me/demo/script": { "get": { "tags": [ "personal" ], "summary": "Synthetic demo only: where the follow-up card script is", "operationId": "demo_script_api_me_demo_script_get", "parameters": [ { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Demo Script Api Me Demo Script Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/me/demo/advance": { "post": { "tags": [ "personal" ], "summary": "Synthetic demo only: change a little synthetic data, then check the demo card", "operationId": "demo_advance_api_me_demo_advance_post", "parameters": [ { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Demo Advance Api Me Demo Advance Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/me/demo/reset": { "post": { "tags": [ "personal" ], "summary": "Synthetic demo only: undo the script so it can be shown again", "operationId": "demo_reset_api_me_demo_reset_post", "parameters": [ { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Demo Reset Api Me Demo Reset Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/me/followups": { "get": { "tags": [ "personal" ], "summary": "Saved jobs and independent application progress", "operationId": "followups_endpoint_api_me_followups_get", "parameters": [ { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "title": "Response Followups Endpoint Api Me Followups Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/me/knowledge/posts": { "get": { "tags": [ "personal" ], "summary": "Browse source-backed interview, referral and recruiting posts without model calls", "operationId": "browse_posts_api_me_knowledge_posts_get", "parameters": [ { "name": "company", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Company" } }, { "name": "post_type", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Post Type" } }, { "name": "material", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Material" } }, { "name": "role", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Role" } }, { "name": "job_type", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Job Type" } }, { "name": "source", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source" } }, { "name": "text", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Text" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 20, "title": "Limit" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "default": 0, "title": "Offset" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Browse Posts Api Me Knowledge Posts Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/me/knowledge/questions": { "get": { "tags": [ "personal" ], "summary": "Browse questions by actual interview company, role, round and material", "operationId": "browse_questions_api_me_knowledge_questions_get", "parameters": [ { "name": "company", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Company" } }, { "name": "role", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Role" } }, { "name": "job_type", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Job Type" } }, { "name": "round", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Round" } }, { "name": "material", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Material" } }, { "name": "category", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Category" } }, { "name": "source", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Source" } }, { "name": "text", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Text" } }, { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 20, "title": "Limit" } }, { "name": "offset", "in": "query", "required": false, "schema": { "type": "integer", "default": 0, "title": "Offset" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Browse Questions Api Me Knowledge Questions Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/me/memory/{attribute}/history": { "get": { "tags": [ "personal" ], "summary": "Every version of one memory attribute, with the sentence it came from", "operationId": "memory_history_endpoint_api_me_memory__attribute__history_get", "parameters": [ { "name": "attribute", "in": "path", "required": true, "schema": { "type": "string", "title": "Attribute" } }, { "name": "qualifier", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Qualifier" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Memory History Endpoint Api Me Memory Attribute History Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/me/memory/{attribute}": { "delete": { "tags": [ "personal" ], "summary": "Forget an attribute (or one value of it); you clicked it, so no extra approval", "operationId": "memory_forget_endpoint_api_me_memory__attribute__delete", "parameters": [ { "name": "attribute", "in": "path", "required": true, "schema": { "type": "string", "title": "Attribute" } }, { "name": "qualifier", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Qualifier" } }, { "name": "value", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Value" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Memory Forget Endpoint Api Me Memory Attribute Delete" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/me/notifications": { "get": { "tags": [ "personal" ], "summary": "Recent proactive decisions (push / brief / drop) with reasons", "operationId": "notifications_endpoint_api_me_notifications_get", "parameters": [ { "name": "limit", "in": "query", "required": false, "schema": { "type": "integer", "default": 50, "title": "Limit" } }, { "name": "channel", "in": "query", "required": false, "schema": { "anyOf": [ { "enum": [ "push", "brief", "drop" ], "type": "string" }, { "type": "null" } ], "title": "Channel" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "title": "Response Notifications Endpoint Api Me Notifications Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/me/notifications/{notification_id}/feedback": { "post": { "tags": [ "personal" ], "summary": "Tell Polaris whether a push was useful", "operationId": "feedback_endpoint_api_me_notifications__notification_id__feedback_post", "parameters": [ { "name": "notification_id", "in": "path", "required": true, "schema": { "type": "integer", "title": "Notification Id" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FeedbackIn" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Feedback Endpoint Api Me Notifications Notification Id Feedback Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/me/traces": { "get": { "tags": [ "personal" ], "summary": "Observability: latency, model and tool calls, tokens, tool error classes over recent answers", "operationId": "traces_endpoint_api_me_traces_get", "parameters": [ { "name": "days", "in": "query", "required": false, "schema": { "type": "integer", "default": 7, "title": "Days" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Traces Endpoint Api Me Traces Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/me/agenda": { "get": { "tags": [ "personal" ], "summary": "What Polaris is doing, needs from you, has scheduled and finished today", "operationId": "agenda_endpoint_api_me_agenda_get", "parameters": [ { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Agenda Endpoint Api Me Agenda Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/me/brief": { "get": { "tags": [ "personal" ], "summary": "Today's brief (markdown)", "operationId": "brief_endpoint_api_me_brief_get", "parameters": [ { "name": "day", "in": "query", "required": false, "schema": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Day" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Brief Endpoint Api Me Brief Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/me/tools/{name}": { "post": { "tags": [ "personal" ], "summary": "Run one read-only tool directly (the same tools the agent uses; traced the same way)", "operationId": "tool_endpoint_api_me_tools__name__post", "parameters": [ { "name": "name", "in": "path", "required": true, "schema": { "type": "string", "title": "Name" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ToolIn" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Tool Endpoint Api Me Tools Name Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/me/reports": { "get": { "tags": [ "personal" ], "summary": "Evaluation reports that can be shown", "operationId": "reports_endpoint_api_me_reports_get", "parameters": [ { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "array", "items": { "type": "object", "additionalProperties": true }, "title": "Response Reports Endpoint Api Me Reports Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/me/reports/{name}": { "get": { "tags": [ "personal" ], "summary": "One evaluation report (markdown)", "operationId": "report_endpoint_api_me_reports__name__get", "parameters": [ { "name": "name", "in": "path", "required": true, "schema": { "type": "string", "title": "Name" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Report Endpoint Api Me Reports Name Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/me/chat/{thread_id}/messages": { "get": { "tags": [ "personal" ], "summary": "Actual transcript and recoverable tasks; never the model context", "operationId": "messages_endpoint_api_me_chat__thread_id__messages_get", "parameters": [ { "name": "thread_id", "in": "path", "required": true, "schema": { "type": "string", "title": "Thread Id" } }, { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Messages Endpoint Api Me Chat Thread Id Messages Get" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/me/feedback": { "post": { "tags": [ "personal" ], "summary": "Mark one answer as good or bad (with a note); saved locally for review", "operationId": "answer_feedback_endpoint_api_me_feedback_post", "parameters": [ { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } }, { "name": "X-Polaris-Expected-Dataset", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "X-Polaris-Expected-Dataset" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AnswerFeedbackIn" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "type": "object", "additionalProperties": true, "title": "Response Answer Feedback Endpoint Api Me Feedback Post" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } }, "/api/ingest/raw-items": { "post": { "tags": [ "data" ], "summary": "Push raw items (local collectors, manual paste). Deduplicated by source + content hash", "operationId": "ingest_api_ingest_raw_items_post", "parameters": [ { "name": "authorization", "in": "header", "required": false, "schema": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Authorization" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IngestIn" } } } }, "responses": { "200": { "description": "Successful Response", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/IngestResult" } } } }, "422": { "description": "Validation Error", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HTTPValidationError" } } } } } } } }, "components": { "schemas": { "AnswerFeedbackIn": { "properties": { "thread_id": { "type": "string", "maxLength": 64, "title": "Thread Id" }, "question": { "type": "string", "maxLength": 4000, "title": "Question", "default": "" }, "answer": { "type": "string", "maxLength": 20000, "title": "Answer", "default": "" }, "verdict": { "type": "string", "enum": [ "good", "bad" ], "title": "Verdict" }, "note": { "type": "string", "maxLength": 2000, "title": "Note", "default": "" } }, "type": "object", "required": [ "thread_id", "verdict" ], "title": "AnswerFeedbackIn" }, "ChatIn": { "properties": { "message": { "type": "string", "maxLength": 4000, "minLength": 1, "title": "Message" }, "thread_id": { "type": "string", "maxLength": 64, "minLength": 1, "title": "Thread Id", "default": "main" } }, "type": "object", "required": [ "message" ], "title": "ChatIn" }, "FeedbackIn": { "properties": { "feedback": { "type": "string", "enum": [ "useful", "dismissed" ], "title": "Feedback" } }, "type": "object", "required": [ "feedback" ], "title": "FeedbackIn" }, "FollowupChanges": { "properties": { "saved": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Saved" }, "status": { "anyOf": [ { "type": "string", "enum": [ "untracked", "skipped", "applied", "interview", "offer", "rejected", "withdrawn" ] }, { "type": "null" } ], "title": "Status" }, "stage": { "anyOf": [ { "type": "string", "maxLength": 200 }, { "type": "null" } ], "title": "Stage" }, "note": { "anyOf": [ { "type": "string", "maxLength": 2000 }, { "type": "null" } ], "title": "Note" }, "next_followup": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Next Followup" } }, "type": "object", "title": "FollowupChanges" }, "FollowupIn": { "properties": { "request_id": { "type": "string", "format": "uuid", "title": "Request Id" }, "revision": { "anyOf": [ { "type": "integer", "minimum": 0.0 }, { "type": "null" } ], "title": "Revision" }, "changes": { "$ref": "#/components/schemas/FollowupChanges" } }, "type": "object", "required": [ "request_id", "changes" ], "title": "FollowupIn" }, "HTTPValidationError": { "properties": { "detail": { "items": { "$ref": "#/components/schemas/ValidationError" }, "type": "array", "title": "Detail" } }, "type": "object", "title": "HTTPValidationError" }, "Health": { "properties": { "status": { "type": "string", "title": "Status" }, "version": { "type": "string", "title": "Version" }, "database": { "type": "boolean", "title": "Database" }, "config": { "additionalProperties": true, "type": "object", "title": "Config" } }, "type": "object", "required": [ "status", "version", "database", "config" ], "title": "Health" }, "IngestIn": { "properties": { "items": { "items": { "$ref": "#/components/schemas/RawItemIn" }, "type": "array", "maxItems": 500, "minItems": 1, "title": "Items" } }, "type": "object", "required": [ "items" ], "title": "IngestIn" }, "IngestResult": { "properties": { "received": { "type": "integer", "title": "Received" }, "inserted": { "type": "integer", "title": "Inserted" }, "duplicates": { "type": "integer", "title": "Duplicates" }, "ids": { "items": { "type": "integer" }, "type": "array", "title": "Ids" }, "seen_again": { "type": "integer", "title": "Seen Again", "default": 0 } }, "type": "object", "required": [ "received", "inserted", "duplicates", "ids" ], "title": "IngestResult" }, "LLMCallDetail": { "properties": { "id": { "type": "integer", "title": "Id" }, "run_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Run Id" }, "purpose": { "type": "string", "title": "Purpose" }, "prompt_version": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Prompt Version" }, "provider": { "type": "string", "title": "Provider" }, "model": { "type": "string", "title": "Model" }, "endpoint": { "type": "string", "title": "Endpoint" }, "parsed_ok": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Parsed Ok" }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Error" }, "attempt": { "type": "integer", "title": "Attempt" }, "prompt_tokens": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Prompt Tokens" }, "completion_tokens": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Completion Tokens" }, "reasoning_tokens": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Reasoning Tokens" }, "latency_ms": { "type": "integer", "title": "Latency Ms" }, "cost_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Cost Usd" }, "cache_hit": { "type": "boolean", "title": "Cache Hit" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" }, "request": { "additionalProperties": true, "type": "object", "title": "Request" }, "response": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Response" }, "cached_tokens": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Cached Tokens" } }, "type": "object", "required": [ "id", "run_id", "purpose", "prompt_version", "provider", "model", "endpoint", "parsed_ok", "error", "attempt", "prompt_tokens", "completion_tokens", "reasoning_tokens", "latency_ms", "cost_usd", "cache_hit", "created_at", "request", "response", "cached_tokens" ], "title": "LLMCallDetail" }, "LLMCallSummary": { "properties": { "id": { "type": "integer", "title": "Id" }, "run_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Run Id" }, "purpose": { "type": "string", "title": "Purpose" }, "prompt_version": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Prompt Version" }, "provider": { "type": "string", "title": "Provider" }, "model": { "type": "string", "title": "Model" }, "endpoint": { "type": "string", "title": "Endpoint" }, "parsed_ok": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Parsed Ok" }, "error": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Error" }, "attempt": { "type": "integer", "title": "Attempt" }, "prompt_tokens": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Prompt Tokens" }, "completion_tokens": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Completion Tokens" }, "reasoning_tokens": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Reasoning Tokens" }, "latency_ms": { "type": "integer", "title": "Latency Ms" }, "cost_usd": { "anyOf": [ { "type": "number" }, { "type": "null" } ], "title": "Cost Usd" }, "cache_hit": { "type": "boolean", "title": "Cache Hit" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" } }, "type": "object", "required": [ "id", "run_id", "purpose", "prompt_version", "provider", "model", "endpoint", "parsed_ok", "error", "attempt", "prompt_tokens", "completion_tokens", "reasoning_tokens", "latency_ms", "cost_usd", "cache_hit", "created_at" ], "title": "LLMCallSummary" }, "RawItemIn": { "properties": { "source": { "type": "string", "maxLength": 64, "title": "Source", "description": "来源，如 greenhouse、tavily、manual、xhs" }, "tier": { "type": "string", "enum": [ "A", "B" ], "title": "Tier", "default": "A" }, "kind": { "type": "string", "enum": [ "job", "post" ], "title": "Kind", "default": "job" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Url" }, "external_id": { "anyOf": [ { "type": "string", "maxLength": 200 }, { "type": "null" } ], "title": "External Id" }, "query": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Query", "description": "采到它的查询词" }, "raw_text": { "type": "string", "minLength": 1, "title": "Raw Text" }, "raw_json": { "anyOf": [ { "additionalProperties": true, "type": "object" }, { "type": "null" } ], "title": "Raw Json" }, "fetched_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Fetched At" }, "published_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Published At", "description": "来源上写的发布或更新时间" }, "fetch_method": { "anyOf": [ { "type": "string", "maxLength": 16 }, { "type": "null" } ], "title": "Fetch Method", "description": "api / browser / mcp / cli / sitemap / archive / manual" }, "collector_version": { "anyOf": [ { "type": "string", "maxLength": 32 }, { "type": "null" } ], "title": "Collector Version" }, "is_synthetic": { "type": "boolean", "title": "Is Synthetic", "default": false } }, "type": "object", "required": [ "source", "raw_text" ], "title": "RawItemIn" }, "RawItemOut": { "properties": { "id": { "type": "integer", "title": "Id" }, "source": { "type": "string", "title": "Source" }, "tier": { "type": "string", "title": "Tier" }, "kind": { "type": "string", "title": "Kind" }, "url": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Url" }, "external_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "External Id" }, "query": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Query" }, "raw_text": { "type": "string", "title": "Raw Text" }, "content_hash": { "type": "string", "title": "Content Hash" }, "fetched_at": { "type": "string", "format": "date-time", "title": "Fetched At" }, "run_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Run Id" }, "is_synthetic": { "type": "boolean", "title": "Is Synthetic" } }, "type": "object", "required": [ "id", "source", "tier", "kind", "url", "external_id", "query", "raw_text", "content_hash", "fetched_at", "run_id", "is_synthetic" ], "title": "RawItemOut" }, "ResumeIn": { "properties": { "approve": { "type": "boolean", "title": "Approve" }, "reason": { "type": "string", "maxLength": 500, "title": "Reason", "default": "" } }, "type": "object", "required": [ "approve" ], "title": "ResumeIn" }, "ResumeTaskIn": { "properties": { "approve": { "type": "boolean", "title": "Approve" }, "reason": { "type": "string", "maxLength": 500, "title": "Reason", "default": "" }, "request_id": { "type": "string", "format": "uuid", "title": "Request Id" } }, "type": "object", "required": [ "approve", "request_id" ], "title": "ResumeTaskIn" }, "RunOut": { "properties": { "id": { "type": "integer", "title": "Id" }, "kind": { "type": "string", "title": "Kind" }, "params": { "additionalProperties": true, "type": "object", "title": "Params" }, "status": { "type": "string", "title": "Status" }, "stats": { "additionalProperties": true, "type": "object", "title": "Stats" }, "git_commit": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Git Commit" }, "started_at": { "type": "string", "format": "date-time", "title": "Started At" }, "finished_at": { "anyOf": [ { "type": "string", "format": "date-time" }, { "type": "null" } ], "title": "Finished At" } }, "type": "object", "required": [ "id", "kind", "params", "status", "stats", "git_commit", "started_at", "finished_at" ], "title": "RunOut" }, "TaskIn": { "properties": { "message": { "type": "string", "maxLength": 4000, "minLength": 1, "title": "Message" }, "thread_id": { "type": "string", "maxLength": 64, "minLength": 1, "title": "Thread Id", "default": "main" }, "request_id": { "type": "string", "format": "uuid", "title": "Request Id" } }, "type": "object", "required": [ "message", "request_id" ], "title": "TaskIn" }, "ToolCallOut": { "properties": { "id": { "type": "integer", "title": "Id" }, "run_id": { "anyOf": [ { "type": "integer" }, { "type": "null" } ], "title": "Run Id" }, "thread_id": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Thread Id" }, "agent": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Agent" }, "tool": { "type": "string", "title": "Tool" }, "args": { "additionalProperties": true, "type": "object", "title": "Args" }, "output": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Output" }, "ok": { "type": "boolean", "title": "Ok" }, "error_kind": { "anyOf": [ { "type": "string" }, { "type": "null" } ], "title": "Error Kind" }, "latency_ms": { "type": "integer", "title": "Latency Ms" }, "replayed": { "type": "boolean", "title": "Replayed" }, "created_at": { "type": "string", "format": "date-time", "title": "Created At" } }, "type": "object", "required": [ "id", "run_id", "thread_id", "agent", "tool", "args", "output", "ok", "error_kind", "latency_ms", "replayed", "created_at" ], "title": "ToolCallOut" }, "ToolIn": { "properties": { "args": { "additionalProperties": true, "type": "object", "title": "Args" } }, "type": "object", "title": "ToolIn" }, "ValidationError": { "properties": { "loc": { "items": { "anyOf": [ { "type": "string" }, { "type": "integer" } ] }, "type": "array", "title": "Location" }, "msg": { "type": "string", "title": "Message" }, "type": { "type": "string", "title": "Error Type" }, "input": { "title": "Input" }, "ctx": { "type": "object", "title": "Context" } }, "type": "object", "required": [ "loc", "msg", "type" ], "title": "ValidationError" }, "WatchCriteria": { "properties": { "city": { "anyOf": [ { "type": "string", "maxLength": 100 }, { "type": "null" } ], "title": "City" }, "job_type": { "anyOf": [ { "type": "string", "enum": [ "intern", "campus", "social" ] }, { "type": "null" } ], "title": "Job Type" }, "direction": { "anyOf": [ { "type": "string", "maxLength": 100 }, { "type": "null" } ], "title": "Direction" }, "max_days_per_week": { "anyOf": [ { "type": "integer", "maximum": 7.0, "minimum": 1.0 }, { "type": "null" } ], "title": "Max Days Per Week" }, "big_only": { "anyOf": [ { "type": "boolean" }, { "type": "null" } ], "title": "Big Only" }, "query": { "anyOf": [ { "type": "string", "maxLength": 100 }, { "type": "null" } ], "title": "Query" } }, "type": "object", "title": "WatchCriteria" }, "WatchIn": { "properties": { "title": { "type": "string", "maxLength": 200, "minLength": 1, "title": "Title" }, "criteria": { "$ref": "#/components/schemas/WatchCriteria" }, "job_ids": { "items": { "type": "string" }, "type": "array", "maxItems": 20, "title": "Job Ids" }, "until": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Until" }, "cadence_minutes": { "type": "integer", "maximum": 1440.0, "minimum": 10.0, "title": "Cadence Minutes", "default": 60 }, "report_hour": { "type": "integer", "maximum": 23.0, "minimum": 0.0, "title": "Report Hour", "default": 21 }, "notify": { "type": "string", "enum": [ "desktop", "brief" ], "title": "Notify", "default": "desktop" } }, "type": "object", "required": [ "title" ], "title": "WatchIn" }, "WatchPatch": { "properties": { "title": { "anyOf": [ { "type": "string", "maxLength": 200, "minLength": 1 }, { "type": "null" } ], "title": "Title" }, "criteria": { "anyOf": [ { "$ref": "#/components/schemas/WatchCriteria" }, { "type": "null" } ] }, "until": { "anyOf": [ { "type": "string", "format": "date" }, { "type": "null" } ], "title": "Until" }, "cadence_minutes": { "anyOf": [ { "type": "integer", "maximum": 1440.0, "minimum": 10.0 }, { "type": "null" } ], "title": "Cadence Minutes" }, "report_hour": { "anyOf": [ { "type": "integer", "maximum": 23.0, "minimum": 0.0 }, { "type": "null" } ], "title": "Report Hour" }, "notify": { "anyOf": [ { "type": "string", "enum": [ "desktop", "brief" ] }, { "type": "null" } ], "title": "Notify" }, "status": { "anyOf": [ { "type": "string", "enum": [ "active", "paused", "ended" ] }, { "type": "null" } ], "title": "Status" } }, "type": "object", "title": "WatchPatch" }, "WatchTargetIn": { "properties": { "job": { "type": "string", "title": "Job" }, "remove": { "type": "boolean", "title": "Remove", "default": false } }, "type": "object", "required": [ "job" ], "title": "WatchTargetIn" } } } }