Skip to main content
PUT
/
api
/
v1
/
profiles
/
{name}
Update Profile
curl --request PUT \
  --url https://agentgate.mynewapi.com/api/v1/profiles/{name} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "description": "<string>",
  "extends": "<string>",
  "loopStrategy": {},
  "verification": {},
  "gitOps": {},
  "executionLimits": {}
}
'
{
  "success": true,
  "data": {
    "name": "<string>",
    "message": "<string>"
  }
}

​
Update Profile

Updates an existing profile with new configuration values.
This endpoint requires authentication. Built-in profiles cannot be modified.

​
Request

​
name
string
required
The profile name to update
​
description
string
Updated profile description
​
extends
string
Updated parent profile
​
loopStrategy
object
Updated loop strategy configuration
​
verification
object
Updated verification configuration
​
gitOps
object
Updated Git operations configuration
​
executionLimits
object
Updated execution limits configuration
curl -X PUT https://agentgate.mynewapi.com/api/v1/profiles/my-custom-profile \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Updated description",
    "loopStrategy": {
      "baseIterations": 10
    }
  }'

​
Response

​
success
boolean
required
Indicates if the request was successful
​
data
object
required
Update result

​
Example Response

{
  "success": true,
  "data": {
    "name": "my-custom-profile",
    "message": "Profile updated successfully"
  },
  "requestId": "req_abc123"
}

​
Error Responses

​
Cannot Modify Built-in Profile

{
  "success": false,
  "error": {
    "code": "FORBIDDEN",
    "message": "Cannot modify built-in profile: default"
  }
}

​
Profile Not Found

{
  "success": false,
  "error": {
    "code": "NOT_FOUND",
    "message": "Profile not found: unknown-profile"
  }
}

​
Circular Inheritance

{
  "success": false,
  "error": {
    "code": "BAD_REQUEST",
    "message": "Profile cannot extend itself"
  }
}