curl --request PATCH \
  --url https://guidinghand.ai/v1/agents/{agent_id}/draft \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "instructions": "<string>",
  "greeting": "<string>",
  "display_name": "<string>",
  "narration": true,
  "customer_answers": true,
  "customer_approvals": true,
  "guardrails": {
    "confirm": [],
    "block": [],
    "apps": {
      "allow": [
        "<string>"
      ],
      "block": [
        "<string>"
      ]
    },
    "sites": {
      "allow": [
        "<string>"
      ],
      "block": [
        "<string>"
      ]
    },
    "scope": "<string>",
    "screen_check": true,
    "max_steps": 250,
    "max_minutes": 120,
    "approval_timeout_minutes": 720
  },
  "tools": {
    "files": {
      "enabled": true
    },
    "http": [
      {
        "name": "lookup_order",
        "description": "Look up an order by its number: status, items and delivery date.",
        "url": "https://api.acme.com/guidinghand/lookup-order",
        "parameters": {
          "type": "object",
          "properties": {}
        },
        "approval": "never"
      }
    ]
  }
}
'

const options = {
  method: 'PATCH',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: '<string>',
    instructions: '<string>',
    greeting: '<string>',
    display_name: '<string>',
    narration: true,
    customer_answers: true,
    customer_approvals: true,
    guardrails: {
      confirm: [],
      block: [],
      apps: {allow: ['<string>'], block: ['<string>']},
      sites: {allow: ['<string>'], block: ['<string>']},
      scope: '<string>',
      screen_check: true,
      max_steps: 250,
      max_minutes: 120,
      approval_timeout_minutes: 720
    },
    tools: {
      files: {enabled: true},
      http: [
        {
          name: 'lookup_order',
          description: 'Look up an order by its number: status, items and delivery date.',
          url: 'https://api.acme.com/guidinghand/lookup-order',
          parameters: {type: 'object', properties: {}},
          approval: 'never'
        }
      ]
    }
  })
};

fetch('https://guidinghand.ai/v1/agents/{agent_id}/draft', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://guidinghand.ai/v1/agents/{agent_id}/draft"

payload = {
    "name": "<string>",
    "instructions": "<string>",
    "greeting": "<string>",
    "display_name": "<string>",
    "narration": True,
    "customer_answers": True,
    "customer_approvals": True,
    "guardrails": {
        "confirm": [],
        "block": [],
        "apps": {
            "allow": ["<string>"],
            "block": ["<string>"]
        },
        "sites": {
            "allow": ["<string>"],
            "block": ["<string>"]
        },
        "scope": "<string>",
        "screen_check": True,
        "max_steps": 250,
        "max_minutes": 120,
        "approval_timeout_minutes": 720
    },
    "tools": {
        "files": { "enabled": True },
        "http": [
            {
                "name": "lookup_order",
                "description": "Look up an order by its number: status, items and delivery date.",
                "url": "https://api.acme.com/guidinghand/lookup-order",
                "parameters": {
                    "type": "object",
                    "properties": {}
                },
                "approval": "never"
            }
        ]
    }
}
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.patch(url, json=payload, headers=headers)

print(response.text)

{
  "object": "agent_draft",
  "agent_id": "billing",
  "name": "Billing help",
  "instructions": "<string>",
  "model": "claude-sonnet-5-5",
  "effort": "low",
  "greeting": "<string>",
  "display_name": "Acme Support",
  "narration": true,
  "customer_answers": true,
  "customer_approvals": true,
  "guardrails": {
    "mode": "supervised",
    "confirm": [
      "purchase",
      "send",
      "delete",
      "install",
      "security",
      "terms"
    ],
    "block": [],
    "apps": {
      "allow": [],
      "block": []
    },
    "sites": {
      "allow": [],
      "block": []
    },
    "safety_checks": "ask",
    "scope": "",
    "screen_check": false,
    "max_steps": 150,
    "max_minutes": null,
    "approval_timeout_minutes": null
  },
  "tools": {
    "files": {
      "enabled": true,
      "access": "read_write"
    },
    "http": []
  },
  "is_default": true,
  "invite_url_template": "https://guidinghand.ai/acme/billing/{code}",
  "version": 1,
  "has_draft": true,
  "created_by": {
    "type": "user",
    "email": "jane@acme.com"
  },
  "updated_by": {
    "type": "user",
    "email": "jane@acme.com"
  },
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "based_on_version": 1,
  "saved_at": "2023-11-07T05:31:56Z",
  "saved_by": {
    "type": "user",
    "email": "jane@acme.com"
  }
}

{
  "error": {
    "type": "invalid_request",
    "message": "<string>",
    "code": "<string>",
    "answered_by": "customer",
    "test_case_ids": [
      "<string>"
    ]
  }
}

{
  "error": {
    "type": "invalid_request",
    "message": "<string>",
    "code": "<string>",
    "answered_by": "customer",
    "test_case_ids": [
      "<string>"
    ]
  }
}

{
  "error": {
    "type": "invalid_request",
    "message": "<string>",
    "code": "<string>",
    "answered_by": "customer",
    "test_case_ids": [
      "<string>"
    ]
  }
}

{
  "error": {
    "type": "invalid_request",
    "message": "<string>",
    "code": "<string>",
    "answered_by": "customer",
    "test_case_ids": [
      "<string>"
    ]
  }
}