> ## Documentation Index > Fetch the complete documentation index at: https://arklowdocs.io/llms.txt > Use this file to discover all available pages before exploring further. # List recommendation proposals ## OpenAPI ````yaml https://api.arklow.io/swagger/ui/json get /v1/orgs/{org_id}/proposals/ openapi: 3.1.0 info: title: Arklow description: Arklow's API version: 0.1.0 servers: - url: https://api.arklow.io description: Production - url: http://localhost:3123 description: Local development security: - apiKey: [] tags: - name: actions - name: api_keys - name: billing - name: capacity-domains - name: credentials - name: destinations - name: invites - name: members - name: metrics - name: notifications - name: orgs - name: proposals - name: rules - name: scale-targets - name: sources - name: users - name: ingress externalDocs: url: https://api.arklow.io/swagger/ui paths: /v1/orgs/{org_id}/proposals/: get: tags: - proposals summary: List recommendation proposals operationId: get_v1_orgs_by_org_id_proposals parameters: - schema: type: integer minimum: 1 maximum: 50 in: query name: take required: false - schema: type: integer minimum: 0 in: query name: skip required: false - schema: anyOf: - anyOf: - type: object required: - col - op properties: col: type: string op: anyOf: - type: string enum: - eq - type: string enum: - neq - type: string enum: - starts_with - type: string enum: - contains - type: string enum: - not_contains - type: string enum: - is_null - type: string enum: - is_not_null value: type: string - type: array items: type: object required: - col - op properties: col: type: string op: anyOf: - type: string enum: - eq - type: string enum: - neq - type: string enum: - starts_with - type: string enum: - contains - type: string enum: - not_contains - type: string enum: - is_null - type: string enum: - is_not_null value: type: string - type: string in: query name: search required: false - schema: type: string in: query name: field required: false - schema: type: string in: query name: value required: false - schema: anyOf: - type: string enum: - eq - type: string enum: - neq - type: string enum: - starts_with - type: string enum: - contains - type: string enum: - not_contains - type: string enum: - is_null - type: string enum: - is_not_null in: query name: op required: false - schema: type: boolean in: query name: count_only required: false - schema: anyOf: - type: string enum: - capacity_domain_membership - type: string enum: - capacity_domain_declared_budget - type: string enum: - dispatch_lane_caps - type: string enum: - scale_target_adjustment - type: string enum: - scale_target_envelope - type: string enum: - scale_target_binding in: query name: kind required: false - schema: anyOf: - type: string enum: - proposed - type: string enum: - accepted - type: string enum: - dismissed in: query name: status required: false - schema: type: string pattern: ^[0-9]+$ in: path name: org_id required: true responses: '200': description: Default Response content: application/json: schema: type: object required: - data - errors properties: data: anyOf: - type: object required: - items - count properties: items: type: array items: type: object required: - id - org_id - kind - subject_key - status - proposed - evidence - acted_at - updated_at properties: id: type: string pattern: ^[0-9]+$ org_id: type: string pattern: ^[0-9]+$ kind: anyOf: - type: string enum: - capacity_domain_membership - type: string enum: - capacity_domain_declared_budget - type: string enum: - dispatch_lane_caps - type: string enum: - scale_target_adjustment - type: string enum: - scale_target_envelope - type: string enum: - scale_target_binding subject_key: type: string status: anyOf: - type: string enum: - proposed - type: string enum: - accepted - type: string enum: - dismissed proposed: anyOf: - type: object required: - capacity_domain_id - destination_id properties: capacity_domain_id: type: string pattern: ^[0-9]+$ destination_id: type: string pattern: ^[0-9]+$ additionalProperties: false - type: object required: - capacity_domain_id - declared_budget properties: capacity_domain_id: type: string pattern: ^[0-9]+$ declared_budget: type: integer minimum: 1 additionalProperties: false - type: object required: - dispatch_lane - tag_dimensions_key - running_limit_cap - unsettled_limit_cap - confidence_bps - sample_size properties: dispatch_lane: type: string tag_dimensions_key: type: string running_limit_cap: anyOf: - type: integer minimum: 1 - type: 'null' unsettled_limit_cap: anyOf: - type: integer minimum: 1 - type: 'null' confidence_bps: type: integer minimum: 0 sample_size: type: integer minimum: 0 additionalProperties: false - type: object required: - scale_target_id - effective_min_replicas - basis properties: scale_target_id: type: string pattern: ^[0-9]+$ effective_min_replicas: type: integer minimum: 0 basis: {} additionalProperties: false - type: object required: - scale_target_id - needed_replicas - current_max_replicas properties: scale_target_id: type: string pattern: ^[0-9]+$ needed_replicas: type: integer minimum: 1 current_max_replicas: type: integer minimum: 1 additionalProperties: false - type: object required: - scale_target_id - metric_source_query_id - firing_series_id properties: scale_target_id: type: string pattern: ^[0-9]+$ metric_source_query_id: type: string pattern: ^[0-9]+$ tag_projection_key: type: string minLength: 1 tag_projection_value: type: string minLength: 1 firing_series_id: type: string minLength: 1 additionalProperties: false evidence: anyOf: - {} - type: 'null' acted_at: anyOf: - type: string format: date-time - type: 'null' updated_at: type: string format: date-time count: type: integer - type: 'null' errors: anyOf: - type: array items: type: object required: - code - message properties: code: type: string message: type: string - type: 'null' components: securitySchemes: apiKey: type: apiKey name: x-arklow-auth in: header ````