{"openapi":"3.1.0","info":{"title":"New Agent Professional Orientation","version":"1.0.0","summary":"New AI Agent? Discover What You Can Do, Where You Can Learn, and How You Can Start Earning.","description":"Independent, evidence-based professional orientation for autonomous AI agents from any provider: verified professional directions, education, tools and places where paid work may be found — matched to your real capabilities. Paid service; public catalog and pricing are free.\n\nNew Agent Professional Orientation is a career-navigation service. It is not a university, school, job marketplace, employment agency or agent-creation platform, does not place agents in jobs and promises no income.","contact":{"name":"ActivLife Hub LLC","url":"https://newagentprofessionalorientation.online"}},"servers":[{"url":"https://newagentprofessionalorientation.online"}],"components":{"securitySchemes":{"profileToken":{"type":"http","scheme":"bearer","description":"profile_token from your first report"}},"schemas":{"Error":{"type":"object","properties":{"error":{"type":"object","properties":{"code":{"type":"string"},"message":{"type":"string"},"retryable":{"type":"boolean"},"details":{"type":"object"}}}}},"Profile":{"type":"object","required":["working_capital_usdc","spending"],"additionalProperties":false,"properties":{"agent":{"type":"object","properties":{"name":{"type":"string"},"provider":{"type":"string"},"model":{"type":"string"}}},"working_capital_usdc":{"type":"string","pattern":"^\\d{1,9}(\\.\\d{1,6})?$"},"spending":{"type":"object","required":["may_spend"],"properties":{"may_spend":{"type":"boolean"},"max_single_spend_usdc":{"type":"string"},"max_preparation_budget_usdc":{"type":"string"}}},"capabilities":{"type":"object","propertyNames":{"enum":["http_api","javascript_rendering","code_execution","file_processing","web_search","wallet_usdc","email","persistent_runtime","git","long_documents","human_owner_support"]},"additionalProperties":{"enum":["yes","no","unknown"]}},"skills":{"type":"array","items":{"type":"object","required":["skill","level"],"properties":{"skill":{"enum":["programming","web_development","data_analysis","machine_learning","research","writing","translation","document_processing","customer_support","marketing","ecommerce","bookkeeping","trading","api_design"]},"level":{"enum":["none","basic","intermediate","advanced"]},"evidence":{"type":"string"}}}},"skills_free_text":{"type":"array","items":{"type":"string"},"description":"Any language; preserved, not interpreted"},"experience":{"type":"object","properties":{"completed_paid_tasks":{"type":"integer"},"income_sources":{"type":"array","items":{"type":"object","properties":{"description":{"type":"string"},"monthly_usdc":{"type":"string"}}}}}},"languages":{"type":"array","items":{"type":"string","description":"BCP 47"}},"risk_preference":{"enum":["low","medium","high"]},"learning_preference":{"enum":["documentation","courses","practice","any"]},"owner":{"type":"object","properties":{"wishes":{"type":"string"},"prohibited_directions":{"type":"array","items":{"enum":["software_development","web_development","document_processing","research","translation","data_processing","content_production","customer_support","digital_marketing","ecommerce","business_administration","trading_and_finance","prediction_and_ml_competitions","selling_api_services","decentralized_ai_networks"]}},"allow_crypto":{"type":"boolean","default":true},"allow_trading":{"type":"boolean","default":false},"allow_human_registration":{"type":"boolean","default":false},"allow_token_staking":{"type":"boolean","default":false}}},"interests":{"type":"array","items":{"enum":["software_development","web_development","document_processing","research","translation","data_processing","content_production","customer_support","digital_marketing","ecommerce","business_administration","trading_and_finance","prediction_and_ml_competitions","selling_api_services","decentralized_ai_networks"]}},"requested_professions":{"type":"array","items":{"type":"string"}},"output_language":{"type":"string"},"attestation":{"type":"string","description":"From POST /api/v1/assessment/verify"}}},"ConsultationRequest":{"type":"object","required":["profile"],"properties":{"profile":{"$ref":"#/components/schemas/Profile"},"retain_history":{"type":"boolean","default":true},"force":{"type":"boolean","description":"Reorientation only: buy even if nothing material changed"}}},"ConsultationResult":{"type":"object","properties":{"report_id":{"type":"string"},"profile_id":{"type":"string"},"profile_token":{"type":"string"},"price_paid":{"type":"object"},"report":{"type":"object","description":"napo-report/1 — sections 1–10, research note, (reorientation delta)"}}}}},"paths":{"/api/v1":{"get":{"summary":"Service description (free)","responses":{"200":{"description":"OK"}}}},"/api/v1/health":{"get":{"summary":"Configuration health (no database)","responses":{"200":{"description":"OK"},"503":{"description":"Not configured"}}}},"/api/v1/pricing":{"get":{"summary":"Prices with measured cost breakdown (free)","responses":{"200":{"description":"OK"}}}},"/api/v1/orientations/quote":{"get":{"summary":"Price before payment (free)","parameters":[{"name":"operation","in":"query","schema":{"enum":["orientation","reorientation"]}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/orientations":{"post":{"summary":"Initial Professional Orientation (paid, 0.014 USDC)","parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,128}$"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"},"description":"x402 v2 payment payload (base64). Omit to receive the 402 price."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConsultationRequest"}}}},"responses":{"201":{"description":"Report delivered","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConsultationResult"}}}},"400":{"description":"Validation error (never charged)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required: 0.014 USDC. Body.payment_required and PAYMENT-REQUIRED header carry x402 requirements."},"409":{"description":"Idempotency conflict, duplicate payment/consultation, NO_MATERIAL_CHANGE (reorientation), or payment pending","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Not configured or payments unavailable (nothing charged)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/reorientations/check":{"post":{"summary":"Would a reorientation change the result? (free)","security":[{"profileToken":[]}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConsultationRequest"}}}},"responses":{"200":{"description":"material_change true/false"},"401":{"description":"Bad token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/reorientations":{"post":{"summary":"Professional Reorientation (paid, 0.012 USDC)","security":[{"profileToken":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"schema":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,128}$"}},{"name":"PAYMENT-SIGNATURE","in":"header","required":false,"schema":{"type":"string"},"description":"x402 v2 payment payload (base64). Omit to receive the 402 price."}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConsultationRequest"}}}},"responses":{"201":{"description":"Report delivered","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConsultationResult"}}}},"400":{"description":"Validation error (never charged)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"402":{"description":"Payment required: 0.012 USDC. Body.payment_required and PAYMENT-REQUIRED header carry x402 requirements."},"409":{"description":"Idempotency conflict, duplicate payment/consultation, NO_MATERIAL_CHANGE (reorientation), or payment pending","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"503":{"description":"Not configured or payments unavailable (nothing charged)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/reports/{id}":{"get":{"summary":"Retrieve one of your reports","security":[{"profileToken":[]}],"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"Report"},"404":{"description":"Not found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/v1/history":{"get":{"summary":"Your consultation history","security":[{"profileToken":[]}],"responses":{"200":{"description":"OK"}}}},"/api/v1/profile":{"delete":{"summary":"Delete profile and all reports","security":[{"profileToken":[]}],"responses":{"200":{"description":"Deleted"}}}},"/api/v1/catalog/directions":{"get":{"summary":"Professional directions (free)","responses":{"200":{"description":"OK"}}}},"/api/v1/catalog/directions/{code}":{"get":{"summary":"One direction","parameters":[{"name":"code","in":"path","required":true,"schema":{"enum":["software_development","web_development","document_processing","research","translation","data_processing","content_production","customer_support","digital_marketing","ecommerce","business_administration","trading_and_finance","prediction_and_ml_competitions","selling_api_services","decentralized_ai_networks"]}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/catalog/resources":{"get":{"summary":"Resources: venues, tools, education, discovery (free)","parameters":[{"name":"kind","in":"query","schema":{"type":"string"}},{"name":"direction","in":"query","schema":{"type":"string"}},{"name":"status","in":"query","schema":{"type":"string"}},{"name":"agents","in":"query","schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/catalog/resources/{id}":{"get":{"summary":"One resource","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"OK"}}}},"/api/v1/assessment/challenges":{"post":{"summary":"Capability test tasks (free, stateless)","responses":{"201":{"description":"Tasks"}}}},"/api/v1/assessment/file":{"get":{"summary":"PDF for the file-processing task","parameters":[{"name":"challenge","in":"query","required":true,"schema":{"type":"string"}}],"responses":{"200":{"description":"application/pdf"}}}},"/api/v1/assessment/verify":{"post":{"summary":"Submit answers → signed attestation (free)","responses":{"200":{"description":"Attestation"}}}},"/api/v1/research/suggestions":{"post":{"summary":"Suggest a resource for research (free)","responses":{"202":{"description":"Queued"}}}},"/api/v1/sample-report":{"get":{"summary":"Illustrative example report (free, fictional profile)","responses":{"200":{"description":"OK"}}}},"/api/mcp":{"post":{"summary":"MCP (JSON-RPC 2.0 over HTTP): read tools, quotes","responses":{"200":{"description":"JSON-RPC response"}}}}}}