Elimina una única Acción existente.
Las eliminaciones en Fluid no son permanentes. Las Acciones que se eliminan se marcan internamente como archivadas y, por lo general, ya no se incluyen como parte del conjunto de datos activos que se utiliza en Fluid.
Elimina una Acción
HTTP
DELETE https://organisation.fluid.work/rest/api/action/{id}
cURL
curl --user username:patToken --location --request DELETE 'http://organisation.fluid.work/rest/api/action/4360' \
--header 'Content-Type: application/json' \
}'
con parámetros opcionales
HTTP
DELETE https://organisation.fluid.work/rest/api/action/?fields={fields}&$expand={$expand}&version=3.0
cURL
curl --user username:patToken --location --request PUT 'http://organisation.fluid.work/rest/api/action/4360?fields=all&expand=all' \
--header 'Content-Type: application/json' \
}'
Respuesta
Código de estado: 200
JSON
{
"fields": {
"assignee": [
{
"id": 603,
"guid": "f1cb6467-0262-4539-9148-7b869defd817",
"name": "David Burt",
"userName": "david.burt",
"email": "dump18@fluidbsg.com"
}
],
"attachmentCount": 0,
"author": {
"id": 603,
"guid": "f1cb6467-0262-4539-9148-7b869defd817",
"name": "David Burt",
"userName": "david.burt",
"email": "dump18@fluidbsg.com"
},
"businessValue": 0,
"chatCount": 0,
"createDate": "2024-02-16T14:45:22.0000000",
"description": "Sample Description",
"dueDate": null,
"endDate": null,
"impediment": 0,
"isOwner": true,
"modifiedBy": {
"id": 603,
"guid": "f1cb6467-0262-4539-9148-7b869defd817",
"name": "David Burt",
"userName": "david.burt",
"email": "dump18@fluidbsg.com"
},
"modifiedDate": "2024-02-16T14:45:22.0000000",
"owners": [
{
"id": 603,
"guid": "f1cb6467-0262-4539-9148-7b869defd817",
"name": "David Burt",
"userName": "david.burt",
"email": "dump18@fluidbsg.com"
}
],
"priority": "Medium",
"principalGuid": "f1cb6467-0262-4539-9148-7b869defd817",
"ragStatus": "Green",
"startDate": null,
"status": "Not Started",
"statusCode": 4,
"taskType": "Task",
"title": "Sample Title"
},
"id": 4360,
"guid": "46522a95-7668-482a-a484-2952174b2430",
"url": "https://organisation.fluid.work/rest/api/action/4360"
}
Parámetros de URL
|
Nombre |
En |
Obligatorio |
Tipo |
Descripción |
|
fields |
query |
false |
string |
Lista separada por comas de los campos solicitados para devolver en la respuesta |
|
expand |
query |
false |
string |
Parámetro de expansión para los atributos de la Acción. Las opciones posibles son {"none" "all" "method" "related" "chat" "customAll" "customReportable" "customReadOnly" "subtask" "attachment" "state"} |
|
version |
query |
false |
string |
Versión de la API a utilizar. Si no se establece, se utilizará la versión más reciente de forma predeterminada. |
Respuesta
|
Nombre |
Tipo |
Descripción |
|
200 OK |
Action |
operación exitosa |
|
400 |
string |
Solicitud incorrecta |
|
401 |
string |
Usuario no autorizado, el nombre de usuario o el token no es válido |
|
403 |
string |
Prohibido, el usuario no tiene permisos para realizar esta operación en este contexto específico |
|
422 |
string |
Argumentos inválidos, los argumentos de la solicitud, la consulta o el cuerpo no son válidos |
|
429 |
string |
"Demasiadas solicitudes"; consulte los encabezados de respuesta RateLimit-Limit (capacidad actual del límite de tasa), RateLimit-Remaining (tokens restantes), RateLimit-Reset (tiempo hasta la próxima recarga) |
Encabezados de respuesta
|
Nombre |
Tipo |
Descripción |
|
RateLimit-Limit |
string |
Límite máximo de solicitudes permitidas |
|
RateLimit-Remaining |
string |
Capacidad restante de solicitudes permitidas |
|
RateLimit-Reset |
string |
Próxima fecha y hora para la renovación de la capacidad |
Definiciones
|
Nombre |
Descripción |
|
id |
El entero Id identifica de forma exclusiva a esta Acción en particular; puede intercambiarse con guid, vea a continuación |
|
guid |
La cadena guid identifica de forma exclusiva a esta Acción en particular; puede intercambiarse con id, vea arriba |
|
url |
La URL REST GET para esta Acción |
|
fields |
Mapa de campos y valores de la Acción |
|
Describe una lista de usuarios a los que se ha asignado esta acción |
|
|
Describe al usuario que creó esta Acción |
|
|
Describe al usuario que modificó esta Acción por última vez |
|
|
Describe una lista de usuarios que son propietarios de esta acción |
Assignee[]
|
Nombre |
Descripción |
|
id |
El entero Id identifica de forma exclusiva a este Usuario en particular; puede intercambiarse con guid, vea a continuación |
|
guid |
La cadena guid identifica de forma exclusiva a este Usuario en particular; puede intercambiarse con id, vea arriba |
|
name |
El nombre completo de este Usuario |
|
username |
El nombre de usuario asociado a este Usuario |
|
|
Correo electrónico único asociado a este Usuario |
Author
|
Nombre |
Descripción |
|
id |
El entero Id identifica de forma exclusiva a este Usuario en particular; puede intercambiarse con guid, vea a continuación |
|
guid |
La cadena guid identifica de forma exclusiva a este Usuario en particular; puede intercambiarse con id, vea arriba |
|
name |
El nombre completo de este Usuario |
|
username |
El nombre de usuario asociado a este Usuario |
|
|
Correo electrónico único asociado a este Usuario |
ModifiedBy
|
Nombre |
Descripción |
|
id |
El entero Id identifica de forma exclusiva a este Usuario en particular; puede intercambiarse con guid, vea a continuación |
|
guid |
La cadena guid identifica de forma exclusiva a este Usuario en particular; puede intercambiarse con id, vea arriba |
|
name |
El nombre completo de este Usuario |
|
username |
El nombre de usuario asociado a este Usuario |
|
|
Correo electrónico único asociado a este Usuario |
Owners[]
|
Nombre |
Descripción |
|
id |
El entero Id identifica de forma exclusiva a este Usuario en particular; puede intercambiarse con guid, vea a continuación |
|
guid |
La cadena guid identifica de forma exclusiva a este Usuario en particular; puede intercambiarse con id, vea arriba |
|
name |
El nombre completo de este Usuario |
|
username |
El nombre de usuario asociado a este Usuario |
|
|
Correo electrónico único asociado a este Usuario |
Expand
El parámetro de consulta "expand=all" expandirá todas las propiedades de respuesta posibles que se detallan a continuación y que están asociadas con esta entidad. "expand=none" para ocultar todas las propiedades de respuesta.
CustomProperties[]
|
Nombre |
Descripción |
|
guid |
La cadena guid identifica de forma exclusiva a esta propiedad personalizada en particular |
|
dataType |
El tipo de dato del valor de esta Propiedad Personalizada. p. ej., string, datetime, etc. |
|
isAdminLocked |
|
|
isCatalogType |
La Propiedad Personalizada es un Tipo de Catálogo y se utiliza como parte de la taxonomía |
|
isMultiple |
Puede contener múltiples valores |
|
isSubType |
|
|
key |
Clave de nombre único que identifica a esta Propiedad Personalizada por nombre |
|
required |
Indicador que señala que esta Propiedad Personalizada requiere un valor válido |
|
reportable |
Indicador que señala que esta Propiedad Personalizada es reportable |
|
readOnly |
Indicador que señala que el valor es de solo lectura y no se puede modificar |
|
value |
El valor de esta Propiedad Personalizada |
Methods[]
Propiedades devueltas para el conjunto de valores expandidos solicitado en el parámetro de consulta "expand=method"; los métodos son propiedades auxiliares de otros endpoints de la API de verbos REST que se pueden usar directamente.
|
Nombre |
Descripción |
|
type |
El tipo de acción que realiza este método |
|
httpMethod |
Verbo del método de solicitud HTTP |
|
url |
La URL REST que se puede usar con el verbo del método HTTP |
|
description |
Descripción de lo que realiza este método |
|
payload |
Payload de ejemplo relacionado con el verbo del método HTTP. Este payload suele ser el mínimo necesario para ejecutar el método del verbo. |
Related[]
Propiedades devueltas para el conjunto de valores expandidos solicitado en el parámetro de consulta "expand=related"; los relacionados son otras entidades que comparten una relación con esta entidad, que puede ser una relación de padre, hermano o hijo
|
Nombre |
Descripción |
|
Parent |
Elemento padre relacionado con esta Acción |
|
From |
Esta Acción se relacionó desde esta Entidad |
|
FollowOn[] |
Arreglo de entidades FollowOn relacionadas con esta Acción |
|
Children[] |
Arreglo de entidades secundarias relacionadas con esta Acción |
|
Project[] |
Arreglo de entidades de Proyecto relacionadas con esta Acción |
|
Catalog[] |
Arreglo de entidades de Catálogo relacionadas con esta Acción |
FollowOn[]
|
Nombre |
Descripción |
|
Id |
El entero Id identifica de forma exclusiva a esta Acción en particular; puede intercambiarse con guid, vea a continuación |
|
Guid |
La cadena guid identifica de forma exclusiva a esta Acción en particular; puede intercambiarse con id, vea arriba |
|
Title |
Título de esta Acción |
|
Name |
Nombre de esta Acción |
|
CreatedDate |
Marca de tiempo de creación de esta Acción |
|
ModifiedDate |
Marca de tiempo de la última modificación de esta Acción |
|
Type |
Tipo de esta Acción |
|
Status |
Estado de esta Acción |
|
Description |
Descripción de esta Acción |
|
PercentageComplete |
Porcentaje de esta Acción que se ha completado |
|
Methods[] |
Arreglo de métodos de la API REST que esta Acción puede ejecutar |
|
ExternalReference |
Si esta Acción tiene una referencia a una integración o sistema externo, el id de referencia externa se muestra aquí |
|
ReferenceId |
Identificador de referencia interno de Fluid |
|
Principal |
El contenedor principal de esta Acción |
|
AssignedTo |
Usuario al que se le ha asignado esta Acción |
|
RagStatus |
Estado RAG de esta Acción, si corresponde |
|
StartDate |
Marca de tiempo de inicio de esta Acción |
|
DueDate |
Marca de tiempo de vencimiento de esta Acción |
|
Owner |
Propietario de esta Acción |
|
Priority |
Prioridad de esta Acción |
|
ModifiedBy |
Usuario que modificó esta Acción por última vez |
|
ParentGuid |
Identificador guid padre de esta Acción |
|
AttachmentCount |
Número de adjuntos asociados a esta Acción |
|
ContentType |
El tipo de contenido de esta Acción |
Children[]
|
Nombre |
Descripción |
|
Id |
El entero Id identifica de forma exclusiva a esta Acción en particular; puede intercambiarse con guid, vea a continuación |
|
Guid |
La cadena guid identifica de forma exclusiva a esta Acción en particular; puede intercambiarse con id, vea arriba |
|
Title |
Título de esta Acción |
|
Name |
Nombre de esta Acción |
|
CreatedDate |
Marca de tiempo de creación de esta Acción |
|
ModifiedDate |
Marca de tiempo de la última modificación de esta Acción |
|
Type |
Tipo de esta Acción |
|
Status |
Estado de esta Acción |
|
Description |
Descripción de esta Acción |
|
PercentageComplete |
Porcentaje de esta Acción que se ha completado |
|
Methods[] |
Arreglo de métodos de la API REST que esta Acción puede ejecutar |
|
ExternalReference |
Si esta Acción tiene una referencia a una integración o sistema externo, el id de referencia externa se muestra aquí |
|
ReferenceId |
Identificador de referencia interno de Fluid |
|
Principal |
El contenedor principal de esta Acción |
|
AssignedTo |
Usuario al que se le ha asignado esta Acción |
|
RagStatus |
Estado RAG de esta Acción, si corresponde |
|
StartDate |
Marca de tiempo de inicio de esta Acción |
|
DueDate |
Marca de tiempo de vencimiento de esta Acción |
|
Owner |
Propietario de esta Acción |
|
Priority |
Prioridad de esta Acción |
|
ModifiedBy |
Usuario que modificó esta Acción por última vez |
|
ParentGuid |
Identificador guid padre de esta Acción |
|
AttachmentCount |
Número de adjuntos asociados a esta Acción |
|
ContentType |
El tipo de contenido de esta Acción |
Project[]
|
Nombre |
Descripción |
|
Id |
El entero Id identifica de forma exclusiva a este Proyecto en particular; puede intercambiarse con guid, vea a continuación |
|
Guid |
La cadena guid identifica de forma exclusiva a este Proyecto en particular; puede intercambiarse con id, vea arriba |
|
Category |
La Categoría a la que se alinea este Proyecto |
|
ProjectManager |
El usuario asignado como Project Manager de este Proyecto |
|
Description |
Descripción de este Proyecto |
|
ExternalReference |
Identificador de Referencia Externa para este Proyecto |
|
Name |
Nombre de este Proyecto |
|
Type |
Tipo de este Proyecto |
|
Status |
Estado de este Proyecto |
|
Owner |
Propietario de este Proyecto |
|
ParentGuid |
Identificador guid padre de esta Acción |
Catalog[]
|
Nombre |
Descripción |
|
Id |
El entero Id identifica de forma exclusiva a este Catálogo en particular; puede intercambiarse con guid, vea a continuación |
|
Guid |
La cadena guid identifica de forma exclusiva a esta Acción en particular; puede intercambiarse con id, vea arriba |
|
Name |
Nombre de este Catálogo |
|
ReferenceId |
Id de referencia de este Catálogo |
|
CatalogTypeGuid |
Guid único que representa el tipo al que pertenece este Catálogo |
Attachment[]
Propiedades devueltas para el conjunto de valores expandidos solicitado en el parámetro de consulta "expand=attachment". Propiedades de la Lista de verificación que se definen como parte de esta entidad.
|
Nombre |
Descripción |
|
Id |
El entero Id identifica de forma exclusiva a este Adjunto en particular |
|
Guid |
La cadena guid identifica de forma exclusiva a este Adjunto en particular |
|
Title |
Título de este Adjunto |
|
ModifiedDate |
Marca de tiempo de la última modificación de este Adjunto |
|
Type |
Tipo de este Adjunto |
|
Status |
Estado de este Adjunto |
|
Filename |
Nombre del archivo del adjunto |
|
Url |
URL para abrir, ver o descargar este Adjunto |
|
ModifiedBy |
Usuario que modificó este Adjunto por última vez |
Integration[]
Propiedades devueltas para el conjunto de valores expandidos solicitado en el parámetro de consulta "expand=integration", "expand=integration,related" o "expand=integration,related,subtask". Los detalles de integración definidos para esta entidad se pueden usar junto con "related" y/o "subtask" para mostrar los detalles de los elementos integrados relacionados y/o de las subtareas en la aplicación de terceros
|
Nombre |
Descripción |
|
Id |
El entero Id identifica de forma exclusiva a este elemento Integrado en particular; puede intercambiarse con guid, vea a continuación |
|
Guid |
La cadena guid identifica de forma exclusiva a este elemento Integrado en particular; puede intercambiarse con id, vea arriba |
|
Title |
Título de este elemento Integrado |
|
Name |
Nombre de este elemento Integrado |
|
CreatedDate |
Marca de tiempo de creación de este elemento Integrado |
|
ModifiedDate |
Marca de tiempo de la última modificación de este elemento Integrado |
|
Type |
Tipo de este elemento Integrado |
|
Status |
Nombre del estado de este elemento Integrado |
|
StatusCode |
Código de estado tal como se resuelve en los Estados de Fluid |
|
Description |
Descripción de este elemento Integrado |
|
PercentageComplete |
Porcentaje de este elemento Integrado que se ha completado |
|
ExternalReference |
El id de referencia externa único del sistema externo |
|
ReferenceId |
Identificador de referencia interno de Fluid |
|
Principal |
El contenedor principal de este elemento Integrado |
|
AssignedTo |
Usuario al que se le ha asignado este elemento Integrado |
|
StartDate |
Marca de tiempo de inicio de este elemento Integrado, si está asignado y existe |
|
DueDate |
Marca de tiempo de vencimiento de este elemento Integrado, si está asignado y existe |
|
EndDate |
Marca de tiempo de finalización de este elemento Integrado, si está asignado y existe |
|
Owner |
Propietario de este elemento Integrado |
|
Priority |
Prioridad de este elemento Integrado, si está asignada y existe |
|
ModifiedBy |
Usuario que modificó este elemento Integrado por última vez |
|
ParentGuid |
Identificador guid padre de este elemento Integrado |
|
AttachmentCount |
Número de adjuntos asociados a este elemento Integrado |
|
NotStartedCount |
Número total de subtareas de este elemento Integrado que están en estado No Iniciado (los estados No Iniciado se definen según la configuración de la integración) |
|
InProgressCount |
Número total de subtareas de este elemento Integrado que están en estado En progreso |
|
CompletedCount |
Número total de subtareas de este elemento Integrado que están en estado Completado |
|
NotStartedPercentage |
No iniciado como porcentaje (%) |
|
InProgressPercentage |
En progreso como porcentaje (%) |
|
CompletedPercentage |
Completado como porcentaje (%) |
|
Points |
Puntos asignados a este elemento, si está asignado y existen |
|
BusinessValue |
Valor de negocio asignado a este elemento, si está asignado y existe |
|
LastSync |
Marca de tiempo de la última sincronización de este elemento en Fluid |
|
ExternalStatus |
El estado de la sincronización/sistema externo. ( Válido / Inválido / Ausente / Confidencial) |
|
SubTasks[] |
Lista de Subtareas definidas para este elemento de integración externa (relación de descendencia hija) |
|
Linked[] |
Lista de elementos externos vinculados definidos para este elemento de integración (relación de hermano) |
|
CustomProperties[] |
Propiedades Personalizadas que se han asignado y definido según la configuración de la integración |
|
IsCompleted |
Verdadero si este elemento de integración está en estado Completado; Falso en caso contrario |
|
IsInProgress |
Verdadero si este elemento de integración está en estado En progreso; Falso en caso contrario |
|
IsNotStarted |
Verdadero si este elemento de integración está en estado No Iniciado; Falso en caso contrario |
SubTasks[]
Los elementos de integración de SubTareas son elementos que tienen una relación padre-hijo con el elemento Integrado actual. Son descendientes directos de este elemento de Integración.
|
Nombre |
Descripción |
|
Id |
El entero Id identifica de forma exclusiva a este elemento de subtarea externa en particular en el sistema externo |
|
Title |
Título del elemento de subtarea externa |
|
Status |
Nombre del estado del elemento de subtarea externa |
|
StatusCode |
Código de estado tal como se resuelve en los Estados de Fluid |
|
Description |
Descripción del elemento de subtarea externa |
|
PercentageComplete |
Qué porcentaje del elemento de subtarea externa se ha completado |
|
StartDate |
Marca de tiempo de inicio del elemento de subtarea externa, si está asignado y existe |
|
DueDate |
Marca de tiempo de vencimiento del elemento de subtarea externa, si está asignado y existe |
|
EndDate |
Marca de tiempo de finalización del elemento de subtarea externa, si está asignado y existe |
|
Priority |
Prioridad del elemento de subtarea externa, si está asignada y existe |
|
NotStartedCount |
Número total de subtareas del elemento de subtarea externa que están en estado No Iniciado (los estados No Iniciado se definen según la configuración de la integración) |
|
InProgressCount |
Número total de subtareas del elemento de subtarea externa que están en estado En progreso |
|
CompletedCount |
Número total de subtareas del elemento de subtarea externa que están en estado Completado |
|
NotStartedPercentage |
No iniciado como porcentaje (%) |
|
InProgressPercentage |
En progreso como porcentaje (%) |
|
CompletedPercentage |
Completado como porcentaje (%) |
|
Points |
Puntos asignados a este elemento de subtarea externa, si está asignado y existen |
|
BusinessValue |
Valor de negocio asignado a este elemento de subtarea externa, si está asignado y existe |
|
LastSync |
Marca de tiempo de la última sincronización de este elemento de subtarea externa en Fluid |
|
ExternalStatus |
El estado de la sincronización/sistema externo. ( Válido / Inválido / Ausente / Confidencial) |
|
IsCompleted |
Verdadero si este elemento de integración está en estado Completado; Falso en caso contrario |
|
IsInProgress |
Verdadero si este elemento de integración está en estado En progreso; Falso en caso contrario |
|
IsNotStarted |
Verdadero si este elemento de integración está en estado No Iniciado; Falso en caso contrario |
Linked[]
Los elementos de integración vinculados son elementos que tienen una relación de hermano con el elemento Integrado actual. Están relacionados mediante un vínculo, no mediante una relación padre-hijo.
|
Nombre |
Descripción |
|
Id |
El entero Id identifica de forma exclusiva a este elemento vinculado externo en particular en el sistema externo |
|
Title |
Título del elemento vinculado externo |
|
Status |
Nombre del estado del elemento vinculado externo |
|
StatusCode |
Código de estado tal como se resuelve en los Estados de Fluid |
|
Description |
Descripción del elemento vinculado externo |
|
PercentageComplete |
Qué porcentaje del elemento vinculado externo se ha completado |
|
StartDate |
Marca de tiempo de inicio del elemento vinculado externo, si está asignado y existe |
|
DueDate |
Marca de tiempo de vencimiento del elemento vinculado externo, si está asignado y existe |
|
EndDate |
Marca de tiempo de finalización del elemento vinculado externo, si está asignado y existe |
|
Priority |
Prioridad del elemento vinculado externo, si está asignada y existe |
|
NotStartedCount |
Número total de subtareas del elemento vinculado externo que están en estado No Iniciado (los estados No Iniciado se definen según la configuración de la integración) |
|
InProgressCount |
Número total de subtareas del elemento vinculado externo que están en estado En progreso |
|
CompletedCount |
Número total de subtareas del elemento vinculado externo que están en estado Completado |
|
NotStartedPercentage |
No iniciado como porcentaje (%) |
|
InProgressPercentage |
En progreso como porcentaje (%) |
|
CompletedPercentage |
Completado como porcentaje (%) |
|
Points |
Puntos asignados a este elemento de subtarea externa, si está asignado y existen |
|
BusinessValue |
Valor de negocio asignado a este elemento de subtarea externa, si está asignado y existe |
|
LastSync |
Marca de tiempo de la última sincronización de este elemento de subtarea externa en Fluid |
|
ExternalStatus |
El estado de la sincronización/sistema externo. ( Válido / Inválido / Ausente / Confidencial) |
|
IsCompleted |
Verdadero si este elemento de integración está en estado Completado; Falso en caso contrario |
|
IsInProgress |
Verdadero si este elemento de integración está en estado En progreso; Falso en caso contrario |
|
IsNotStarted |
Verdadero si este elemento de integración está en estado No Iniciado; Falso en caso contrario |
CustomProperties[]
|
Nombre |
Descripción |
|
Name |
Nombre de la Propiedad Personalizada según lo asignado en la configuración de la integración |
|
Value[] |
Lista de valor(es) para esta Propiedad Personalizada |
|
SyncMode |
El modo de sincronización de esta Propiedad Personalizada según la configuración de la integración |
Checklist[]
Propiedades devueltas para el conjunto de valores expandidos solicitado en el parámetro de consulta "expand=checklist". Propiedades de la Lista de verificación que se definen como parte de esta entidad.
|
Nombre |
Descripción |
|
Title |
El título del elemento de la lista de verificación |
|
Status |
El estado del elemento de la lista de verificación (true/false) es (marcado/sin marcar) |
Chat[]
Propiedades devueltas para el conjunto de valores expandidos solicitado en el parámetro de consulta "expand=chat"; el chat consiste en comentarios/conversaciones asociados a esta entidad
|
Nombre |
Descripción |
|
Id |
Id único que representa este mensaje de chat |
|
Content |
Representación solo de texto del contenido del mensaje de chat |
|
TopicId |
El Id del tema/sala de chat en el que se publicó este mensaje de chat |
|
Display |
Versión HTML del contenido que se muestra al usuario |
|
Initiator |
El usuario que publicó este mensaje de chat |
|
Timestamp |
La marca de tiempo de cuando se publicó este mensaje de chat |
|
Title |
El título de la sala de chat en la que se publicó este mensaje de chat |
Lectura adicional