Skip to main content
GET
/
model-hub
/
prompt-labels
/
get-by-name
Get prompt version by name
curl --request GET \
  --url https://api.futureagi.com/model-hub/prompt-labels/get-by-name/ \
  --header 'X-Api-Key: <api-key>' \
  --header 'X-Secret-Key: <api-key>'
{
  "status": true,
  "result": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "customer-support-agent",
    "description": "Customer support prompt template",
    "variable_names": [
      "company_name",
      "order_id"
    ],
    "organization": "11111111-2222-3333-4444-555555555555",
    "prompt_folder": null,
    "placeholders": null,
    "created_by": "user@example.com",
    "prompt_config": [
      {
        "messages": [
          {
            "role": "system",
            "content": "You are a customer support agent for {{company_name}}."
          }
        ],
        "configuration": {
          "model": "gpt-4o",
          "temperature": 0.7,
          "max_tokens": 1000,
          "top_p": 1,
          "frequency_penalty": 0,
          "presence_penalty": 0
        }
      }
    ],
    "version": "v1",
    "output": null,
    "is_draft": false,
    "metadata": null,
    "labels": [
      {
        "id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
        "name": "Production",
        "type": "system"
      }
    ]
  }
}

Authorizations

X-Api-Key
string
header
required

API Key for authentication. Click here to access API Key

X-Secret-Key
string
header
required

Secret Key for authentication. Click here to access Secret Key

Query Parameters

name
string
required

The exact name of the prompt template.

version
string

The version name to fetch (e.g. v1, v2). Takes precedence over label if both are provided.

label
string

The label name to resolve (e.g. Production, Staging, Development, or a custom label). Used only when version is not provided.

Response

Successfully retrieved the prompt version.

status
boolean
Example:

true

result
object