---
title: "Get Model Parameters"
method: POST
path: "/sdk/v1/prompts/{id}"
---

# Get Model Parameters

`POST /sdk/v1/prompts/{id}`

Fetches the configured model parameters and messages rendered with the provided variables mapped to the set LLM provider. This endpoint abstracts the need to handle mapping between different providers, while still allowing direct calls to the providers.

## Path parameters

- `id` string, required

## Request body

- GetModelParametersBody
  - `variables` PromptVariables — The template variables added to the prompt when executing the prompt.
  - `overrideMessages` ConversationMessage[] — Replaces the configured prompt messages when running the prompt.
    - `content` MessageContentBlockSchema[], required
      - union
        - TextContentBlock
          - `type` 'TEXT', required
          - `text` string, required
        - ImageBase64ContentBlock
          - `type` 'IMAGE_BASE64', required
          - `imageBase64` string, required
          - `mediaType` string, required
        - ToolCallContentBlock
          - `type` 'TOOL_CALL', required
          - `toolCall` ToolFunctionCall, required
            - `toolCallId` string, required — TOOL_CALL_1
            - `type` 'function', required — The type of the tool. Currently, only `function` is supported.
            - `function` object, required
              - …
        - ToolResultContentBlock
          - `type` 'TOOL_RESULT', required
          - `toolCallId` string, required
          - `result` string, required
    - `role` 'assistant' | 'system' | 'tool' | 'user', required
  - `appendMessages` ConversationMessage[] — Appended the the end of the configured prompt messages before running the prompt.
    - `content` MessageContentBlockSchema[], required
      - union
        - TextContentBlock
          - `type` 'TEXT', required
          - `text` string, required
        - ImageBase64ContentBlock
          - `type` 'IMAGE_BASE64', required
          - `imageBase64` string, required
          - `mediaType` string, required
        - ToolCallContentBlock
          - `type` 'TOOL_CALL', required
          - `toolCall` ToolFunctionCall, required
            - `toolCallId` string, required — TOOL_CALL_1
            - `type` 'function', required — The type of the tool. Currently, only `function` is supported.
            - `function` object, required
              - …
        - ToolResultContentBlock
          - `type` 'TOOL_RESULT', required
          - `toolCallId` string, required
          - `result` string, required
    - `role` 'assistant' | 'system' | 'tool' | 'user', required
  - `user` string — A unique identifier representing your end-user, which can help monitor and detect abuse.

## Response `200`

Successfully retrieved the prompt configuration

- union
  - object
    - `provider` 'anthropic', required
    - `name` string, required
    - `parameters` AnthropicMessageCreateParamsBase, required
      - `max_tokens` number, required
      - `messages` AnthropicMessageParam[], required
        - `content` union, required
          - string
          - union[]
            - union
              - …
        - `role` 'user' | 'assistant', required
      - `model` union, required
        - string
        - 'claude-3-5-sonnet-20240620' | 'claude-3-opus-20240229' | 'claude-3-sonnet-20240229' | 'claude-3-haiku-20240307'
      - `metadata` object
        - `user_id` string, nullable
      - `stop_sequences` string[]
      - `stream` boolean
      - `system` string
      - `temperature` number
      - `tool_choice` union
        - object
          - `type` 'auto', required
        - object
          - `type` 'any', required
        - object
          - `name` string, required
          - `type` 'tool', required
      - `tools` object[]
        - `input_schema` object, required
          - `type` 'object', required
          - `properties` unknown
        - `name` string, required
        - `description` string
      - `top_k` number
      - `top_p` number
  - object
    - `provider` 'openai', required
    - `name` string, required
    - `parameters` OpenAICreateCompletionRequest, required
      - `messages` OpenAIChatCompletionRequestMessage[], required
        - union
          - OpenAIChatCompletionRequestSystemMessage
            - `content` string, required
            - `role` 'system', required
            - `name` string
          - OpenAIChatCompletionRequestUserMessage
            - `content` union, required
              - …
            - `role` 'user', required
            - `name` string
          - OpenAIChatCompletionRequestAssistantMessage
            - `content` string, nullable
            - `role` 'assistant', required
            - `name` string
            - `tool_calls` OpenAIChatCompletionMessageToolCall[]
              - …
            - `function_call` object, nullable
              - …
          - OpenAIChatCompletionRequestToolMessage
            - `role` 'tool', required
            - `content` string, required
            - `tool_call_id` string, required
          - OpenAIChatCompletionRequestFunctionMessage
            - `role` 'function', required
            - `content` string, nullable, required
            - `name` string, required
      - `model` string, required
      - `frequency_penalty` number, nullable
      - `logit_bias` object, nullable
      - `logprobs` boolean, nullable
      - `top_logprobs` integer, nullable
      - `max_tokens` integer, nullable
      - `n` integer, nullable
      - `presence_penalty` number, nullable
      - `response_format` object
        - `type` 'text' | 'json_object'
      - `seed` integer, nullable
      - `stop` union
        - string
        - string[]
      - `stream` boolean, nullable
      - `stream_options` OpenAIChatCompletionStreamOptions, nullable
        - `include_usage` boolean, required
      - `temperature` number, nullable
      - `top_p` number, nullable
      - `tools` OpenAIChatCompletionTool[]
        - `type` 'function', required
        - `function` OpenAIFunctionObject, required
          - `description` string
          - `name` string, required
          - `parameters` OpenAIFunctionParameters
      - `tool_choice` union
        - 'none' | 'auto' | 'required'
        - OpenAIChatCompletionNamedToolChoice
          - `type` 'function', required
          - `function` object, required
            - `name` string, required
      - `parallel_tool_calls` boolean
      - `user` string

## Other responses

- `400` — Missing or invalid parameters
- `401` — Unauthorized
- `404` — Not found
- `500` — Internal Server Error

---

[API](https://skmtc.net/prompt-foundry/apis/prompt-foundry-api.md) · [All operations](https://skmtc.net/prompt-foundry/apis/prompt-foundry-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/prompt-foundry/prompt-foundry-api/revisions/84eb1e848fd1/schema)