API Documentation
Notifications ¶
GET /api/v2/notifications
Requests
GET /api/v2/notifications
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
Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"data": [
{
"id": "185",
"type": "notifications",
"attributes": {
"target_id": 43,
"target_type": "task",
"target_title": "#1: Ticket title",
"parent_id": 485,
"parent_type": "project",
"parent_title": "[Client1195] test project",
"title": "created task <b>#1: Ticket title</b> on <b>[Client1195] test project</b>",
"read": false,
"dismissed": false,
"new_activities_count": 1,
"excerpt": "",
"last_action_at": null,
"first_unread_activity_id": null,
"changeset": [],
"important": false,
"mention": false,
"target_label": "task"
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "664"
}
},
"actor": {
"meta": {
"included": false
}
},
"owner": {
"data": {
"type": "organization_memberships",
"id": "2443"
}
}
}
}
],
"links": {
"first": "http://api-test.productive.io/api/v2/notifications?page%5Bnumber%5D=1&page%5Bsize%5D=30",
"last": "http://api-test.productive.io/api/v2/notifications?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 notificationsGET/api/v2/notifications
GET /api/v2/notifications/1
Requests
GET /api/v2/notifications/186
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
Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"data": {
"id": "186",
"type": "notifications",
"attributes": {
"target_id": 44,
"target_type": "task",
"target_title": "#1: Ticket title",
"parent_id": 488,
"parent_type": "project",
"parent_title": "[Client1198] test project",
"title": "created task <b>#1: Ticket title</b> on <b>[Client1198] test project</b>",
"read": false,
"dismissed": false,
"new_activities_count": 1,
"excerpt": "",
"last_action_at": null,
"first_unread_activity_id": null,
"changeset": [],
"important": false,
"mention": false,
"target_label": "task"
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "665"
}
},
"actor": {
"meta": {
"included": false
}
},
"owner": {
"data": {
"type": "organization_memberships",
"id": "2450"
}
}
}
},
"meta": {}
}
Shows a notificationGET/api/v2/notifications/{id}
URI Parameters
- id
number
(required) Example: 1notification id
PATCH /api/v2/notifications/1/dismiss
Requests
PATCH /api/v2/notifications/187/dismiss
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
Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"data": {
"id": "187",
"type": "notifications",
"attributes": {
"target_id": 45,
"target_type": "task",
"target_title": "#1: Ticket title",
"parent_id": 491,
"parent_type": "project",
"parent_title": "[Client1201] test project",
"title": "created task <b>#1: Ticket title</b> on <b>[Client1201] test project</b>",
"read": false,
"dismissed": true,
"new_activities_count": 1,
"excerpt": "",
"last_action_at": null,
"first_unread_activity_id": null,
"changeset": [],
"important": false,
"mention": false,
"target_label": "task"
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "666"
}
},
"actor": {
"meta": {
"included": false
}
},
"owner": {
"data": {
"type": "organization_memberships",
"id": "2457"
}
}
}
},
"meta": {}
}
Dismisses a notificationPATCH/api/v2/notifications/{id}/dismiss
URI Parameters
- id
number
(required) Example: 1notification id
PATCH /api/v2/notifications/190/read
Requests
PATCH /api/v2/notifications/190/read
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
Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"data": {
"id": "190",
"type": "notifications",
"attributes": {
"target_id": 48,
"target_type": "task",
"target_title": "#1: Ticket title",
"parent_id": 500,
"parent_type": "project",
"parent_title": "[Client1210] test project",
"title": "created task <b>#1: Ticket title</b> on <b>[Client1210] test project</b>",
"read": true,
"dismissed": false,
"new_activities_count": 1,
"excerpt": "",
"last_action_at": null,
"first_unread_activity_id": null,
"changeset": [],
"important": false,
"mention": false,
"target_label": "task"
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "669"
}
},
"actor": {
"meta": {
"included": false
}
},
"owner": {
"data": {
"type": "organization_memberships",
"id": "2478"
}
}
}
},
"meta": {}
}
Reads a notificationPATCH/api/v2/notifications/{id}/read
URI Parameters
- id
number
(required) Example: 190
PATCH /api/v2/notifications/1/undismiss
Requests
PATCH /api/v2/notifications/193/undismiss
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
Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"data": {
"id": "193",
"type": "notifications",
"attributes": {
"target_id": 51,
"target_type": "task",
"target_title": "#1: Ticket title",
"parent_id": 509,
"parent_type": "project",
"parent_title": "[Client1219] test project",
"title": "created task <b>#1: Ticket title</b> on <b>[Client1219] test project</b>",
"read": false,
"dismissed": false,
"new_activities_count": 1,
"excerpt": "",
"last_action_at": null,
"first_unread_activity_id": null,
"changeset": [],
"important": true,
"mention": true,
"target_label": "task"
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "672"
}
},
"actor": {
"meta": {
"included": false
}
},
"owner": {
"data": {
"type": "organization_memberships",
"id": "2499"
}
}
}
},
"meta": {}
}
GET /api/v2/notifications?filter[date_before]=2024-04-19
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
Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"data": [
{
"id": "197",
"type": "notifications",
"attributes": {
"target_id": 55,
"target_type": "task",
"target_title": "#1: Ticket title",
"parent_id": 521,
"parent_type": "project",
"parent_title": "[Client1231] test project",
"title": "created task <b>#1: Ticket title</b> on <b>[Client1231] test project</b>",
"read": false,
"dismissed": false,
"new_activities_count": 1,
"excerpt": "",
"last_action_at": "2024-04-18T06:06:47.341+02:00",
"first_unread_activity_id": null,
"changeset": [],
"important": false,
"mention": false,
"target_label": "task"
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "675"
}
},
"actor": {
"meta": {
"included": false
}
},
"owner": {
"data": {
"type": "organization_memberships",
"id": "2520"
}
}
}
}
],
"links": {
"first": "http://api-test.productive.io/api/v2/notifications?filter%5Bdate_before%5D=2024-04-19&page%5Bnumber%5D=1&page%5Bsize%5D=30",
"last": "http://api-test.productive.io/api/v2/notifications?filter%5Bdate_before%5D=2024-04-19&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 /api/v2/notifications?filter[date_after]=2024-04-19
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
Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"data": [
{
"id": "200",
"type": "notifications",
"attributes": {
"target_id": 58,
"target_type": "task",
"target_title": "#1: Ticket title",
"parent_id": 530,
"parent_type": "project",
"parent_title": "[Client1240] test project",
"title": "created task <b>#1: Ticket title</b> on <b>[Client1240] test project</b>",
"read": false,
"dismissed": false,
"new_activities_count": 1,
"excerpt": "",
"last_action_at": "2024-04-20T06:06:48.391+02:00",
"first_unread_activity_id": null,
"changeset": [],
"important": false,
"mention": false,
"target_label": "task"
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "676"
}
},
"actor": {
"meta": {
"included": false
}
},
"owner": {
"data": {
"type": "organization_memberships",
"id": "2538"
}
}
}
}
],
"links": {
"first": "http://api-test.productive.io/api/v2/notifications?filter%5Bdate_after%5D=2024-04-19&page%5Bnumber%5D=1&page%5Bsize%5D=30",
"last": "http://api-test.productive.io/api/v2/notifications?filter%5Bdate_after%5D=2024-04-19&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 /api/v2/notifications?filter[type]=Task
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
Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"data": [
{
"id": "203",
"type": "notifications",
"attributes": {
"target_id": 61,
"target_type": "task",
"target_title": "#1: Ticket title",
"parent_id": 539,
"parent_type": "project",
"parent_title": "[Client1249] test project",
"title": "created task <b>#1: Ticket title</b> on <b>[Client1249] test project</b>",
"read": false,
"dismissed": false,
"new_activities_count": 1,
"excerpt": "",
"last_action_at": null,
"first_unread_activity_id": null,
"changeset": [],
"important": false,
"mention": false,
"target_label": "task"
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "677"
}
},
"actor": {
"meta": {
"included": false
}
},
"owner": {
"data": {
"type": "organization_memberships",
"id": "2556"
}
}
}
}
],
"links": {
"first": "http://api-test.productive.io/api/v2/notifications?filter%5Btype%5D=Task&page%5Bnumber%5D=1&page%5Bsize%5D=30",
"last": "http://api-test.productive.io/api/v2/notifications?filter%5Btype%5D=Task&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 /api/v2/notifications?filter[project_id]=548
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
Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"data": [
{
"id": "206",
"type": "notifications",
"attributes": {
"target_id": 64,
"target_type": "task",
"target_title": "#1: Ticket title",
"parent_id": 548,
"parent_type": "project",
"parent_title": "[Client1258] test project",
"title": "created task <b>#1: Ticket title</b> on <b>[Client1258] test project</b>",
"read": false,
"dismissed": false,
"new_activities_count": 1,
"excerpt": "",
"last_action_at": null,
"first_unread_activity_id": null,
"changeset": [],
"important": false,
"mention": false,
"target_label": "task"
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "678"
}
},
"actor": {
"meta": {
"included": false
}
},
"owner": {
"data": {
"type": "organization_memberships",
"id": "2574"
}
}
}
}
],
"links": {
"first": "http://api-test.productive.io/api/v2/notifications?filter%5Bproject_id%5D=548&page%5Bnumber%5D=1&page%5Bsize%5D=30",
"last": "http://api-test.productive.io/api/v2/notifications?filter%5Bproject_id%5D=548&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 /api/v2/notifications?filter[project_id]=557
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
Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"data": [
{
"id": "209",
"type": "notifications",
"attributes": {
"target_id": 1,
"target_type": "todo",
"target_title": "You need to do this.",
"parent_id": 67,
"parent_type": "task",
"parent_title": "#1: Ticket title",
"title": "created todo <b>You need to do this.</b> on <b>#1: Ticket title</b>",
"read": false,
"dismissed": false,
"new_activities_count": 1,
"excerpt": "",
"last_action_at": null,
"first_unread_activity_id": null,
"changeset": [],
"important": false,
"mention": false,
"target_label": "todo"
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "679"
}
},
"actor": {
"meta": {
"included": false
}
},
"owner": {
"data": {
"type": "organization_memberships",
"id": "2592"
}
}
}
}
],
"links": {
"first": "http://api-test.productive.io/api/v2/notifications?filter%5Bproject_id%5D=557&page%5Bnumber%5D=1&page%5Bsize%5D=30",
"last": "http://api-test.productive.io/api/v2/notifications?filter%5Bproject_id%5D=557&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 /api/v2/notifications?filter[project_id]=566&filter[type]=Task
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
Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"data": [
{
"id": "212",
"type": "notifications",
"attributes": {
"target_id": 70,
"target_type": "task",
"target_title": "#1: Ticket title",
"parent_id": 566,
"parent_type": "project",
"parent_title": "[Client1276] test project",
"title": "created task <b>#1: Ticket title</b> on <b>[Client1276] test project</b>",
"read": false,
"dismissed": false,
"new_activities_count": 1,
"excerpt": "",
"last_action_at": null,
"first_unread_activity_id": null,
"changeset": [],
"important": false,
"mention": false,
"target_label": "task"
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "680"
}
},
"actor": {
"meta": {
"included": false
}
},
"owner": {
"data": {
"type": "organization_memberships",
"id": "2610"
}
}
}
}
],
"links": {
"first": "http://api-test.productive.io/api/v2/notifications?filter%5Bproject_id%5D=566&filter%5Btype%5D=Task&page%5Bnumber%5D=1&page%5Bsize%5D=30",
"last": "http://api-test.productive.io/api/v2/notifications?filter%5Bproject_id%5D=566&filter%5Btype%5D=Task&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 /api/v2/notifications?filter[type]=Todo
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
Responses
Headers
Content-Type: application/vnd.api+json; charset=utf-8
Body
{
"data": [
{
"id": "216",
"type": "notifications",
"attributes": {
"target_id": 3,
"target_type": "todo",
"target_title": "You need to do this.",
"parent_id": 73,
"parent_type": "task",
"parent_title": "#1: Ticket title",
"title": "created todo <b>You need to do this.</b> on <b>#1: Ticket title</b>",
"read": false,
"dismissed": false,
"new_activities_count": 1,
"excerpt": "",
"last_action_at": null,
"first_unread_activity_id": null,
"changeset": [],
"important": false,
"mention": false,
"target_label": "todo"
},
"relationships": {
"organization": {
"data": {
"type": "organizations",
"id": "681"
}
},
"actor": {
"meta": {
"included": false
}
},
"owner": {
"data": {
"type": "organization_memberships",
"id": "2628"
}
}
}
}
],
"links": {
"first": "http://api-test.productive.io/api/v2/notifications?filter%5Btype%5D=Todo&page%5Bnumber%5D=1&page%5Bsize%5D=30",
"last": "http://api-test.productive.io/api/v2/notifications?filter%5Btype%5D=Todo&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
}
}
Undismisses a notificationPATCH/api/v2/notifications/{id}/undismiss
URI Parameters
- id
number
(required) Example: 1notification id
Generated by aglio on 19 Apr 2024