Skip to main content
PUT
/
agents
/
{agent_id}
/
system-steps
/
{step}
/
prompt
Update agent system step prompt
curl --request PUT \
  --url https://api.trymaitai.ai/api/v1/agents/{agent_id}/system-steps/{step}/prompt \
  --header 'Content-Type: application/json' \
  --header 'X-Maitai-Api-Key: <api-key>' \
  --data '
{
  "template": "{{persona}}\n\n{{core_instructions}}",
  "blocks": [
    {
      "reference": "persona",
      "content": "You are a meticulous orchestration planner."
    }
  ]
}
'
{
  "data": {
    "success": true,
    "prompt_id": 1234
  }
}

Authorizations

X-Maitai-Api-Key
string
header
required

Your Maitai API key from the Portal.

Path Parameters

agent_id
integer
required
step
string
required

Body

application/json
template
string

Ordered {{reference}} token template.

blocks
object[]

Block edits as [{reference, content}]. Only editable blocks are applied; non-owning companies clone the seed.

Response

200 - application/json

Update agent system step prompt.

data
any