---
title: "Actualizar elemento"
url: https://docs.catalyst.zoho.com/es/api/code-reference/cloud-scale/nosql/update-item/
description: "Esta API te permite actualizar un elemento en una tabla NoSQL."
last_updated: 2026-03-20T16:21:56Z
service: Cloud Scale
type: api
---

# Actualizar elemento

### Descripción

Esta API te permite actualizar un elemento de los datos existentes en una tabla [NoSQL](https://docs.catalyst.zoho.com/es/cloud-scale/help/nosql/introduction/) en tu proyecto. La tabla se referencia por su ID único o nombre.

Puedes pasar los atributos a actualizar con o sin especificar condiciones en el [formato JSON personalizado](https://docs.catalyst.zoho.com/es/cloud-scale/help/nosql/working-with-data/introduction/#the-catalyst-custom-json-format).

### Detalles de la solicitud

#### URL de solicitud

`PUT` {api-domain}/baas/v1/project/{{project_id}}/nosqltable/{{table_identifier}}/item

- **api-domain** (URL): El dominio específico del DC para acceder a Catalyst API

- **project_id** (Numerical): El [ID único](https://docs.catalyst.zoho.com/es/getting-started/set-up-a-catalyst-project/general-settings/) del proyecto

- **table_identifier** (Numerical): El [ID único](https://docs.catalyst.zoho.com/es/cloud-scale/help/nosql/create-manage-tables/) de la tabla o nombre de la tabla

#### Encabezados de solicitud
 **Authorization:** Zoho-oauthtoken {oauth_token} 

 **Content-Type:** application/json 

**Encabezados opcionales** 

 **CATALYST-ORG:** {org_id}

 **Environment:** Development

#### Scope

ZohoCatalyst.nosql.item.UPDATE

> **Nota:** Esta operación también puede ejecutarse con permisos de autenticación de usuario de Catalyst usando los SDKs de Catalyst. Consulta la [sección de Prerrequisitos de la API de Catalyst](https://docs.catalyst.zoho.com/es/api/introduction/overview-and-prerequisites/#prerequisites) para más detalles.

### Propiedades JSON de la solicitud

- **keys** (json, mandatory): Indica la [partition key](https://docs.catalyst.zoho.com/es/cloud-scale/help/nosql/components/#table-keys) y la sort key de la tabla.  

- **update_attributes** (json, mandatory):  Indica el atributo a actualizar junto con su valor. La actualización puede ser de dos tipos: PUT (para agregar un nuevo atributo dentro del elemento) y DELETE (para eliminar un atributo del elemento). El `attribute_path` indica la ruta dentro del elemento donde se debe realizar la operación real. El valor a actualizar puede ser de dos tipos:

- 
- **update_value** (json, mandatory): El valor real a actualizar. 

- 
- **update_function** (json, optional):  Hay cuatro funciones que pueden usarse: 
 `if_not_exists` - Verifica la existencia del atributo y declara un valor si no está presente.
`append_list` - Agrega datos a una lista
`add` - Agrega un valor junto con el valor existente o agrega un elemento en un conjunto
`reduction` - Resta un valor del valor existente o elimina un elemento en un conjunto. 

- **condition** (json, optional):  Los datos existentes de la tabla se obtienen y evalúan contra esta condición. Los elementos se insertan solo si la evaluación es verdadera. Si no hay datos existentes, las condiciones se ignoran y los elementos se insertan. Hay tres formas de inicializar una condición:

- 
- **functions** (json, mandatory (if specifying condition)):  Las dos funciones integradas son: `attribute_exist`, que puede usarse para verificar la presencia de un atributo, y `attribute_type`, que puede usarse para verificar si el nombre de atributo dado pertenece al tipo dado. 

- 
- **operator, attribute, value** (json, optional):  Para realizar operaciones de comparación directa. Operadores soportados: `contains`, `not_contains`, `begins_with`, `ends_with`, `in`, `not_in`, `between`, `not_between`, `equals`, `not_equals`, `greater_than`, `less_than`, `greater_equal`, `less_equal`.  

- 
- **group, group operator** (json, optional): Para combinar dos o más condiciones. Operadores de grupo soportados: `and`, `or`.   

- 
- **negate** (json, optional): Para negar el resultado de las condiciones.    

### Detalles de la respuesta

La respuesta devolverá el estado de la operación de inserción, así como los detalles del elemento actualizado como el `table_name`, `partition_key` y `sort_key`, si están configurados.

**Sample Request**

```bash
curl -X PUT \
https://api.catalyst.zoho.com/baas/v1/project/4000000006007/nosqltable/3376000003171728/item \
-H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57" \
-H "Content-Type:application/json" \
-d '{
	keys:{
		partition_key:{
			"S":"Country"
		},
		sort_key:{
			"N":"EmpID"
		},
	}
	update_attributes:{
	"item": {
 	"EmpID": {
  	"N": "10999"
  	},
 	"FirstName":{
  	"S": "Paul"
  	},
 	"LastName":{
  	"S": "Smith"
  	},
 	"PriorExperience":{
  	"BOOL": false
  	},
 	"Location": {
  	"M": {
   	"Country": {
    	"S": "USA"
   	},
   	"City": {
    	"S": "New York"
    	}
   	}
  	}
	}
}
    }'

```

**Sample Response**

```json

    {
    "status": "success",
    "data": {
        "table_name": "employeeDetails",
        "project_details": {
            "id": 4000000006007,
            "project_name": "EmpDatabase",
            "project_type": "Live"
        }
    }
    }
    
```

### SDK Documentation

[Update Items- Java SDK](https://docs.catalyst.zoho.com/es/sdk/java/v1/cloud-scale/nosql/update-items/)</br></br>
[Update Items- Node.js SDK](https://docs.catalyst.zoho.com/es/sdk/nodejs/v2/cloud-scale/nosql/update-items/)</br></br>
[Update Items- Python SDK](https://docs.catalyst.zoho.com/es/sdk/python/v1/cloud-scale/nosql/update-items/)
</br></br>