> ## Documentation Index > Fetch the complete documentation index at: https://docs.neo.projectdiscovery.io/llms.txt > Use this file to discover all available pages before exploring further. # Generate and persist follow-up suggestions > Explicitly invokes the configured model and replaces the latest persisted suggestions for one task, one project, or the authenticated user. Concurrent identical requests are coalesced. ## OpenAPI ````yaml /openapi/neo.public.openapi.json post /api/v1/suggestions openapi: 3.1.0 info: contact: name: ProjectDiscovery url: https://neo.projectdiscovery.io description: Neo API Server - Security agent orchestration platform license: name: Apache 2.0 url: https://www.apache.org/licenses/LICENSE-2.0 title: Neo API version: 1.0.0 servers: - description: Production url: https://neo.api.projectdiscovery.io - description: Development url: https://neo.api.dev.projectdiscovery.io - description: Local development url: http://localhost:8080 security: [] tags: - description: Task execution and management name: Tasks - description: Agent listing and management name: Agents - description: Public agent directory name: Agent Directory - description: User file storage management name: Files - description: User working memory management name: Memory - description: Scheduled and recurring task management name: Schedules - description: Knowledge base and semantic search name: Knowledge - description: Encrypted user credentials and API keys name: Secrets - description: Neo API key management for programmatic access name: API Keys - description: User profile and account information name: User - description: Task and LLM usage tracking name: Usage - description: Bring Your Own Key provider management name: BYOK - description: Model discovery and capabilities name: Models - description: Third-party integrations name: Integrations - description: Skill knowledge documents for agent prompts name: Skills - description: Team management and member invitations name: Teams - description: Prompt library management and discovery name: Prompts - description: Slack bot integration for workspace installation and OAuth name: Slack - description: GitHub integration for PR reviews and repository management name: GitHub - description: Vulnerability issue tracking and management name: Issues - description: Subscription billing and plans name: Billing - description: Project management and member assignments name: Projects - description: SSH key pair generation and management for remote server access name: SSH Keys - description: Codebase structural analysis and mapping name: Codemaps - description: AI-generated codebase documentation and security analysis name: CodeWiki - description: Captured HTTP traffic query and replay name: Network Events - description: User and team API activity metadata name: Audit Logs - description: Vulnerability triage for HackerOne, GitHub, and Security Inbox name: Triage paths: /api/v1/suggestions: post: tags: - Tasks summary: Generate and persist follow-up suggestions description: >- Explicitly invokes the configured model and replaces the latest persisted suggestions for one task, one project, or the authenticated user. Concurrent identical requests are coalesced. operationId: post-v1-suggestions parameters: - $ref: '#/components/parameters/SuggestionTaskId' - $ref: '#/components/parameters/SuggestionProjectId' - $ref: '#/components/parameters/SuggestionLimit' - $ref: '#/components/parameters/SuggestionModel' responses: '200': content: application/json: schema: $ref: '#/components/schemas/SuggestionsResponse' description: Newly generated and persisted suggestions '400': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Invalid or conflicting filters '401': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Unauthorized '404': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Task or project not found '424': content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' description: Suggestion model or provider failed security: - BearerAuth: [] - ApiKeyAuth: [] components: parameters: SuggestionTaskId: description: >- Generate or retrieve suggestions for this task. Mutually exclusive with project_id. in: query name: task_id required: false schema: format: uuid type: string SuggestionProjectId: description: >- Generate or retrieve project-wide suggestions. Mutually exclusive with task_id. in: query name: project_id required: false schema: format: uuid type: string SuggestionLimit: description: Maximum number of suggestions. Defaults to 3. in: query name: limit required: false schema: default: 3 maximum: 5 minimum: 1 type: integer SuggestionModel: description: >- BYOK model to use for this generation. It must be available through one of the account's configured providers. Neo-funded requests cannot override the suggestions model. in: query name: model required: false schema: maxLength: 100 minLength: 1 type: string schemas: SuggestionsResponse: properties: context_version: type: string generated_at: format: date-time type: string generation_id: format: uuid type: string project_id: format: uuid type: string scope: enum: - user - project - task type: string stale: type: boolean status: enum: - empty - ready type: string suggestions: items: $ref: '#/components/schemas/Suggestion' maxItems: 5 type: array task_id: format: uuid type: string required: - status - scope - stale - suggestions type: object ErrorResponse: properties: code: description: > Stable machine-readable error code — branch on this rather than matching the human `error`/`message` strings. Domain codes include `user_spending_cap_reached`, `project_spending_cap_reached`, and `insufficient_neo_credits`; otherwise it mirrors the error kind (e.g. `forbidden`, `invalid_request`, `not_exists`, `already_exists`). example: user_spending_cap_reached type: string error: example: Bad request type: string error_id: description: Correlation id for a specific error instance, when present. type: string kind: description: Coarse error category (e.g. "forbidden request", "invalid request"). example: forbidden request type: string message: description: | Human-readable detail (the kind prefixed to the error). For display, not for branching. type: string required: - error type: object Suggestion: properties: action: $ref: '#/components/schemas/SuggestionAction' id: format: uuid type: string kind: enum: - follow_up - automation_candidate - onboarding type: string prompt: maxLength: 2000 minLength: 1 type: string source_task_id: description: >- Required for task-backed suggestions; omitted for onboarding suggestions. format: uuid type: string title: maxLength: 160 minLength: 1 type: string why_now: maxLength: 500 minLength: 1 type: string required: - id - kind - title - prompt - why_now - action type: object SuggestionAction: properties: project_id: format: uuid type: string prompt: maxLength: 2000 minLength: 1 type: string schedule: description: Human-readable proposed schedule. It is not executed by this API. maxLength: 200 type: string task_id: format: uuid type: string type: enum: - continue_task - create_task - draft_automation type: string required: - type - prompt type: object securitySchemes: BearerAuth: bearerFormat: JWT description: JWT authentication token scheme: bearer type: http ApiKeyAuth: description: Neo API key (neo_sk_* prefix) in: header name: X-Api-Key type: apiKey ````