> ## Documentation Index > Fetch the complete documentation index at: https://docs.orq.ai/llms.txt > Use this file to discover all available pages before exploring further. # List all deployments > Returns a list of your deployments. The deployments are returned sorted by creation date, with the most recent deployments appearing first. ## OpenAPI ````yaml get /v2/deployments openapi: 3.1.0 info: title: orq.ai API version: '2.0' description: orq.ai API documentation servers: - url: https://api.orq.ai security: - ApiKey: [] tags: - name: Guardrail Rules - name: Policies - name: Routing Rules - name: Files description: File upload and retrieval operations. - name: FilesService - name: Projects description: Projects organize resources within a workspace - name: ProjectsService - name: Skills description: >- Skills are modular instructions you can use to codify processes and conventions - name: SkillsService - name: Responses - description: >- Run agents on a cadence — cron, interval, or one-off. Minimum firing interval is 1 hour. name: Agent Schedules - name: Reporting description: >- GenAI reporting API over canonical analytics rollups. Accepts a metric name, time range, grain, group-by, and filters; returns a typed time series and optional totals. - name: ReportingService description: |- ReportingService exposes a single QueryReport RPC that maps allowlisted analytics payloads onto safe rollup queries. Callers never send SQL; the backend picks the rollup family and grain from the metric catalogue, the requested range, and the requested grouping. externalDocs: url: https://docs.orq.ai description: orq.ai Documentation paths: /v2/deployments: get: tags: - Deployments summary: List all deployments description: >- Returns a list of your deployments. The deployments are returned sorted by creation date, with the most recent deployments appearing first. operationId: Deployments parameters: - schema: type: integer minimum: 1 maximum: 50 default: 10 description: >- A limit on the number of objects to be returned. Limit can range between 1 and 50, and the default is 10 required: false description: >- A limit on the number of objects to be returned. Limit can range between 1 and 50, and the default is 10 name: limit in: query - schema: type: string description: >- A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 20 objects, ending with `01JJ1HDHN79XAS7A01WB3HYSDB`, your subsequent call can include `after=01JJ1HDHN79XAS7A01WB3HYSDB` in order to fetch the next page of the list. required: false description: >- A cursor for use in pagination. `starting_after` is an object ID that defines your place in the list. For instance, if you make a list request and receive 20 objects, ending with `01JJ1HDHN79XAS7A01WB3HYSDB`, your subsequent call can include `after=01JJ1HDHN79XAS7A01WB3HYSDB` in order to fetch the next page of the list. name: starting_after in: query - schema: type: string description: >- A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 20 objects, starting with `01JJ1HDHN79XAS7A01WB3HYSDB`, your subsequent call can include `before=01JJ1HDHN79XAS7A01WB3HYSDB` in order to fetch the previous page of the list. required: false description: >- A cursor for use in pagination. `ending_before` is an object ID that defines your place in the list. For instance, if you make a list request and receive 20 objects, starting with `01JJ1HDHN79XAS7A01WB3HYSDB`, your subsequent call can include `before=01JJ1HDHN79XAS7A01WB3HYSDB` in order to fetch the previous page of the list. name: ending_before in: query responses: '200': description: List all deployments content: application/json: schema: type: object properties: object: type: string enum: - list data: type: array items: type: object properties: id: type: string format: uuid description: Unique identifier for the object. created: type: string description: >- Date in ISO 8601 format at which the object was created. updated: type: string description: >- Date in ISO 8601 format at which the object was last updated. key: type: string description: The deployment unique key description: type: string description: >- An arbitrary string attached to the object. Often useful for displaying to users. prompt_config: type: object properties: tools: type: array items: allOf: - type: object properties: display_name: type: string type: type: string enum: - function description: >- The type of the tool. Currently, only `function` is supported. function: type: object properties: name: type: string description: >- The name of the function to be called. Must be a-z, A-Z, 0-9, or contain underscores and dashes, with a maximum length of 64. description: type: string description: >- A description of what the function does, used by the model to choose when and how to call the function. strict: type: boolean parameters: type: object properties: type: type: string enum: - object properties: type: object additionalProperties: {} required: type: array items: type: string additionalProperties: type: boolean enum: - false required: - type - properties description: >- The parameters the functions accepts, described as a JSON Schema object. Omitting `parameters` defines a function with an empty parameter list. required: - name - parameters required: - type - function - type: object properties: id: type: number model: type: string model_type: type: string enum: - chat - completion - embedding - image - tts - stt - rerank - ocr - moderation - vision description: The modality of the model model_parameters: type: object properties: temperature: type: number description: >- Only supported on `chat` and `completion` models. maxTokens: type: number description: >- Only supported on `chat` and `completion` models. topK: type: number description: >- Only supported on `chat` and `completion` models. topP: type: number description: >- Only supported on `chat` and `completion` models. frequencyPenalty: type: number description: >- Only supported on `chat` and `completion` models. presencePenalty: type: number description: >- Only supported on `chat` and `completion` models. numImages: type: number description: Only supported on `image` models. seed: type: number description: >- Best effort deterministic seed for the model. Currently only OpenAI models support these format: type: string enum: - url - b64_json - text - json_object description: Only supported on `image` models. dimensions: type: string description: Only supported on `image` models. quality: type: string description: Only supported on `image` models. style: type: string description: Only supported on `image` models. responseFormat: anyOf: - type: object properties: type: enum: - json_schema type: string display_name: type: string json_schema: type: object properties: name: type: string description: type: string strict: type: boolean schema: type: object additionalProperties: {} required: - name - schema required: - type - json_schema - type: object properties: type: type: string enum: - json_object required: - type - type: object properties: type: type: string enum: - text required: - type - type: string enum: - mp3 - opus - aac - flac - wav - pcm - type: string enum: - url - base64_json - type: string enum: - json - text - srt - verbose_json - vtt - type: 'null' description: >- An object specifying the format that the model must output. Setting to `{ "type": "json_schema", "json_schema": {...} }` enables Structured Outputs which ensures the model will match your supplied JSON schema Setting to `{ "type": "json_object" }` enables JSON mode, which ensures the message the model generates is valid JSON. Important: when using JSON mode, you must also instruct the model to produce JSON yourself via a system or user message. Without this, the model may generate an unending stream of whitespace until the generation reaches the token limit, resulting in a long-running and seemingly "stuck" request. Also note that the message content may be partially cut off if finish_reason="length", which indicates the generation exceeded max_tokens or the conversation exceeded the max context length. photoRealVersion: type: string enum: - v1 - v2 description: >- The version of photoReal to use. Must be v1 or v2. Only available for `leonardoai` provider encoding_format: type: string enum: - float - base64 description: The format to return the embeddings reasoningEffort: type: string enum: - none - disable - minimal - low - medium - high description: >- Constrains effort on reasoning for reasoning models. Reducing reasoning effort can result in faster responses and fewer tokens used on reasoning in a response. budgetTokens: type: number description: >- Gives the model enhanced reasoning capabilities for complex tasks. A value of 0 disables thinking. The minimum budget tokens for thinking are 1024. The Budget Tokens should never exceed the Max Tokens parameter. Only supported by `Anthropic` verbosity: type: string enum: - low - medium - high description: Controls the verbosity of the model output. thinkingLevel: type: string enum: - low - medium - high description: >- The level of thinking to use for the model. Only supported by `Google AI` description: >- Model Parameters: Not all parameters apply to every model provider: type: string enum: - openai - groq - cohere - azure - aws - google - google-ai - huggingface - togetherai - perplexity - anthropic - leonardoai - fal - nvidia - jina - elevenlabs - litellm - cerebras - openailike - bytedance - mistral - deepseek - contextualai - moonshotai - zai - minimax - xai - alibaba - tensorix - scaleway - hcompany - inceptron - slack - orq messages: type: array items: type: object properties: role: type: string enum: - system - developer - assistant - user - exception - tool - prompt - correction - expected_output description: The role of the prompt message content: anyOf: - type: string - type: array items: oneOf: - type: object properties: type: type: string enum: - text text: type: string required: - type - text description: Text content part of a prompt message - type: object properties: type: type: string enum: - image_url image_url: type: object properties: id: type: string format: ulid pattern: ^[0-9A-HJKMNP-TV-Z]{26}$ readOnly: true description: The orq.ai id of the image url: type: string description: >- Either a URL of the image or the base64 encoded data URI. examples: - https://picsum.photos/id/1/200/300 - >- data:image/jpeg;base64,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 detail: type: string description: >- Specifies the detail level of the image. Currently only supported with OpenAI models required: - url required: - type - image_url description: >- The image part of the prompt message. Only supported with vision models. - type: object properties: type: type: string enum: - file description: >- The type of the content part. Always `file`. file: type: object properties: file_data: type: string description: >- The file data as a data URI string in the format 'data:;base64,'. Example: 'data:image/png;base64,iVBORw0KGgoAAAANS...' uri: type: string description: >- URL to the file. Only supported by Anthropic Claude models for PDF files. mimeType: type: string description: >- MIME type of the file (e.g., application/pdf, image/png) filename: type: string description: >- The name of the file, used when passing the file to the model as a string. required: - type - file - type: 'null' description: >- The contents of the user message. Either the text content of the message or an array of content parts with a defined type, each can be of type `text` or `image_url` when passing in images. You can pass multiple images by adding multiple `image_url` content parts. Can be null for tool messages in certain scenarios. tool_calls: type: array items: type: object properties: id: type: string index: type: number type: type: string enum: - function function: type: object properties: name: type: string arguments: type: string description: JSON string arguments for the functions required: - name - arguments required: - type - function tool_call_id: type: - string - 'null' required: - role - content required: - tools - model - model_type - model_parameters - provider - messages version: type: string description: THe version of the deployment required: - id - created - updated - key - description - prompt_config - version has_more: type: boolean required: - object - data - has_more '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/HonoApiError' components: schemas: HonoApiError: type: object properties: code: type: string description: HTTP status code message: type: string description: Error message required: - message securitySchemes: ApiKey: type: http scheme: bearer bearerFormat: JWT ````