GitScrum / Docs

Attachment Added

Webhook payload reference for the attachments.issues.store event, triggered when a file is attached to a task.

Triggered when a file is attached to a task.

  • Event: attachments.issues.store
  • Category: Tasks
  • Triggers: Uploading a file to a task in the task details panel

Payload

The payload contains the full attachment resource via 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
  }
}

Field Reference

FieldTypeDescription
idintegerAttachment ID
uuidstringAttachment UUID
resource.typestringParent resource type ("task")
resource.uuidstringParent task UUID
descriptionstring or nullAttachment description
download.urlstringSigned S3 download URL (temporary)
download.internalstringInternal GitScrum download URL
download.expirationstringURL expiration datetime
filenamestringOriginal filename
mimetypestringMIME type
sizeintegerFile size in bytes
folder_idinteger or nullFolder ID (if organized in folders)
folderobject or nullFolder details: id, uuid, name, path
showincarouselbooleanWhether the attachment shows in the image carousel
userobjectUser who uploaded the file
commentsinteger or nullNumber of comments on the attachment
projectobjectProject details
created_atobjectUpload timestamp

Notes

  • The download.url is a signed S3 URL with an expiration time. It may expire before your system processes it.
  • Use download.internal for a more stable download URL.
  • The size field is in bytes.

Related