Skip to main content

List Integration Model Prompts

Endpoint: GET /api/integrations/provider/{integration_provider}/integration/{integration_name}/prompt

Retrieves all prompts associated with a specific model under an integration provider.

Path parameters​

ParameterDescriptionTypeRequired/ Optional
integration_providerThe name of the integration provider in Conductor from which the prompt is to be retrieved.stringRequired.
integration_nameThe name of the model.stringRequired.

Response​

StatusDescription
200 OKReturns an array of prompt objects.
403 ForbiddenIndicates that the authenticated user does not have READ or UPDATE access on the prompt.
404 Not FoundThe integration provider, integration, or prompt does not exist.

Examples​

Get prompts associated with an integration provider

Request

curl -X 'GET' \
  'https://<YOUR-SERVER-URL>/api/integrations/provider/openAI/integration/gpt-4o/prompt' \
  -H 'accept: application/json' \
  -H 'X-Authorization: <TOKEN>'

Response

[
  {
    "createTime": 1766476941820,
    "updateTime": 1774266945682,
    "createdBy": "john.doe@acme.com",
    "updatedBy": "john.doe@acme.com",
    "name": "Document-Retrieval",
    "template": "You are an assistant that answers questions using only the provided context.\nIf the context does not contain the answer, say that the information is not available.\nKeep your responses short and clear.\n\nQuestion:\n${question}\n\nContext:\n${retrievedContext}",
    "description": "Generates an answer to a user question using only the context retrieved from the vector database.\n",
    "variables": [
      "retrievedContext",
      "question"
    ],
    "integrations": [
      "openAI:gpt-4o",
      "openAI:chatgpt-4o-latest"
    ],
    "version": 1
  },
  {
    "createTime": 1769502880756,
    "updateTime": 1769502880756,
    "createdBy": "john.doe@acme.com",
    "updatedBy": "john.doe@acme.com",
    "name": "population-prompt",
    "template": "What is the current population of `${country}`? What was the population in `${year}`?",
    "description": "Population prompt",
    "variables": [
      "country",
      "year"
    ],
    "integrations": [
      "openAI:gpt-4o",
      "openAI:chatgpt-4o-latest"
    ],
    "version": 1
  },
  {
    "createTime": 1740554651215,
    "updateTime": 1768294578179,
    "createdBy": "john.doe@acme.com",
    "updatedBy": "john.doe@acme.com",
    "name": "translate",
    "template": "Translate the following text into ${language}.\n\n<text>\n${text} \n</text>\n\nReply only with the translation and nothing else.",
    "description": "Translate text from any source language to any target language.",
    "variables": [
      "language",
      "text"
    ],
    "integrations": [
      "openAI:gpt-4o",
      "openAI:chatgpt-4o-latest"
    ],
    "version": 1
  },
  {
    "createTime": 1738303350247,
    "updateTime": 1768378780327,
    "createdBy": "john.doe@acme.com",
    "updatedBy": "john.doe@acme.com",
    "name": "doc_classifier_prompt",
    "template": "We have a document that was scanned using OCR. The content is ${text}. You need to classify the document based on the provided OCR content. The document could be one of these: W2, Drivers License, Pay stub, Employment Verification Letter, or Mortgage Application. Suppose the provided content does not match with any of those documents. In that case, you must reply NO_MATCH, and in the following line, you must give a human-understandable message about the result and why that determination was made in under three sentences. If the provided content matches, return the values found, including the document type. If the social security number is part of the values, obfuscate the first five digits.",
    "description": "The AI prompt to classify documents.",
    "variables": [
      "text"
    ],
    "integrations": [
      "openAI:gpt-4o"
    ],
    "version": 1
  }
]