---
updatedAt: 2025-09-18T21:28:35.000Z
agentTools:
  projectIndex: https://developers.rdstation.com/llms.txt
---

# Atualizar campo personalizado

Atualizar campo personalizado.

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "[FIELDS] -> RD Station Marketing API",
    "version": "v2"
  },
  "servers": [
    {
      "url": "api.rd.services"
    }
  ],
  "components": {
    "securitySchemes": {
      "rdsmapi_auth": {
        "type": "http",
        "scheme": "bearer"
      }
    }
  },
  "paths": {
    "/platform/contacts/fields/{uuid}": {
      "patch": {
        "summary": "Atualizar campo personalizado",
        "tags": [
          "Campos personalizados"
        ],
        "description": "Atualizar campo personalizado.",
        "security": [
          {
            "rdsmapi_auth": [
              "write:fields",
              "read:fields"
            ]
          }
        ],
        "parameters": [
          {
            "name": "uuid",
            "in": "path",
            "description": "O uuid exclusivo associado a cada campo do RD Station.",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "example": {
                  "uuid": "fdeba6ec-f1cf-4b13-b2ea-e93d47c0d828",
                  "name": {
                    "pt-BR": "Meu campo customizado"
                  },
                  "label": {
                    "pt-BR": "Selecione uma das opções"
                  },
                  "api_identifier": "cf_my_custom_field",
                  "data_type": "STRING",
                  "presentation_type": "COMBO_BOX",
                  "validation_rules": {
                    "valid_options": [
                      {
                        "value": "opcao_1",
                        "label": {
                          "pt-BR": "opcao_1"
                        }
                      },
                      {
                        "value": "opcao_2",
                        "label": {
                          "pt-BR": "opcao_2"
                        }
                      }
                    ]
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "uuid": {
                      "type": "string",
                      "description": "O uuid associado a cada campo do RD Station"
                    },
                    "api_identifier": {
                      "type": "string",
                      "description": "Identificador exclusivo para referenciar este campo para chamadas de terminais do contato. O 'api identifier' de um campo não pode ser alterado posteriormente. Deve iniciar com o prefixo: cf_.",
                      "example": "name"
                    },
                    "custom_field": {
                      "type": "boolean",
                      "description": "Ele é definido como 'false' para campos padrão e 'true' para campos personalizados.",
                      "example": false
                    },
                    "data_type": {
                      "type": "string",
                      "description": "O tipo de dados do campo. Os valores possíveis são 'BOOLEAN', 'STRING', 'STRING[]' e 'INTEGER'.",
                      "example": "STRING"
                    },
                    "name": {
                      "type": "object",
                      "description": "Nome do campo no RD Station",
                      "properties": {
                        "default": {
                          "type": "string"
                        },
                        "pt-BR": {
                          "type": "string"
                        }
                      }
                    },
                    "label": {
                      "type": "object",
                      "description": "Label do campo nos formulários do RD Station",
                      "properties": {
                        "default": {
                          "type": "string"
                        },
                        "pt-BR": {
                          "type": "string"
                        }
                      }
                    },
                    "presentation_type": {
                      "type": "string",
                      "description": "O tipo do campo",
                      "enum": [
                        "TEXT_INPUT",
                        "EMAIL_INPUT",
                        "COMBO_BOX",
                        "URL_INPUT",
                        "TEXT_AREA",
                        "RADIO_BUTTON",
                        "PHONE_INPUT",
                        "NUMBER_INPUT",
                        "CHECK_BOX",
                        "MULTIPLE_CHOICE"
                      ],
                      "example": "TEXT_INPUT"
                    },
                    "validation_rules": {
                      "type": "object",
                      "description": "As regras de validação do campo.",
                      "properties": {
                        "valid_options": {
                          "type": "array",
                          "description": "Opções do campo",
                          "items": {
                            "type": "object",
                            "properties": {
                              "value": {
                                "type": "string"
                              },
                              "label": {
                                "type": "object",
                                "properties": {
                                  "pt-BR": {
                                    "type": "string"
                                  }
                                }
                              }
                            }
                          },
                          "example": [
                            {
                              "value": "opcao_1",
                              "label": {
                                "pt-BR": "opcao_1"
                              }
                            },
                            {
                              "value": "opcao_2",
                              "label": {
                                "pt-BR": "opcao_2"
                              }
                            }
                          ]
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "400": {
            "description": "Bad Request",
            "content": {
              "application/json": {
                "example": {
                  "errors": {
                    "name": {
                      "pt-BR": [
                        {
                          "error_type": "CANNOT_BE_BLANK",
                          "error_message": "can not be blank"
                        },
                        {
                          "error_type": "TAKEN",
                          "error_message": "is already in use"
                        },
                        {
                          "error_type": "EXCLUSION",
                          "error_message": "is already in use"
                        }
                      ]
                    },
                    "label": {
                      "pt-BR": [
                        {
                          "error_type": "CANNOT_BE_BLANK",
                          "error_message": "can not be blank"
                        },
                        {
                          "error_type": "TOO_LONG",
                          "error_message": "is too long (maximum 1000 characters)"
                        }
                      ]
                    },
                    "data_type": [
                      {
                        "error_type": "INVALID",
                        "error_message": "only supports [data_type] as data type"
                      }
                    ],
                    "validation_rules": {
                      "valid_options": [
                        {
                          "error_type": "TOO_SHORT",
                          "error_message": "must be fulfilled for the chosen field type"
                        },
                        {
                          "error_type": "INVALID",
                          "error_message": "has repeated items"
                        }
                      ]
                    }
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {
                    "errors": {
                      "type": "object",
                      "properties": {
                        "error_type": {
                          "type": "string"
                        },
                        "error_message": {
                          "type": "string"
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        },
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "data_type": {
                    "type": "string",
                    "description": "Tipo de dados para o qual o valor do campo deve ser formatado",
                    "enum": [
                      "STRING",
                      "INTEGER",
                      "BOOLEAN",
                      "STRING[]"
                    ]
                  },
                  "name": {
                    "type": "object",
                    "description": "Nome do campo no RD Station",
                    "properties": {
                      "pt-BR": {
                        "type": "string"
                      }
                    }
                  },
                  "label": {
                    "type": "object",
                    "description": "Label do campo nos formulários do RD Station",
                    "properties": {
                      "pt-BR": {
                        "type": "string"
                      }
                    }
                  },
                  "presentation_type": {
                    "type": "string",
                    "description": "O tipo do campo nos formulários",
                    "enum": [
                      "TEXT_INPUT",
                      "EMAIL_INPUT",
                      "COMBO_BOX",
                      "URL_INPUT",
                      "TEXT_AREA",
                      "RADIO_BUTTON",
                      "PHONE_INPUT",
                      "NUMBER_INPUT",
                      "CHECK_BOX",
                      "MULTIPLE_CHOICE"
                    ]
                  },
                  "validation_rules": {
                    "type": "object",
                    "properties": {
                      "valid_options": {
                        "type": "array",
                        "description": "Opções do campo",
                        "items": {
                          "type": "object",
                          "properties": {
                            "value": {
                              "type": "string"
                            },
                            "label": {
                              "type": "object",
                              "properties": {
                                "pt-BR": {
                                  "type": "string"
                                }
                              }
                            }
                          }
                        },
                        "example": [
                          {
                            "value": "opcao_1",
                            "label": {
                              "pt-BR": "opcao_1"
                            }
                          },
                          {
                            "value": "opcao_2",
                            "label": {
                              "pt-BR": "opcao_2"
                            }
                          }
                        ]
                      }
                    },
                    "description": "As regras de validação do campo."
                  }
                },
                "required": [
                  "data_type",
                  "label",
                  "name",
                  "presentation_type"
                ]
              }
            }
          }
        }
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}
```