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

# Update Secure Settings

Use this API to update the security settings attached to a card. These include the mobile number and PIN of the card.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "Core API",
    "version": "1.0"
  },
  "servers": [
    {
      "url": "https://api.useoval.com"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "name": "Authorization",
        "in": "header",
        "x-bearer-format": "bearer"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/card/{card_id}/secure_settings": {
      "patch": {
        "summary": "Update Secure Settings",
        "description": "Use this API to update the security settings attached to a card. These include the mobile number and PIN of the card.",
        "operationId": "update-secure-settings",
        "parameters": [
          {
            "name": "card_id",
            "in": "path",
            "schema": {
              "type": "string"
            },
            "required": true
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "mobile": {
                    "type": "string",
                    "description": "Kindly provide the full phone number complete with the country prefix e.g. +11234567890"
                  },
                  "pin": {
                    "type": "string",
                    "description": "The PIN is an 8-digit code used for authentication purposes. It is recommended that the PIN should only numeric characters (0-9)."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n    \"data\": {\n        \"id\": \"7d4412218a4a11efb8d20edcd86e5ab3\",\n        \"holder_id\": \"72b84d0399a311ee9e6f0edcd86e5ab3\",\n        \"holder_type\": \"business\",\n        \"balance\": 1000,\n        \"currency\": \"USD\",\n        \"brand\": \"visa\",\n        \"label\": \"EU Live Test Card\",\n        \"cardholder_name\": \"UMBRELLA CORPORATION\",\n        \"number_masked\": \"474362******9870\",\n        \"number\": \"941bbe442a6cc6909bf328717768d8f3\",\n        \"exp_month\": \"10\",\n        \"exp_year\": \"2027\",\n        \"cvv\": \"c4a036f2db7f62da9303943cbf07e9da\",\n        \"pin\": \"5512f498e2c3d98228f4527c9667f7cc\",\n        \"billing_address\": {\n            \"line1\": \"2631 Plantation Hollow CT\",\n            \"line2\": null,\n            \"city\": \"Missouri\",\n            \"state\": \"TX\",\n            \"country\": \"US\",\n            \"postal_code\": \"77459\"\n        },\n        \"platform_managed\": true,\n        \"migration_meta\": {\n            \"previous\": null,\n            \"next\": null,\n            \"balance_brought\": null,\n            \"balance_carried\": null,\n            \"balance_refunded\": null\n        },\n        \"is_deleted\": false,\n        \"status\": \"active\",\n        \"created_at\": \"2024-10-14T16:36:40Z\",\n        \"updated_at\": \"2024-10-16T01:05:05Z\"\n    },\n    \"message\": \"Card secure settings updated successfully\",\n    \"meta\": null,\n    \"status\": \"success\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "data": {
                      "type": "object",
                      "properties": {
                        "id": {
                          "type": "string",
                          "example": "7d4412218a4a11efb8d20edcd86e5ab3"
                        },
                        "holder_id": {
                          "type": "string",
                          "example": "72b84d0399a311ee9e6f0edcd86e5ab3"
                        },
                        "holder_type": {
                          "type": "string",
                          "example": "business"
                        },
                        "balance": {
                          "type": "integer",
                          "example": 1000,
                          "default": 0
                        },
                        "currency": {
                          "type": "string",
                          "example": "USD"
                        },
                        "brand": {
                          "type": "string",
                          "example": "visa"
                        },
                        "label": {
                          "type": "string",
                          "example": "EU Live Test Card"
                        },
                        "cardholder_name": {
                          "type": "string",
                          "example": "UMBRELLA CORPORATION"
                        },
                        "number_masked": {
                          "type": "string",
                          "example": "474362******9870"
                        },
                        "number": {
                          "type": "string",
                          "example": "941bbe442a6cc6909bf328717768d8f3"
                        },
                        "exp_month": {
                          "type": "string",
                          "example": "10"
                        },
                        "exp_year": {
                          "type": "string",
                          "example": "2027"
                        },
                        "cvv": {
                          "type": "string",
                          "example": "c4a036f2db7f62da9303943cbf07e9da"
                        },
                        "pin": {
                          "type": "string",
                          "example": "5512f498e2c3d98228f4527c9667f7cc"
                        },
                        "billing_address": {
                          "type": "object",
                          "properties": {
                            "line1": {
                              "type": "string",
                              "example": "2631 Plantation Hollow CT"
                            },
                            "line2": {},
                            "city": {
                              "type": "string",
                              "example": "Missouri"
                            },
                            "state": {
                              "type": "string",
                              "example": "TX"
                            },
                            "country": {
                              "type": "string",
                              "example": "US"
                            },
                            "postal_code": {
                              "type": "string",
                              "example": "77459"
                            }
                          }
                        },
                        "platform_managed": {
                          "type": "boolean",
                          "example": true,
                          "default": true
                        },
                        "migration_meta": {
                          "type": "object",
                          "properties": {
                            "previous": {},
                            "next": {},
                            "balance_brought": {},
                            "balance_carried": {},
                            "balance_refunded": {}
                          }
                        },
                        "is_deleted": {
                          "type": "boolean",
                          "example": false,
                          "default": true
                        },
                        "status": {
                          "type": "string",
                          "example": "active"
                        },
                        "created_at": {
                          "type": "string",
                          "example": "2024-10-14T16:36:40Z"
                        },
                        "updated_at": {
                          "type": "string",
                          "example": "2024-10-16T01:05:05Z"
                        }
                      }
                    },
                    "message": {
                      "type": "string",
                      "example": "Card secure settings updated successfully"
                    },
                    "meta": {},
                    "status": {
                      "type": "string",
                      "example": "success"
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true,
  "_id": "637d9e0aeb8873003ad62eac:670f12d13a6e84000f51a6e4"
}
```