Deployments

Retrieve the deployment configuration

post/v2/deployments/get_config

Request

  • Base URL
    https://my.orq.ai
  • URL
    https://my.orq.ai/v2/deployments/get_config
  • Auth
    HTTP bearer

Request body

keystring required

The deployment key to invoke

inputsobject

Key-value pairs variables to replace in your prompts. If a variable is not provided that is defined in the prompt, the default variables are used.

contextobject

Key-value pairs that match your data model and fields declared in your deployment routing configuration

file_idsstring[]

A list of file IDs that are associated with the deployment request.

metadataobject

Key-value pairs that you want to attach to the log generated by this request.

extra_paramsobject

Utilized for passing additional parameters to the model provider. Exercise caution when using this feature, as the included parameters will overwrite any parameters specified in the deployment prompt configuration.

Example request

{
  "identity": {
    "id": "contact_01ARZ3NDEKTSV4RRFFQ69G5FAV",
    "display_name": "Jane Doe",
    "email": "jane.doe@example.com",
    "metadata": [
      {
        "department": "Engineering",
        "role": "Senior Developer"
      }
    ],
    "logo_url": "https://example.com/avatars/jane-doe.jpg",
    "tags": [
      "hr",
      "engineering"
    ]
  },
  "documents": [
    {
      "text": "The refund policy allows customers to return items within 30 days of purchase for a full refund.",
      "metadata": {
        "file_name": "refund_policy.pdf",
        "file_type": "application/pdf",
        "page_number": 1
      }
    },
    {
      "text": "Premium members receive free shipping on all orders over $50.",
      "metadata": {
        "file_name": "membership_benefits.md",
        "file_type": "text/markdown"
      }
    }
  ]
}

Response

Configurations Retrieved.

idstring required

A unique identifier for the response. Can be used to add metrics to the transaction.

providerstring required

The provider of the model

modelstring required

The model of the configuration

type'chat' | 'completion' | 'embedding' | 'image' | 'tts' | 'stt' | 'rerank' | 'ocr' | 'moderation' | 'classify' | 'vision'

The type of the model. Current chat,completion and image are supported

versionstring required

The current version of the deployment

Example response

{
  "messages": [
    {
      "content": [
        {
          "image_url": {
            "url": "https://picsum.photos/id/1/200/300"
          }
        }
      ]
    }
  ]
}

Changes

    • info

      added the new optional request property ////////

    • info

      added the new optional request property ////////

    • breaking

      removed subschema #1 subschema #2 from the /// request property anyOf list

    • breaking

      removed subschema #1 subschema #2 from the /// request property anyOf list

    • info

      added the new optional request property /////

    • info

      added the new optional request property /////

    • info

      added subschema #1 subschema #2 to the /// request property anyOf list

    • info

      added subschema #1 subschema #2 to the /// request property anyOf list