Projects V2 Item
This event occurs when there is activity relating to an item on an organization-level project. For more information, see "About Projects." For information about the Projects API, see the GraphQL documentation.
Actions
| Action | Sent when |
|---|---|
archived | An item on an organization project was archived. For more information, see "Archiving items from your project." |
converted | A draft issue in an organization project was converted to an issue. |
created | An item was added to a project in the organization. |
deleted | An item was deleted from a project in the organization. |
edited | The values or state of an item in an organization project were changed. For example, the value of a field was updated, the body of a draft issue was changed, or a draft issue was converted to an issue. |
reordered | The position of an item in an organization project was changed. For example, an item was moved above or below another item in the table or board layout. |
restored | An archived item on an organization project was restored from the archive. For more information, see "Archiving items from your project." |
Payload
Fields of the delivery for the first action above. Every action shares the event's core fields.
| Field | Type | Required | Description |
|---|---|---|---|
action | string | Yes | |
changes | object | Yes | |
installation | object | No | The GitHub App installation. Webhook payloads contain the installation property when the event is configured |
organization | object | Yes | A GitHub organization. Webhook payloads contain the organization property when the webhook is configured for an |
projects_v2_item | object | Yes | An item belonging to a project |
sender | object | Yes | A GitHub user. |
Subscribing
To subscribe to this event, a GitHub App must have at least read-level access for the "Projects" organization permission.