> ## Documentation Index
> Fetch the complete documentation index at: https://docs.meetsquad.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Prioritise solutions

> Reorders one or more solutions based on provided order



## OpenAPI

````yaml /openapi/squad-api.json post /organisations/{orgId}/workspaces/{workspaceId}/solutions/prioritise
openapi: 3.1.0
info:
  title: Squad API
  version: 4.8.0
  description: API for managing Squad resources
  contact:
    name: Squad Support
    url: https://www.meetsquad.ai/support
    email: help@meetsquad.ai
servers:
  - url: https://api.meetsquad.ai
    description: Production server
  - url: https://uat.api.meetsquad.ai
    description: Staging server
  - url: https://dev.api.meetsquad.ai
    description: Development server
security: []
tags:
  - name: Organisations
  - name: Workspaces
  - name: Goals
  - name: Opportunities
  - name: Solutions
  - name: Feedback
  - name: Submit Feedback
  - name: Insights
  - name: Knowledge
  - name: Metrics
  - name: Topics
  - name: Integrations
  - name: AI & Search
  - name: Onboarding
paths:
  /organisations/{orgId}/workspaces/{workspaceId}/solutions/prioritise:
    post:
      tags:
        - Solutions
      summary: Prioritise solutions
      description: Reorders one or more solutions based on provided order
      operationId: prioritiseSolutions
      parameters:
        - in: path
          name: orgId
          schema:
            type: string
          required: true
          description: Organization ID
          example: a5f3c6e1-9d20-4f7b-8e31-d09a2b63c184
        - in: path
          name: workspaceId
          schema:
            type: string
          required: true
          description: Workspace ID
          example: c0e195d9-b918-4a3a-bd8b-f730361d044f
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PrioritiseSolutionsRequest'
      responses:
        '202':
          description: Solution prioritization request accepted and queued for processing
        '400':
          description: Bad Request
        '401':
          description: Unauthorized
        '409':
          description: Conflict
      security:
        - bearerAuth: []
components:
  schemas:
    PrioritiseSolutionsRequest:
      description: Request schema for prioritising solutions
      example:
        beforeId: e3f2c1b4-7a8d-5e4f-b8c7-7a8c9d1e2f3a
        solutionIds:
          - d4e71c2b-a498-42af-b7f5-69de06a0d7c4
          - b5f2a0f4-6a7d-4a1f-9e6b-6bcb9c22d7c4
          - c0e195d9-b918-4a3a-bd8b-f730361d044e
      type: object
      properties:
        beforeId:
          description: >-
            ID of solution before which to place the solutions, or null to place
            at the end
          type:
            - string
            - 'null'
        solutionIds:
          description: List of solution IDs to move
          minItems: 1
          type: array
          items:
            type: string
        triggeredBy:
          description: >-
            Who triggered the priority update. If not provided, defaults to
            'user'
          type: string
          enum:
            - user
            - AI
      required:
        - beforeId
        - solutionIds
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: JWT authentication for organization-scoped endpoints.

````