---
updatedAt: 2026-07-31T14:07:50.000Z
agentTools:
  projectIndex: https://reference.fidel.uk/llms.txt
---

# Update Card Metadata

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "fidel-api",
    "version": "1"
  },
  "servers": [
    {
      "url": "https://api.fidel.uk/v1"
    }
  ],
  "components": {
    "securitySchemes": {
      "sec0": {
        "type": "apiKey",
        "in": "header",
        "name": "Fidel-Key"
      }
    }
  },
  "security": [
    {
      "sec0": []
    }
  ],
  "paths": {
    "/cards/{cardId}/metadata": {
      "put": {
        "summary": "Update Card Metadata",
        "description": "",
        "operationId": "update-card-metadata",
        "parameters": [
          {
            "name": "Content-Type",
            "in": "header",
            "description": "application/json",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "Fidel-Key",
            "in": "header",
            "description": "test/live API *secret* key.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "cardId",
            "in": "path",
            "description": "The identifier of the card of which you want to update the metadata.",
            "schema": {
              "type": "string"
            },
            "required": true
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "RAW_BODY"
                ],
                "properties": {
                  "RAW_BODY": {
                    "type": "string",
                    "description": "Raw json to be set on the metadata field. Send \"{}\" to clear it",
                    "format": "json"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "\n {\n    \"items\": [\n        {\n            \"metadata\": {\n                \"customKey\": \"customValue\"\n            }\n        }\n    ],\n    \"status\": 200,\n    \"execution\": 880.365708,\n    \"resource\": \"/v1/cards/d35e2001-ecfc-4b49-84f4-a5012edf8a9b/metadata\"\n}\n"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "items": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "metadata": {
                            "type": "object",
                            "properties": {
                              "customKey": {
                                "type": "string",
                                "example": "customValue"
                              }
                            }
                          }
                        }
                      }
                    },
                    "status": {
                      "type": "integer",
                      "example": 200,
                      "default": 0
                    },
                    "execution": {
                      "type": "number",
                      "example": 880.365708,
                      "default": 0
                    },
                    "resource": {
                      "type": "string",
                      "example": "/v1/cards/d35e2001-ecfc-4b49-84f4-a5012edf8a9b/metadata"
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n    \"error\": {\n        \"code\": \"invalid-card-metadata\",\n        \"date\": \"2022-09-16T09:33:23.238Z\",\n        \"message\": \"The Metadata provided is invalid\"\n    },\n    \"status\": 400,\n    \"execution\": 687.7115,\n    \"resource\": \"/v1/cards/d35e2001-ecfc-4b49-84f4-a5012edf8a9b/metadata\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string",
                          "example": "invalid-card-metadata"
                        },
                        "date": {
                          "type": "string",
                          "example": "2022-09-16T09:33:23.238Z"
                        },
                        "message": {
                          "type": "string",
                          "example": "The Metadata provided is invalid"
                        }
                      }
                    },
                    "status": {
                      "type": "integer",
                      "example": 400,
                      "default": 0
                    },
                    "execution": {
                      "type": "number",
                      "example": 687.7115,
                      "default": 0
                    },
                    "resource": {
                      "type": "string",
                      "example": "/v1/cards/d35e2001-ecfc-4b49-84f4-a5012edf8a9b/metadata"
                    }
                  }
                }
              }
            }
          },
          "401": {
            "description": "401",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n\t\"resource\": \"/v1/programs/b4b6d68f-a05a-4cc5-8b9f-f6e82cd988d0/cards\",\n\t\"status\": 401,\n\t\"error\": {\n\t\t\"code\": \"credential\",\n\t\t\"date\": \"2020-08-27T11:10:59.964Z\",\n\t\t\"message\": \"Credential is not authorized\"\n\t},\n\t\"execution\": 5.804783\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "resource": {
                      "type": "string",
                      "example": "/v1/programs/b4b6d68f-a05a-4cc5-8b9f-f6e82cd988d0/cards"
                    },
                    "status": {
                      "type": "integer",
                      "example": 401,
                      "default": 0
                    },
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string",
                          "example": "credential"
                        },
                        "date": {
                          "type": "string",
                          "example": "2020-08-27T11:10:59.964Z"
                        },
                        "message": {
                          "type": "string",
                          "example": "Credential is not authorized"
                        }
                      }
                    },
                    "execution": {
                      "type": "number",
                      "example": 5.804783,
                      "default": 0
                    }
                  }
                }
              }
            }
          },
          "404": {
            "description": "404",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{\n    \"error\": {\n        \"code\": \"card-not-found\",\n        \"date\": \"2022-09-16T09:34:37.712Z\",\n        \"message\": \"Card id not found\"\n    },\n    \"status\": 404,\n    \"execution\": 709.534375,\n    \"resource\": \"/v1d/cards/d35e2001-ecfc-4b49-84f4-a5012edf8a9c/metadata\"\n}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "error": {
                      "type": "object",
                      "properties": {
                        "code": {
                          "type": "string",
                          "example": "card-not-found"
                        },
                        "date": {
                          "type": "string",
                          "example": "2022-09-16T09:34:37.712Z"
                        },
                        "message": {
                          "type": "string",
                          "example": "Card id not found"
                        }
                      }
                    },
                    "status": {
                      "type": "integer",
                      "example": 404,
                      "default": 0
                    },
                    "execution": {
                      "type": "number",
                      "example": 709.534375,
                      "default": 0
                    },
                    "resource": {
                      "type": "string",
                      "example": "/v1d/cards/d35e2001-ecfc-4b49-84f4-a5012edf8a9c/metadata"
                    }
                  }
                }
              }
            }
          }
        },
        "deprecated": false,
        "x-readme": {
          "code-samples": [
            {
              "language": "curl",
              "code": "curl -X PUT \\\n  https://api.fidel.uk/v1/cards/f76ed1be-e434-480b-aa1d-ff48f548f62a/metadata \\\n  -H 'Content-Type: application/json' \\\n  -H 'Fidel-Key: sk_test_62f02030-0409-4eb5-ab94-6eff05b3d888' \\\n  -d '{\n      \"customKey1\": \"customValue1\",\n      \"customKey2\": \"customValue2\"\n}'"
            }
          ],
          "samples-languages": [
            "curl"
          ]
        }
      }
    }
  },
  "x-readme": {
    "headers": [
      {
        "key": "Content-Type",
        "value": "application/json"
      }
    ],
    "explorer-enabled": false,
    "proxy-enabled": true
  },
  "x-readme-fauxas": true
}
```