---
agentTools:
  projectIndex: https://chimoney.readme.io/llms.txt
---

# Update agent passport policies

Updates agent APort passport with limits, capabilities, and regions.
This directly updates the agent's passport according to Open Agent Passport schema.
At least one of limits, capabilities, or regions must be provided.

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Chimoney API Docs",
    "version": "0.2.4",
    "description": "This is the latest version of the Chimoney API. For deprecated version routes, please refer to /v0.2/api-docs."
  },
  "security": [
    {
      "apiKeyAuth": []
    }
  ],
  "servers": [
    {
      "url": "https://api.chimoney.io/",
      "description": "Prod Server"
    },
    {
      "url": "https://api-v2-sandbox.chimoney.io",
      "description": "Sandbox API v2 (v0.2.4)"
    }
  ],
  "paths": {
    "/v0.2.4/agents/update-policies": {
      "patch": {
        "summary": "Update agent passport policies",
        "description": "Updates agent APort passport with limits, capabilities, and regions.\nThis directly updates the agent's passport according to Open Agent Passport schema.\nAt least one of limits, capabilities, or regions must be provided.\n",
        "tags": [
          "Agents"
        ],
        "security": [
          {
            "apiKeyAuth": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "id"
                ],
                "properties": {
                  "id": {
                    "type": "string",
                    "description": "Agent UID"
                  },
                  "subAccount": {
                    "type": "string",
                    "description": "Sub-account identifier"
                  },
                  "limits": {
                    "type": "object",
                    "description": "Transaction limits",
                    "properties": {
                      "USD": {
                        "type": "object",
                        "properties": {
                          "maxPerTx": {
                            "type": "integer",
                            "description": "Maximum USD per transaction",
                            "example": 10000
                          },
                          "dailyCap": {
                            "type": "integer",
                            "description": "Daily USD cap",
                            "example": 100000
                          }
                        }
                      },
                      "CAD": {
                        "type": "object",
                        "properties": {
                          "maxPerTx": {
                            "type": "integer",
                            "example": 10000
                          },
                          "dailyCap": {
                            "type": "integer",
                            "example": 100000
                          }
                        }
                      },
                      "NGN": {
                        "type": "object",
                        "properties": {
                          "maxPerTx": {
                            "type": "integer",
                            "example": 10000
                          },
                          "dailyCap": {
                            "type": "integer",
                            "example": 100000
                          }
                        }
                      },
                      "MXN": {
                        "type": "object",
                        "properties": {
                          "maxPerTx": {
                            "type": "integer",
                            "example": 10000
                          },
                          "dailyCap": {
                            "type": "integer",
                            "example": 100000
                          }
                        }
                      },
                      "refundAmountMaxPerTx": {
                        "type": "integer",
                        "description": "Maximum refund amount per transaction",
                        "example": 5000
                      },
                      "refundAmountDailyCap": {
                        "type": "integer",
                        "description": "Daily cap for refund transactions",
                        "example": 50000
                      },
                      "approvalRequired": {
                        "type": "boolean",
                        "description": "Whether approval is required for transactions",
                        "example": false
                      }
                    }
                  },
                  "capabilities": {
                    "type": "array",
                    "description": "Agent capabilities (finance.* or wallet.* only)",
                    "items": {
                      "oneOf": [
                        {
                          "type": "string",
                          "description": "Capability ID",
                          "example": "finance.payment.charge"
                        },
                        {
                          "type": "object",
                          "properties": {
                            "id": {
                              "type": "string",
                              "description": "Capability ID",
                              "example": "finance.payment.payout"
                            },
                            "params": {
                              "type": "object",
                              "description": "Capability parameters"
                            }
                          }
                        }
                      ]
                    }
                  },
                  "regions": {
                    "type": "array",
                    "description": "Allowed regions for agent operations (ISO country codes)",
                    "items": {
                      "type": "string",
                      "pattern": "^[A-Z]{2}(-[A-Z]{2})?$",
                      "example": "US"
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Agent passport updated successfully",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "status": {
                      "type": "string",
                      "example": "success"
                    },
                    "data": {
                      "type": "object",
                      "properties": {
                        "passport": {
                          "type": "object",
                          "description": "Updated APort passport with new limits/capabilities/regions"
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "$ref": "#/components/responses/ValidationError"
          },
          "401": {
            "$ref": "#/components/responses/Unauthorized"
          },
          "404": {
            "$ref": "#/components/responses/NotFound"
          },
          "500": {
            "$ref": "#/components/responses/ServerError"
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "apiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-KEY"
      }
    },
    "responses": {
      "Unauthorized": {
        "description": "Access to this resource is not available for unauthenticated users.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/Unauthorized"
            }
          }
        }
      },
      "ServerError": {
        "description": "Indicates an internal server error.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ServerError"
            }
          }
        }
      },
      "ValidationError": {
        "description": "Validation error in the request.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/ValidationError"
            }
          }
        }
      },
      "NotFound": {
        "description": "The requested resource was not found.",
        "content": {
          "application/json": {
            "schema": {
              "$ref": "#/components/schemas/NotFound"
            }
          }
        }
      }
    },
    "schemas": {
      "Unauthorized": {
        "type": "object",
        "properties": {
          "status": {
            "type": "string",
            "description": "Status of the response.",
            "example": "error"
          },
          "error": {
            "type": "string",
            "description": "Error message indicating unauthorized access.",
            "example": "API key is not defined. Generate a new one from the developer portal."
          }
        }
      },
      "ServerError": {
        "type": "object",
        "properties": {
          "status": {
            "type": "string",
            "description": "Status of the error.",
            "example": "error"
          },
          "type": {
            "type": "string",
            "description": "Type of server error.",
            "example": "server error"
          },
          "code": {
            "type": "string",
            "description": "Specific error code for server issues.",
            "example": "INTERNAL_SERVER_ERROR"
          },
          "message": {
            "type": "string",
            "description": "Detailed message explaining the issue.",
            "example": "An internal server error occurred."
          }
        }
      },
      "ValidationError": {
        "type": "object",
        "properties": {
          "status": {
            "type": "string",
            "description": "Status of the validation error.",
            "example": "error"
          },
          "type": {
            "type": "string",
            "description": "Type of validation error.",
            "example": "Validation Error"
          },
          "code": {
            "type": "string",
            "description": "Error code indicating validation issue.",
            "example": "INVALID_REQUEST"
          },
          "message": {
            "type": "string",
            "description": "Detailed validation error message.",
            "example": "The request parameters are invalid."
          }
        }
      },
      "NotFound": {
        "type": "object",
        "properties": {
          "status": {
            "type": "string",
            "description": "Status of the error.",
            "example": "error"
          },
          "type": {
            "type": "string",
            "description": "Type of error indicating resource not found.",
            "example": "Resource Not Found"
          },
          "code": {
            "type": "string",
            "description": "Error code for resource not found.",
            "example": "NOT_FOUND"
          },
          "message": {
            "type": "string",
            "description": "Detailed message explaining the resource not found error.",
            "example": "The requested resource could not be found."
          }
        }
      }
    }
  },
  "tags": [
    {
      "name": "Agents",
      "description": "AI Agent wallet management endpoints"
    }
  ],
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "_id": {
    "buffer": {
      "0": 102,
      "1": 208,
      "2": 243,
      "3": 240,
      "4": 73,
      "5": 214,
      "6": 34,
      "7": 0,
      "8": 37,
      "9": 190,
      "10": 200,
      "11": 166
    }
  }
}
```