Request

Response

    Issues Changelog



    Added Webhook Events for Comments and Attachments 2026-09-22

    Added

    Forma Issues now supports the following additional webhook events:

    • comment.created-1.0 — Triggered when a comment is added to an issue.
    • attachment.created-1.0 — Triggered when an attachment is added to an issue.
    • attachment.deleted-1.0 — Triggered when an attachment is deleted from an issue.

    These events are available in Public Beta.

    For the complete list of supported Issues events, see Forma Issues Events. For information about configuring and using Issues webhooks, see the Issues Field Guide.

    Increased Maximum Attachments Per Issue 2026-05-18

    Updated

    The maximum number of attachments allowed on a single issue has increased from 100 to 200. If a request would push an issue’s attachment count over this limit, POST attachments returns a 422 error indicating that the attachments limit per issue has been reached.

    Added Support for Attachments 2025-08-26

    Added

    Forma Issues now supports attachments.

    We have added the following features:

    • Creating, uploading, downloading, retrieving, and deleting issue attachments.

    For more details, see the related endpoints and tutorials.

    Added Webhooks Support For Issues Events 2025-07-23

    Added

    Forma Issues now supports webhook event notifications. You can subscribe to specific issue-related events and have your application automatically respond when those events occur.

    Supported events include:

    • issue.created
    • issue.updated
    • issue.deleted
    • issue.restored
    • issue.unlinked

    To use this feature, configure a webhook using the Webhooks API. When a subscribed event is triggered, the service sends a notification to your configured callback URL.

    For payload details and usage guidance, see the Issues Field Guide.

    Updated Maximum Character Limits 2025-03-10

    Updated

    The maximum character limits have changed for the following issue fields:

    • title: Now 100 characters (previously 4200).
    • description: Now 1,000 characters (previously 10,000).
    • locationDetails: Now 250 characters (previously 8,300).

    The previous higher limits will continue to be supported until May 15, 2025, after which the new limits will be enforced.

    Added Support for Viewing Deleted Issues 2023-09-20

    You can now use GET issues to filter deleted issues (filter[deleted]).

    For more information about deleted issues, see the Help documentation.

    Added New Statuses 2023-05-01

    We now support the following statuses: draft, open, pending, in_progress, completed, in_review, not_approved, in_dispute, closed.

    For more information about statuses, see the Help documentation.