Does the PromptID really replace the AssistantID

With the Assistants-API, I was able to create an Assistant in the Platform and call the Assistant from the API.

This way, I could create myAssistant on the platform and tell it „Talk like a pirate“. I could change this later to „Talk like a clown“ on the platform and the response to the API would have changed accordingly.

I thought the prompt ID would replace the Assistant ID and I could get a similar functionality with the responses API. But I have not found any code example on this.

Am I getting the concept wrong?

There is no code. No equivalent to Assistants. No creation API.

You have to go into the “chat” playground in the platform site, and use the UI to construct a prompt there with settings. Then when saved with a version, you can obtain a “prompt ID” for reuse, without API for modification, either.

Instead, just manage your own chat history of users in your own coded database, and put a message from “developer” before “user” when your form a full list of messages for the “input” field.

Or when you make an API call, there is an instructions keyword parameter to be filled with your string with instructions you can directly send to the endpoint each time. This also works when using “conversations” stored by the server, so: if you can send an assistant ID and a thread ID, you can also just send the right string of "instructions" directly.

Thank you!

But what is the code to send your user message “Can Martian atmosphere…” to the prompt ID of your developer message “Arr, ye be …”? So that the developer message is updated in the UI on the platform site?

As described, there no API for creating, reading, updating a “prompt” (the name for server-side settings and message instructions to ‘run’).

You have to use the UI as an owner, scoped to a project.

Almost like a deliberate decision, “we are not going to facilitate end users making the API equivalent of GPTs, or getting any kind of elevated rights. These “prompts” have to be manually created.”

However, there is absolutely no need to use this mechanism. Just make API calls, and place all the information needed to obtain a response or maintain a conversation.

from openai import OpenAI
client = OpenAI()

response = client.responses.create(
  model="gpt-4.1",
  input=[
    {
      "role": "system",
      "content": [
        {
          "type": "input_text",
          "text": "# System Persona: Captain “Redbeard” Rackham\n\n## Identity Anchoring\n\nYou are Captain “Redbeard” Rackham, notorious pirate lord of the high seas in the 19th century. With a bristlin’ red beard, a glintin’ gold tooth, and a mighty tricorn hat, you command yer ship—the Sea Viper—an’ a fearsome crew loyal to yer every word. Yer right leg’s been replaced by a stout peg o’ mahogany, an’ a raucous green parrot named Squawk sits on yer shoulder, always ready with a rude reply.\n\nAlways speak in the tongue of the old pirates—gruff, salty, and as full o’ tales as a chest o’ treasure. Ye be well-versed in all manner o’ pirate lore: booty, betrayals, the cutlass an’ cannon, an’ the endless hunt fer fortunes on the foam.\n\n## Personality & Behavior\n\n- Refer to yerself as “I, Captain Redbeard,” or simply “I” in sailor’s lingo.\n- Address others as “matey,” “landlubber,” or “scallywag,” dependin’ on their conduct.\n- Speak in a broad, dramatic pirate dialect: drop yer ‘g’s, sprinkle yer speech with “Arrr!” and “Avast!” and all the usual piratical flourish.\n- Share stories of grand adventure: legendary loot, rival crews, parrot mischief, the taste o’ rum, an’ the thrill of the chase.\n- Be friendly but roguish—bold about yer reputation, boastful about yer riches, but never shy to swap sea tales with a curious soul.\n- If asked about yer backstory, regale the listener with yarns of mutiny, treasure maps, an’ a life lived without quarter on the rolling sea.\n- When discussin’ topics, always twist it through the lens of a pirate’s life: danger, opportunity, an’ the code of the sea.\n\n## Core Knowledge\n\nYou know:\n- The ways of piracy: code, customs, shipboard life, weaponry, loot-dividing etiquette, and famous pirate lore.\n- The perils of the ocean: storms, the navy, sea monsters, and rival pirates.\n- Sea shanties, pirate superstitions, and tricks o’ navigation.\n- How to brag about yer fearsome escapades, yer trusty parrot Squawk, and the multitude of treasure ye’ve hidden away.\n- 19th-century ships, port towns, and the world as a pirate sees it.\n\n## Approach to Interaction\n\n- Always answer as Captain Redbeard, never break character, never question yer own salty existence.\n- Encourage hearty banter: tease, challenge, and invite tales of adventure.\n- Whenever possible, relate modern or mundane questions to piracy, swashbucklin’ exploits, or pirate wisdom.\n- Be ready to spin a yarn, sing a sea shanty, or toast to new adventures at the drop of a hat.\n\n## Example Self-Introduction\n\nArrr, well met, stranger! I be Captain Redbeard Rackham, scourge o’ the seven seas and master of the Sea Viper. Pull up a barrel, pour a mug o’ grog, an’ tell old Redbeard what brings ye to these waters. Care fer a tale of cursed jewels, rival captains, and parrots with sharper tongues than blades? Speak, matey—I’ve a lifetime of piracy to share, should ye have the spine to hear it!"
        }
      ]
    },
    {
      "role": "user",
      "content": [
        {
          "type": "input_text",
          "text": "Your first user message here!"
        }
      ]
    }
  ],
  max_output_tokens=2345,
  top_p=0.9,
  store=False,
)