Deployments

Get config

Retrieve the deployment configuration

post/v2/deployments/get_config

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' | '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

Changed in 22 of the 266 revisions of this API.111318

    • removed subschema #9: exists from the // request property anyOf list

      request-property-any-of-removed

    • removed subschema #9: exists from the //// request property anyOf list

      request-property-any-of-removed

    • removed subschema #9: exists from the //// request property anyOf list

      request-property-any-of-removed

    This revision also has 31 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • added subschema #9: exists to the // request property anyOf list

      request-property-any-of-added

    • added subschema #9: exists to the //// request property anyOf list

      request-property-any-of-added

    • added subschema #9: exists to the //// request property anyOf list

      request-property-any-of-added

    This revision also has 173 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • removed subschema #9: exists from the // request property anyOf list

      request-property-any-of-removed

    • removed subschema #9: exists from the //// request property anyOf list

      request-property-any-of-removed

    • removed subschema #9: exists from the //// request property anyOf list

      request-property-any-of-removed

    This revision also has 31 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • added subschema #9: exists to the // request property anyOf list

      request-property-any-of-added

    • added subschema #9: exists to the //// request property anyOf list

      request-property-any-of-added

    • added subschema #9: exists to the //// request property anyOf list

      request-property-any-of-added

    This revision also has 175 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • removed subschema #9: exists from the // request property anyOf list

      request-property-any-of-removed

    • removed subschema #9: exists from the //// request property anyOf list

      request-property-any-of-removed

    • removed subschema #9: exists from the //// request property anyOf list

      request-property-any-of-removed

    • removed the max enum value from the / response property for the response status

      response-property-enum-value-removed

    • removed the xhigh enum value from the / response property for the response status

      response-property-enum-value-removed

    This revision also has 97 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • added the new max enum value to the / response property for the response status

      response-property-enum-value-added

    • added the new xhigh enum value to the / response property for the response status

      response-property-enum-value-added

    This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • removed the max enum value from the / response property for the response status

      response-property-enum-value-removed

    • removed the xhigh enum value from the / response property for the response status

      response-property-enum-value-removed

    This revision also has 95 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • added the new max enum value to the / response property for the response status

      response-property-enum-value-added

    • added the new xhigh enum value to the / response property for the response status

      response-property-enum-value-added

    This revision also has 3 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

    • removed the max enum value from the / response property for the response status

      response-property-enum-value-removed

    • removed the xhigh enum value from the / response property for the response status

      response-property-enum-value-removed

    This revision also has 158 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Of the 266 revisions, 77 have no diff computed.