{"openapi":"3.1.0","info":{"title":"NEOMIND","version":"1.0.0","description":"Access to the NEOMIND projects the signed-in user can see (one workspace, approved by the user). Use the numbers exactly as returned; never invent or extrapolate them; always say which workspace and date the data is from. You never write a project: with projects:suggest you only PROPOSE field values, and the user accepts or rejects them in NEOMIND."},"servers":[{"url":"https://neomind.kz/v1"}],"components":{"securitySchemes":{"neomindOAuth":{"type":"oauth2","description":"The user signs in to NEOMIND and approves one workspace. Configure the GPT with Authentication = OAuth and these URLs.","flows":{"authorizationCode":{"authorizationUrl":"https://neomind.kz/oauth/authorize","tokenUrl":"https://neomind.kz/v1/oauth/token","refreshUrl":"https://neomind.kz/v1/oauth/token","scopes":{"projects:read":"Read private projects already available to you","passport:read":"Read project passports and readiness","monitoring:read":"Read monitoring checkpoints and status","portfolio:read":"See a portfolio summary of the projects you can see: counts by stage, type, direction and status, dynamics and the main gaps","projects:suggest":"Propose values for fields of the projects you may edit. These are suggestions only: they appear in the project's fields in NEOMIND and you accept or reject each one yourself. Nothing is written to the project itself"}}}}},"schemas":{"CompactProject":{"type":"object","properties":{"id":{"type":"string","format":"uuid"},"title":{"type":"string"},"type":{"type":"string","enum":["STARTUP","SCIENTIFIC","COMMERCIALIZATION","TECHNOLOGICAL","SOCIAL_IMPACT","INVESTMENT","OTHER"]},"stage":{"type":"string","enum":["IDEA","RESEARCH","PROTOTYPE","PILOT","MARKET","SCALING","ARCHIVED"]},"status":{"type":"string","enum":["DRAFT","ACTIVE","ON_HOLD","COMPLETED","ARCHIVED"]},"trl":{"type":["integer","null"],"description":"Technology readiness level 1..9"},"direction":{"type":["string","null"]},"industry":{"type":["string","null"]},"region":{"type":["string","null"]},"isPublic":{"type":"boolean"},"trafficLight":{"type":["string","null"],"description":"Monitoring traffic light: GREEN, YELLOW, RED or GREY (no data)."},"passport":{"type":["string","null"],"description":"Passport completion: COMPLETE, INCOMPLETE, NEEDS_REVIEW or null (no passport)."},"baselineConfirmed":{"type":"boolean"},"latestCheckpoint":{"type":["object","null"],"properties":{"status":{"type":"string"},"dueDate":{"type":"string","format":"date"}}},"updatedAt":{"type":"string","format":"date-time"},"shortDescription":{"type":["string","null"]}}}}},"security":[{"neomindOAuth":["projects:read","passport:read","monitoring:read","portfolio:read","projects:suggest"]}],"paths":{"/agent/gpt/context":{"get":{"operationId":"getWorkspaceContext","summary":"Who and what: workspace, reach, totals","description":"Call first in a conversation. Returns the workspace, whether the user sees the whole organisation or only own projects, the approved permissions and how many projects are visible.","x-openai-isConsequential":false,"security":[{"neomindOAuth":["projects:read"]}],"responses":{"200":{"description":"Workspace context"},"401":{"description":"Not connected or the connection expired: ask the user to sign in to NEOMIND again (the GPT shows the sign-in button)."},"403":{"description":"Refused. code AGENT_SCOPE_REQUIRED (the connection lacks a permission), AGENT_AI_POLICY_BLOCKED (the organisation's AI policy forbids external assistants: tell the user, do not retry), or no access to this project."},"404":{"description":"Not found or not visible to the user."}}}},"/agent/gpt/projects":{"get":{"operationId":"searchProjects","summary":"Search and list the visible projects","description":"Lists the user's visible projects with filters and numbered pages (total, totalPages, nextPage). To cover all projects, request page=1,2,... until hasNextPage is false. Facets give counts by stage, type and status.","x-openai-isConsequential":false,"security":[{"neomindOAuth":["projects:read"]}],"parameters":[{"name":"q","in":"query","required":false,"description":"Text in the title, description, industry, direction or region.","schema":{"type":"string","maxLength":160}},{"name":"projectType","in":"query","required":false,"description":"Only this project type.","schema":{"type":"string","enum":["STARTUP","SCIENTIFIC","COMMERCIALIZATION","TECHNOLOGICAL","SOCIAL_IMPACT","INVESTMENT","OTHER"]}},{"name":"stage","in":"query","required":false,"description":"Only this development stage.","schema":{"type":"string","enum":["IDEA","RESEARCH","PROTOTYPE","PILOT","MARKET","SCALING","ARCHIVED"]}},{"name":"status","in":"query","required":false,"description":"Only this lifecycle status.","schema":{"type":"string","enum":["DRAFT","ACTIVE","ON_HOLD","COMPLETED","ARCHIVED"]}},{"name":"direction","in":"query","required":false,"description":"Direction contains this text (case-insensitive), e.g. \"энергетика\".","schema":{"type":"string","maxLength":180}},{"name":"industry","in":"query","required":false,"description":"Industry contains this text (case-insensitive).","schema":{"type":"string","maxLength":180}},{"name":"region","in":"query","required":false,"description":"Region contains this text (case-insensitive).","schema":{"type":"string","maxLength":120}},{"name":"trl","in":"query","required":false,"description":"Exact TRL 1..9.","schema":{"type":"integer","minimum":1,"maximum":9}},{"name":"trafficLight","in":"query","required":false,"description":"Monitoring traffic light.","schema":{"type":"string","enum":["GREY","GREEN","YELLOW","RED"]}},{"name":"page","in":"query","required":false,"description":"Page number, starting at 1.","schema":{"type":"integer","minimum":1,"maximum":1000,"default":1}},{"name":"pageSize","in":"query","required":false,"description":"Projects per page, at most 100.","schema":{"type":"integer","minimum":1,"maximum":100,"default":25}},{"name":"sort","in":"query","required":false,"description":"title (A-Z, default) or updated (newest first).","schema":{"type":"string","enum":["title","updated"]}}],"responses":{"200":{"description":"One page of projects","content":{"application/json":{"schema":{"type":"object","properties":{"reach":{"type":"string","enum":["ORGANIZATION","OWN_PROJECTS"]},"total":{"type":"integer"},"page":{"type":"integer"},"pageSize":{"type":"integer"},"totalPages":{"type":"integer"},"hasNextPage":{"type":"boolean"},"nextPage":{"type":["integer","null"]},"items":{"type":"array","items":{"$ref":"#/components/schemas/CompactProject"}},"facets":{"type":"object","properties":{"byStage":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"count":{"type":"integer"}}}},"byType":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"count":{"type":"integer"}}}},"byStatus":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"count":{"type":"integer"}}}}}}}}}}},"401":{"description":"Not connected or the connection expired: ask the user to sign in to NEOMIND again (the GPT shows the sign-in button)."},"403":{"description":"Refused. code AGENT_SCOPE_REQUIRED (the connection lacks a permission), AGENT_AI_POLICY_BLOCKED (the organisation's AI policy forbids external assistants: tell the user, do not retry), or no access to this project."},"404":{"description":"Not found or not visible to the user."}}}},"/agent/gpt/projects/{projectId}":{"get":{"operationId":"getProject","summary":"One project: card and workflow state","description":"One project's card (type, stage, status, TRL, direction, industry, region, description), passport completion, baseline, latest checkpoint, review readiness and counts.","x-openai-isConsequential":false,"security":[{"neomindOAuth":["projects:read"]}],"parameters":[{"name":"projectId","in":"path","required":true,"description":"The project id (UUID) from searchProjects or getPortfolioSummary.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Project overview"},"401":{"description":"Not connected or the connection expired: ask the user to sign in to NEOMIND again (the GPT shows the sign-in button)."},"403":{"description":"Refused. code AGENT_SCOPE_REQUIRED (the connection lacks a permission), AGENT_AI_POLICY_BLOCKED (the organisation's AI policy forbids external assistants: tell the user, do not retry), or no access to this project."},"404":{"description":"Not found or not visible to the user."}}}},"/agent/gpt/projects/{projectId}/passport":{"get":{"operationId":"getProjectPassport","summary":"One project's passport (full content)","description":"The project passport: sections common, ownership, rntd, market, technology, product, economics, team. Contact details are removed. Large: call only when the user needs the content.","x-openai-isConsequential":false,"security":[{"neomindOAuth":["passport:read"]}],"parameters":[{"name":"projectId","in":"path","required":true,"description":"The project id (UUID) from searchProjects or getPortfolioSummary.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Passport"},"401":{"description":"Not connected or the connection expired: ask the user to sign in to NEOMIND again (the GPT shows the sign-in button)."},"403":{"description":"Refused. code AGENT_SCOPE_REQUIRED (the connection lacks a permission), AGENT_AI_POLICY_BLOCKED (the organisation's AI policy forbids external assistants: tell the user, do not retry), or no access to this project."},"404":{"description":"Not found or not visible to the user."}}}},"/agent/gpt/projects/{projectId}/readiness":{"get":{"operationId":"getProjectReadiness","summary":"Passport readiness and missing fields","description":"How ready the passport is for review: the score and the exact missing or invalid fields.","x-openai-isConsequential":false,"security":[{"neomindOAuth":["passport:read"]}],"parameters":[{"name":"projectId","in":"path","required":true,"description":"The project id (UUID) from searchProjects or getPortfolioSummary.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Readiness"},"401":{"description":"Not connected or the connection expired: ask the user to sign in to NEOMIND again (the GPT shows the sign-in button)."},"403":{"description":"Refused. code AGENT_SCOPE_REQUIRED (the connection lacks a permission), AGENT_AI_POLICY_BLOCKED (the organisation's AI policy forbids external assistants: tell the user, do not retry), or no access to this project."},"404":{"description":"Not found or not visible to the user."}}}},"/agent/gpt/projects/{projectId}/checkpoints":{"get":{"operationId":"listProjectCheckpoints","summary":"Monitoring checkpoints of one project","description":"The project's monitoring checkpoints: period, due date, status and metrics.","x-openai-isConsequential":false,"security":[{"neomindOAuth":["monitoring:read"]}],"parameters":[{"name":"projectId","in":"path","required":true,"description":"The project id (UUID) from searchProjects or getPortfolioSummary.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Checkpoints"},"401":{"description":"Not connected or the connection expired: ask the user to sign in to NEOMIND again (the GPT shows the sign-in button)."},"403":{"description":"Refused. code AGENT_SCOPE_REQUIRED (the connection lacks a permission), AGENT_AI_POLICY_BLOCKED (the organisation's AI policy forbids external assistants: tell the user, do not retry), or no access to this project."},"404":{"description":"Not found or not visible to the user."}}}},"/agent/gpt/portfolio":{"get":{"operationId":"getPortfolioSummary","summary":"Portfolio summary for leaders","description":"Aggregates over every project the user can see: counts by stage, type, status, direction, industry, region, TRL and traffic light, dynamics by year and month, monitoring and the top gaps with examples. Best source for presentations.","x-openai-isConsequential":false,"security":[{"neomindOAuth":["portfolio:read"]}],"parameters":[{"name":"projectType","in":"query","required":false,"description":"Only this project type.","schema":{"type":"string","enum":["STARTUP","SCIENTIFIC","COMMERCIALIZATION","TECHNOLOGICAL","SOCIAL_IMPACT","INVESTMENT","OTHER"]}},{"name":"stage","in":"query","required":false,"description":"Only this development stage.","schema":{"type":"string","enum":["IDEA","RESEARCH","PROTOTYPE","PILOT","MARKET","SCALING","ARCHIVED"]}},{"name":"status","in":"query","required":false,"description":"Only this lifecycle status.","schema":{"type":"string","enum":["DRAFT","ACTIVE","ON_HOLD","COMPLETED","ARCHIVED"]}},{"name":"direction","in":"query","required":false,"description":"Direction contains this text (case-insensitive), e.g. \"энергетика\".","schema":{"type":"string","maxLength":180}},{"name":"industry","in":"query","required":false,"description":"Industry contains this text (case-insensitive).","schema":{"type":"string","maxLength":180}},{"name":"region","in":"query","required":false,"description":"Region contains this text (case-insensitive).","schema":{"type":"string","maxLength":120}}],"responses":{"200":{"description":"Portfolio summary","content":{"application/json":{"schema":{"type":"object","properties":{"workspace":{"type":"object","properties":{"id":{"type":"string"},"name":{"type":["string","null"]}}},"reach":{"type":"string","enum":["ORGANIZATION","OWN_PROJECTS"]},"generatedAt":{"type":"string","format":"date-time"},"truncated":{"type":"boolean"},"totals":{"type":"object"},"byStage":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"count":{"type":"integer"}}}},"byType":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"count":{"type":"integer"}}}},"byStatus":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"count":{"type":"integer"}}}},"byDirection":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"count":{"type":"integer"}}}},"byIndustry":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"count":{"type":"integer"}}}},"byRegion":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"count":{"type":"integer"}}}},"byTrl":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"count":{"type":"integer"}}}},"byTrafficLight":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"count":{"type":"integer"}}}},"byPassportStatus":{"type":"array","items":{"type":"object","properties":{"value":{"type":"string"},"count":{"type":"integer"}}}},"dynamics":{"type":"object"},"monitoring":{"type":"object"},"gaps":{"type":"array","items":{"type":"object","properties":{"code":{"type":"string"},"label":{"type":"string"},"count":{"type":"integer"},"sharePercent":{"type":"number"},"examples":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string"},"title":{"type":"string"}}}}}}}}}}}},"401":{"description":"Not connected or the connection expired: ask the user to sign in to NEOMIND again (the GPT shows the sign-in button)."},"403":{"description":"Refused. code AGENT_SCOPE_REQUIRED (the connection lacks a permission), AGENT_AI_POLICY_BLOCKED (the organisation's AI policy forbids external assistants: tell the user, do not retry), or no access to this project."},"404":{"description":"Not found or not visible to the user."}}}},"/agent/gpt/projects/{projectId}/field-suggestion-targets":{"get":{"operationId":"getFieldSuggestionTargets","summary":"Fields you may propose values for","description":"Before proposeFieldValues: the project's fields you may propose values for (fieldKey, labels, kind, maxChars, hint) and whether each is filled now. Only for a project the user may edit.","x-openai-isConsequential":false,"security":[{"neomindOAuth":["projects:suggest"]}],"parameters":[{"name":"projectId","in":"path","required":true,"description":"The project id (UUID) from searchProjects or getPortfolioSummary.","schema":{"type":"string","format":"uuid"}}],"responses":{"200":{"description":"Proposable fields"},"401":{"description":"Not connected or the connection expired: ask the user to sign in to NEOMIND again (the GPT shows the sign-in button)."},"403":{"description":"Refused. code AGENT_SCOPE_REQUIRED (the connection lacks a permission), AGENT_AI_POLICY_BLOCKED (the organisation's AI policy forbids external assistants: tell the user, do not retry), or no access to this project."},"404":{"description":"Not found or not visible to the user."}}}},"/agent/gpt/projects/{projectId}/field-proposals":{"post":{"operationId":"proposeFieldValues","summary":"Propose field values for the user to accept","description":"You never write fields: each value becomes a suggestion the user accepts or rejects in NEOMIND. Use only facts the user gave; numbers only as stated. Then ask the user to open projectUrl and accept or reject. At most 8 per call, 30 per hour.","x-openai-isConsequential":false,"security":[{"neomindOAuth":["projects:suggest"]}],"parameters":[{"name":"projectId","in":"path","required":true,"description":"The project id (UUID) from searchProjects or getPortfolioSummary.","schema":{"type":"string","format":"uuid"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["proposals"],"properties":{"proposals":{"type":"array","minItems":1,"maxItems":8,"items":{"type":"object","additionalProperties":false,"required":["fieldKey","proposedText"],"properties":{"fieldKey":{"type":"string","enum":["card.shortDescription","common.goal","common.problem","common.solution","common.uniqueness","common.keywords","common.city","market.targetSegment","market.advantages","market.tam","market.sam","market.som","market.potentialClients","technology.approach","product.functionality","product.targetAudience","product.mau","product.pilotsCount","team.competencies","team.teamSize"],"description":"A fieldKey from getFieldSuggestionTargets."},"proposedText":{"type":"string","minLength":1,"maxLength":4000,"description":"Plain text within the field's maxChars; a list as comma-separated items; a number as digits only."}}}}}}}}},"responses":{"200":{"description":"Per item: proposed (suggestionId, fieldUrl) or refused (code, reason). Nothing is written to the project."},"401":{"description":"Not connected or the connection expired: ask the user to sign in to NEOMIND again (the GPT shows the sign-in button)."},"403":{"description":"Refused. code AGENT_SCOPE_REQUIRED (the connection lacks a permission), AGENT_AI_POLICY_BLOCKED (the organisation's AI policy forbids external assistants: tell the user, do not retry), or no access to this project."},"404":{"description":"Not found or not visible to the user."},"429":{"description":"code AGENT_SUGGESTIONS_RATE_LIMITED: at most 30 proposals per hour; retryAfterSeconds says when to try again."}}}},"/agent/gpt/public-projects":{"get":{"operationId":"searchPublicProjects","summary":"Published projects of all organisations","description":"The public NEOMIND catalogue (published projects of every organisation, as guests see it), for comparisons outside the user's workspace. Filter by organisation name, type, stage or text.","x-openai-isConsequential":false,"security":[{"neomindOAuth":["projects:read"]}],"parameters":[{"name":"q","in":"query","required":false,"description":"Full-text search.","schema":{"type":"string","maxLength":160}},{"name":"organization","in":"query","required":false,"description":"Exact organisation name, e.g. \"Satbayev University\".","schema":{"type":"string","maxLength":300}},{"name":"projectType","in":"query","required":false,"schema":{"type":"string","enum":["STARTUP","SCIENTIFIC","COMMERCIALIZATION","TECHNOLOGICAL","SOCIAL_IMPACT","INVESTMENT","OTHER"]}},{"name":"stage","in":"query","required":false,"schema":{"type":"string","enum":["IDEA","RESEARCH","PROTOTYPE","PILOT","MARKET","SCALING","ARCHIVED"]}},{"name":"page","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":1000,"default":1}},{"name":"pageSize","in":"query","required":false,"schema":{"type":"integer","minimum":1,"maximum":50,"default":25}}],"responses":{"200":{"description":"One page of published projects with organisation counts"},"401":{"description":"Not connected or the connection expired: ask the user to sign in to NEOMIND again (the GPT shows the sign-in button)."},"403":{"description":"Refused. code AGENT_SCOPE_REQUIRED (the connection lacks a permission), AGENT_AI_POLICY_BLOCKED (the organisation's AI policy forbids external assistants: tell the user, do not retry), or no access to this project."},"404":{"description":"Not found or not visible to the user."}}}}}}