GitScrum / Docs

Adjunto Agregado

Referencia de payload del webhook para el evento attachments.issues.store, disparado cuando se adjunta un archivo a una tarea.

Disparado cuando se adjunta un archivo a una tarea.

  • Evento: attachments.issues.store
  • Categoría: Tareas
  • Gatillos: Subir un archivo a una tarea en el panel de detalles de la tarea

Payload

El payload contiene el recurso completo de adjunto vía AttachmentResource:

{
  "id": 789,
  "uuid": "attachment-uuid-789",
  "resource": {
    "type": "task",
    "uuid": "abc123-def456-ghi789"
  },
  "description": null,
  "download": {
    "url": "https://s3.amazonaws.com/bucket/file.pdf?signed=...",
    "internal": "https://services.gitscrum.com/attachments/attachment-uuid-789",
    "expiration": "2026-02-06T15:30:00+00:00"
  },
  "filename": "design-spec.pdf",
  "mimetype": "application/pdf",
  "size": 245760,
  "folder_id": null,
  "folder": null,
  "show_in_carousel": false,
  "is_mine": true,
  "user": {
    "id": 1,
    "uuid": "user-uuid-123",
    "name": "Jane Smith",
    "username": "janesmith",
    "avatar": "https://avatar.url/jane.jpg",
    "headline": "Lead Developer",
    "location": "Porto, Portugal",
    "timezone_name": "Europe/Lisbon",
    "language": "en",
    "created_at": {
      "date_for_humans": "1 year ago",
      "iso8601": "2025-01-15T10:00:00+00:00",
      "timestamp": 1736935200
    }
  },
  "task": null,
  "comments": 0,
  "project": {
    "slug": "web-platform",
    "name": "Web Platform",
    "logo": "https://logo.url/project.png",
    "visibility": {
      "is_private": 1,
      "title": "Private"
    },
    "recurring": true,
    "owner": { ... }
  },
  "created_at": {
    "date_for_humans": "Just now",
    "iso8601": "2026-02-06T14:30:00+00:00",
    "timestamp": 1738852200
  }
}

Referencia de Campos

CampoTipoDescripción
idintegerID del adjunto
uuidstringUUID del adjunto
resource.typestringTipo de recurso padre ("task")
resource.uuidstringUUID de la tarea padre
descriptionstring o nullDescripción del adjunto
download.urlstringURL de descarga S3 firmada (temporal)
download.internalstringURL de descarga interna de GitScrum
download.expirationstringFecha y hora de expiración de la URL
filenamestringNombre de archivo original
mimetypestringTipo MIME
sizeintegerTamaño del archivo en bytes
folder_idinteger o nullID de carpeta (si está organizado en carpetas)
folderobject o nullDetalles de carpeta: id, uuid, name, path
showincarouselbooleanSi el adjunto se muestra en el carrusel de imágenes
userobjectUsuario que subió el archivo
commentsinteger o nullNúmero de comentarios en el adjunto
projectobjectDetalles del proyecto
created_atobjectMarca de tiempo de subida

Notas

  • La download.url es una URL S3 firmada con tiempo de expiración. Puede expirar antes de que tu sistema la procese.
  • Usa download.internal para una URL de descarga más estable.
  • El campo size está en bytes.

Relacionado