API Documentation

API Endpoint

Attachments

Attachments

The attachment object represents files such as images, PDFs and documents that can be assigned to other objects. These include, but are not limited, to tasks, comments, expenses and purchase orders. With attachments, users can provide relevant information, resources and additional context for related objects.

You can find more about attachments in our Help documentation: Working with attachments

For more details on how to work with attachment files through our API please refer to Working with attachments guide.

Supported filter params

  • comment_id (array)

  • page_id (array)

  • task_id (array)

GET /api/v2/attachments
Requestsreturns attachments

GET  /api/v2/attachments?filter[comment_id]=3

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": [
    {
      "id": "1",
      "type": "attachments",
      "attributes": {
        "name": "img.png",
        "content_type": "image/png",
        "size": 3479,
        "url": "https://files-test.productive.io/attachments/files/000/000/001/original/img.png?1759536172",
        "thumb": "https://files-test.productive.io/attachments/files/000/000/001/thumb/img.png?1759536172",
        "temp_url": "https://files-test.productive.io/attachments/files/000/000/001/original/img.png?1759536172",
        "resized": false,
        "created_at": "2025-10-04T02:02:52.348+02:00",
        "deleted_at": null,
        "attachment_type": null,
        "message_id": null,
        "external_id": null,
        "attachable_type": "comment"
      },
      "relationships": {
        "organization": {
          "data": {
            "type": "organizations",
            "id": "12"
          }
        },
        "creator": {
          "meta": {
            "included": false
          }
        },
        "invoice": {
          "meta": {
            "included": false
          }
        },
        "purchase_order": {
          "meta": {
            "included": false
          }
        },
        "bill": {
          "meta": {
            "included": false
          }
        },
        "email": {
          "meta": {
            "included": false
          }
        },
        "page": {
          "meta": {
            "included": false
          }
        },
        "expense": {
          "meta": {
            "included": false
          }
        },
        "comment": {
          "meta": {
            "included": false
          }
        },
        "task": {
          "meta": {
            "included": false
          }
        },
        "document_style": {
          "meta": {
            "included": false
          }
        },
        "document_type": {
          "meta": {
            "included": false
          }
        },
        "deal": {
          "meta": {
            "included": false
          }
        }
      }
    }
  ],
  "links": {
    "first": "http://api-test.productive.io/api/v2/attachments?filter%5Bcomment_id%5D=3&page%5Bnumber%5D=1&page%5Bsize%5D=30",
    "last": "http://api-test.productive.io/api/v2/attachments?filter%5Bcomment_id%5D=3&page%5Bnumber%5D=1&page%5Bsize%5D=30"
  },
  "meta": {
    "current_page": 1,
    "total_pages": 1,
    "total_count": 1,
    "page_size": 30,
    "max_page_size": 200
  }
}

Get attachments
GET/api/v2/attachments

GET /api/v2/attachments/1
Requestsreturns attachment

GET  /api/v2/attachments/2

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "2",
    "type": "attachments",
    "attributes": {
      "name": "img.png",
      "content_type": "image/png",
      "size": 3479,
      "url": "https://files-test.productive.io/attachments/files/000/000/002/original/img.png?1759536172",
      "thumb": "https://files-test.productive.io/attachments/files/000/000/002/thumb/img.png?1759536172",
      "temp_url": "https://files-test.productive.io/attachments/files/000/000/002/original/img.png?1759536172",
      "resized": false,
      "created_at": "2025-10-04T02:02:52.478+02:00",
      "deleted_at": null,
      "attachment_type": null,
      "message_id": null,
      "external_id": null,
      "attachable_type": "comment"
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "13"
        }
      },
      "creator": {
        "meta": {
          "included": false
        }
      },
      "invoice": {
        "meta": {
          "included": false
        }
      },
      "purchase_order": {
        "meta": {
          "included": false
        }
      },
      "bill": {
        "meta": {
          "included": false
        }
      },
      "email": {
        "meta": {
          "included": false
        }
      },
      "page": {
        "meta": {
          "included": false
        }
      },
      "expense": {
        "meta": {
          "included": false
        }
      },
      "comment": {
        "meta": {
          "included": false
        }
      },
      "task": {
        "meta": {
          "included": false
        }
      },
      "document_style": {
        "meta": {
          "included": false
        }
      },
      "document_type": {
        "meta": {
          "included": false
        }
      },
      "deal": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

Gets a attachment
GET/api/v2/attachments/{id}

URI Parameters
HideShow
id
number (required) Example: 1

attachment id

POST /api/v2/attachments
Requestscreates attachmentreturns errorreturns errorreturns error

POST  /api/v2/attachments

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "attachments",
    "attributes": {
      "name": "img.png",
      "attachable_id": 5,
      "attachable_type": "comment"
    }
  }
}
Responses201
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "4",
    "type": "attachments",
    "attributes": {
      "name": "img.png",
      "content_type": null,
      "size": null,
      "url": "https://files-test.productive.io/attachments/files/000/000/004/original/img.png",
      "thumb": null,
      "temp_url": null,
      "resized": false,
      "created_at": "2025-10-04T02:02:52.549+02:00",
      "deleted_at": null,
      "attachment_type": null,
      "message_id": null,
      "external_id": null,
      "attachable_type": "comment",
      "aws_policy": {
        "key": "attachments/files/000/000/004/original/img.png",
        "success_action_status": "201",
        "policy": "eyJleHBpcmF0aW9uIjoiMjAyNS0xMC0wNFQwMTowMjo1MloiLCJjb25kaXRpb25zIjpbeyJidWNrZXQiOiJwcm9kdWN0aXZlLWZpbGVzLXRlc3QifSx7ImtleSI6ImF0dGFjaG1lbnRzL2ZpbGVzLzAwMC8wMDAvMDA0L29yaWdpbmFsL2ltZy5wbmcifSx7InN1Y2Nlc3NfYWN0aW9uX3N0YXR1cyI6IjIwMSJ9LFsiY29udGVudC1sZW5ndGgtcmFuZ2UiLDAsMzE0NTcyODAwXSx7IngtYW16LWNyZWRlbnRpYWwiOiJBU0lBUUdHUTQ2V1ZONVNOVzcyQS8yMDI1MTAwNC9ldS13ZXN0LTEvczMvYXdzNF9yZXF1ZXN0In0seyJ4LWFtei1hbGdvcml0aG0iOiJBV1M0LUhNQUMtU0hBMjU2In0seyJ4LWFtei1kYXRlIjoiMjAyNTEwMDRUMDAwMjUyWiJ9LHsieC1hbXotc2VjdXJpdHktdG9rZW4iOiJGd29HWlhJdllYZHpFTW4vLy8vLy8vLy8vd0VhRExlR25BSTBITVd1NjQxNEp5TFBBeGFrbW5LUWRuVmZGdlAwamg0MXZneEFjdlZnZmM1YXhNQWRzQkRVRzk4K2lDY2FHRTl4bWhVQ3RhMjAxQ1d2RFdVZEJSc2xiYnBVWFJOOEsvdSs4R3pLeVhFV3F6Q2VWbEhEQ203ejFiWnl3TDV4azFFVFNGT2xjbFpTeWp0cnh0aUZHYjZabWFWaDJVeE0vaXlpSlpLNEhlblMxamNsWG4rTlJxZkkzM2lCbmpnRWZnSERtbEZiOGw5MWs2UUwxY2MyUENsZFEyWFIyMUtjaDNHMzRjQ0thTEFiWDltLy9wOUs1VlowT0VIZXNpM0dHdWtZbVRINjRoK2JudEk2MTl6WFEwandMeWM1S2wrUWJVTVlLUGo0aDFhQ1VsVU9CRlI4Y0k3NjBBNXd5dTVYUmFBb3d1SEplbGtyU3dsbTVnUFE4OXFjYkxreWZzOU9iSzJGUjNxNjZNc1V0YUVndEU1MzMxMGhlZjRtcmx5bVJTUVFEZGp2a21mS0lLOUtzQW5VTFo1K1V3L3dpZUxZOGtjeG1HVVcvMUVqVjlJNzdDb2ZiemwxbTV5ZTNzMGE3eGI2SGVBbWhRS1NEMWNINFAwNUtaQVI3RGVIY2tFL3NRNnBIenpGWWluU1owS1hNTWlpQWZ3SkwwNm9Ta1hCd1AzOTd3YkZjOXY1Vkh2R3JDUlNEYi83dDVWVXlHMHFiMHMvV3VrcDlESVhNVks4TjFSME9ZeVV3UUVSWitPajVSSjdKZ0dYSkt5UEh4WVVPNEV6ZkRCbW12RWQ3STB3MVd6SVNFeDVxVnE3ZWJtS0tDd0k2SktoNjhnb29zZUJ4d1l5SmE3VVpka05MU3U1VEtyYys2U3FnTXJ1R1h4cno0bkh4T1hwSlBKTWpSRjQrK1kzQ0FvPSJ9XX0=",
        "x-amz-credential": "ASIAQGGQ46WVN5SNW72A/20251004/eu-west-1/s3/aws4_request",
        "x-amz-algorithm": "AWS4-HMAC-SHA256",
        "x-amz-date": "20251004T000252Z",
        "x-amz-security-token": "FwoGZXIvYXdzEMn//////////wEaDLeGnAI0HMWu6414JyLPAxakmnKQdnVfFvP0jh41vgxAcvVgfc5axMAdsBDUG98+iCcaGE9xmhUCta201CWvDWUdBRslbbpUXRN8K/u+8GzKyXEWqzCeVlHDCm7z1bZywL5xk1ETSFOlclZSyjtrxtiFGb6ZmaVh2UxM/iyiJZK4HenS1jclXn+NRqfI33iBnjgEfgHDmlFb8l91k6QL1cc2PCldQ2XR21Kch3G34cCKaLAbX9m//p9K5VZ0OEHesi3GGukYmTH64h+bntI619zXQ0jwLyc5Kl+QbUMYKPj4h1aCUlUOBFR8cI760A5wyu5XRaAowuHJelkrSwlm5gPQ89qcbLkyfs9ObK2FR3q66MsUtaEgtE53310hef4mrlymRSQQDdjvkmfKIK9KsAnULZ5+Uw/wieLY8kcxmGUW/1EjV9I77Cofbzl1m5ye3s0a7xb6HeAmhQKSD1cH4P05KZAR7DeHckE/sQ6pHzzFYinSZ0KXMMiiAfwJL06oSkXBwP397wbFc9v5VHvGrCRSDb/7t5VUyG0qb0s/Wukp9DIXMVK8N1R0OYyUwQERZ+Oj5RJ7JgGXJKyPHxYUO4EzfDBmmvEd7I0w1WzISEx5qVq7ebmKKCwI6JKh68gooseBxwYyJa7UZdkNLSu5TKrc+6SqgMruGXxrz4nHxOXpJPJMjRF4++Y3CAo=",
        "x-amz-signature": "aa7467fafa4c86c367d394f1ab1906ae10325a466388747cb782fa6ffd2936b9"
      }
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "14"
        }
      },
      "creator": {
        "meta": {
          "included": false
        }
      },
      "invoice": {
        "meta": {
          "included": false
        }
      },
      "purchase_order": {
        "meta": {
          "included": false
        }
      },
      "bill": {
        "meta": {
          "included": false
        }
      },
      "email": {
        "meta": {
          "included": false
        }
      },
      "page": {
        "meta": {
          "included": false
        }
      },
      "expense": {
        "meta": {
          "included": false
        }
      },
      "comment": {
        "meta": {
          "included": false
        }
      },
      "task": {
        "meta": {
          "included": false
        }
      },
      "document_style": {
        "meta": {
          "included": false
        }
      },
      "document_type": {
        "meta": {
          "included": false
        }
      },
      "deal": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

POST  /api/v2/attachments

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "attachments",
    "attributes": {
      "attachable_type": ""
    }
  }
}
Responses422
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "errors": [
    {
      "status": "422",
      "code": "invalid_attribute",
      "title": "Invalid Attribute",
      "detail": "can't be blank",
      "source": {
        "pointer": "data/attributes/name"
      }
    },
    {
      "status": "422",
      "code": "invalid_attribute",
      "title": "Invalid Attribute",
      "detail": "is not included in the list",
      "source": {
        "pointer": "data/attributes/attachable_type"
      }
    }
  ]
}

POST  /api/v2/attachments

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "attachments",
    "attributes": {
      "name": "img.png",
      "attachable_id": 7,
      "attachable_type": "comment",
      "size": 315621376
    }
  }
}
Responses422
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "errors": [
    {
      "status": "422",
      "code": "invalid_attribute",
      "title": "Invalid Attribute",
      "detail": "must be less than or equal to 314572800",
      "source": {
        "pointer": "data/attributes/size"
      }
    }
  ]
}

POST  /api/v2/attachments

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "attachments",
    "attributes": {
      "name": "img.png",
      "attachable_id": 8,
      "attachable_type": "comment",
      "content_type": "application/x-msdownload"
    }
  }
}
Responses422
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "errors": [
    {
      "status": "422",
      "code": "invalid_attribute",
      "title": "Invalid Attribute",
      "detail": "is reserved",
      "source": {
        "pointer": "data/attributes/content_type"
      }
    }
  ]
}

Create a attachment
POST/api/v2/attachments

URI Parameters
HideShow
name
string (required) Example: name

name

id
string (required) Example: Comment

attachable_type

PATCH /api/v2/attachments/1
Requestsupdates attachmentreturns error

PATCH  /api/v2/attachments/8

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "attachments",
    "attributes": {
      "temp_url": "https://s3.amazonaws.com/infinum.productive.test/uploads/1418301662608/dummyfile.pdf"
    }
  }
}
Responses200
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "data": {
    "id": "8",
    "type": "attachments",
    "attributes": {
      "name": "img.png",
      "content_type": "image/png",
      "size": 3479,
      "url": "https://files-test.productive.io/attachments/files/000/000/008/original/img.png?1759536172",
      "thumb": "https://files-test.productive.io/attachments/files/000/000/008/thumb/img.png?1759536172",
      "temp_url": "https://s3.amazonaws.com/infinum.productive.test/uploads/1418301662608/dummyfile.pdf",
      "resized": false,
      "created_at": "2025-10-04T02:02:52.811+02:00",
      "deleted_at": null,
      "attachment_type": null,
      "message_id": null,
      "external_id": null,
      "attachable_type": "comment"
    },
    "relationships": {
      "organization": {
        "data": {
          "type": "organizations",
          "id": "18"
        }
      },
      "creator": {
        "meta": {
          "included": false
        }
      },
      "invoice": {
        "meta": {
          "included": false
        }
      },
      "purchase_order": {
        "meta": {
          "included": false
        }
      },
      "bill": {
        "meta": {
          "included": false
        }
      },
      "email": {
        "meta": {
          "included": false
        }
      },
      "page": {
        "meta": {
          "included": false
        }
      },
      "expense": {
        "meta": {
          "included": false
        }
      },
      "comment": {
        "meta": {
          "included": false
        }
      },
      "task": {
        "meta": {
          "included": false
        }
      },
      "document_style": {
        "meta": {
          "included": false
        }
      },
      "document_type": {
        "meta": {
          "included": false
        }
      },
      "deal": {
        "meta": {
          "included": false
        }
      }
    }
  },
  "meta": {}
}

PATCH  /api/v2/attachments/9

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Body
{
  "data": {
    "type": "attachments",
    "attributes": {
      "attachable_type": ""
    }
  }
}
Responses422
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
  "errors": [
    {
      "status": "422",
      "code": "invalid_attribute",
      "title": "Invalid Attribute",
      "detail": "is not included in the list",
      "source": {
        "pointer": "data/attributes/attachable_type"
      }
    }
  ]
}

Update a attachment
PATCH/api/v2/attachments/{id}

URI Parameters
HideShow
id
number (required) Example: 1

attachment id

DELETE /api/v2/attachments/1
Requestsdeletes attachment

DELETE  /api/v2/attachments/10

Headers
Accept: text/xml,application/xml,application/xhtml+xml,text/html;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5
Content-Type: application/vnd.api+json
Responses204
This response has no content.

Deletes a attachment
DELETE/api/v2/attachments/{id}

URI Parameters
HideShow
id
number (required) Example: 1

attachment id

Generated by aglio on 04 Oct 2025