> For the complete documentation index, see [llms.txt](https://docs.shortcutco.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.shortcutco.com/developers/api-reference/reference/objects/attachment.md).

# The attachment object

The attachment object in the Shortcut API - every field, an example, and the endpoints that return it.

A photo, video, or file on a customer's profile.

## Fields

| Field                  | Type                                                           | Description                                                                                                                                                        |
| ---------------------- | -------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `id`                   | id                                                             | The attachment's id. Pass it to `GET /v1/attachments/{id}` for a fresh link.                                                                                       |
| `object`               | `"attachment"`                                                 | Always `attachment`.                                                                                                                                               |
| `source`               | `activity_post`, `visit`, `estimate`, `inbox_email`, `project` | Where the file lives: a post on the activity feed, a visit (crew photos and videos), an estimate, an email in the Inbox (`inbox_email`), or a project (`project`). |
| `type`                 | `photo`, `video`, `file`                                       | Photo, video, or any other file.                                                                                                                                   |
| `filename`             | string                                                         | The file's name as uploaded.                                                                                                                                       |
| `mimeType`             | string                                                         | The file's media type, e.g. `image/jpeg`.                                                                                                                          |
| `sizeBytes`            | integer                                                        | The file's size in bytes.                                                                                                                                          |
| `durationSeconds`      | integer or null                                                | A video's length in seconds; null otherwise.                                                                                                                       |
| `createdAt`            | timestamp                                                      | When the file was added, ISO 8601 in UTC.                                                                                                                          |
| `downloadUrl`          | string                                                         | A link that downloads the file without a token. It works for 5 minutes and opens only this file; get the attachment again for a new one.                           |
| `downloadUrlExpiresAt` | timestamp                                                      | When `downloadUrl` stops working, ISO 8601 in UTC.                                                                                                                 |

## Example

```json
{
  "id": "37f511f4-343f-4d3b-8089-88822cd3c3c9",
  "object": "attachment",
  "source": "activity_post",
  "type": "photo",
  "filename": "Example filename",
  "mimeType": "Example mimeType",
  "sizeBytes": 1,
  "durationSeconds": 1,
  "createdAt": "2026-10-16T17:04:12.381Z",
  "downloadUrl": "https://example.com/shortcut/webhooks",
  "downloadUrlExpiresAt": "2026-10-16T17:04:12.381Z"
}
```

## Endpoints

| Endpoint                   | What it does      |
| -------------------------- | ----------------- |
| `GET /v1/attachments/{id}` | Get an attachment |
