Actualiza el estado de un registro de una aplicación, que se estableció con Gestión de procesos. Para obtener más información, consulte el siguiente artículo:
Configuración de la gestión de procesos

Para la autenticación con contraseña, el usuario debe tener permiso para ver el registro. Además, se debe cumplir una de las siguientes condiciones:

1. El usuario es el cesionario del registro
2. No hay personas asignadas establecidas para el registro

Para la autenticación del token de API, el token de API debe tener permiso para ver el registro. Además, se debe cumplir una de las siguientes condiciones:

1. El usuario "Administrador" es el Cesionario del registro
2. No hay personas asignadas establecidas para el registro

PARÁMETRO	VALOR	OBLIGATORIO	DESCRIPCIÓN
action	Cuerda	Sí	El nombre de la acción que se va a ejecutar. Si la función de localización se ha utilizado para aplicar varias traducciones del nombre de la acción, especifique el nombre de la acción en la configuración de idioma del usuario que ejecutará la API. Los tokens de API siguen la configuración de idioma establecida en la configuración de Administración de usuarios y sistemas. Para obtener más información, consulte el siguiente artículo: Configuración del idioma del sistema
app	Integer	Sí	El identificador de la aplicación.
assignee	Cuerda	Requerido condicionalmente	El siguiente cesionario. Especifique el nombre de inicio de sesión de la persona asignada. Obligatorio, si el "Lista de personas asignadas" del estado actual se establece en "El usuario elige una persona asignada de la lista para realizar la acción", y existe un cesionario seleccionable.
id	Integer	Sí	El identificador de registro.
revision	Integer	Opcional	El número de revisión del registro antes de actualizar el estado. Si la revisión especificada no es la última, la solicitud producirá un error. La revisión no se comprobará si se ignora este parámetro o si se especifica -1.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14

var body = {
  'app': 1,
  'id': 3,
  'action': 'Start',
  'assignee': 'Krispy',
};

kintone.api(kintone.api.url('/k/v1/record/status.json', true), 'PUT', body, function(resp) {
  // success
  console.log(resp);
}, function(error) {
  // error
  console.log(error);
});

1
2
3
4
5
6
7
8
9

curl -X PUT 'https://{subdomain}.kintone.com/k/v1/record/status.json' \
-H 'X-Cybozu-API-Token: L08xCvTh7A1EVm3rZimF98R8VLP3k4lMlzELqyCx' \
-H 'Content-Type: application/json' \
-d '{
  "app": 1,
  "id": 3,
  "action": "start",
  "assignee": "Krispy"
}'

1
2
3

{
  "revision": "3"
}

• Esta API solo se puede usar con aplicaciones que tengan habilitada la función Administración de procesos.