Notification Deep Link Handler
API Contract
REST
/api/v1/notification-deep-links
6 endpoints
GET
/api/v1/notification-deep-links/api/v1/notification-deep-links
List deep link navigation logs
Public
Response Example
{
"data": [
{
"deep_link_id": "dl-7701",
"user_id": "usr-441",
"payload_category": "assignment_posted",
"resolved_route": "/assignments/asgn-1004",
"navigated_at": "2026-03-26T09:00:00Z"
}
],
"pagination": {
"page": 1,
"limit": 20,
"total": 15
}
}
GET
/api/v1/notification-deep-links/api/v1/notification-deep-links/:id
Get a deep link navigation record by ID
Public
Response Example
{
"deep_link_id": "dl-7701",
"user_id": "usr-441",
"payload": {
"category": "assignment_posted",
"assignment_id": "asgn-1004"
},
"resolved_route": "/assignments/asgn-1004",
"navigated_at": "2026-03-26T09:00:00Z"
}
POST
/api/v1/notification-deep-links/api/v1/notification-deep-links/resolve
Resolve a notification payload to a route without navigating
Public
Request Example
{
"user_id": "usr-441",
"payload": {
"category": "status_change",
"assignment_id": "asgn-1004"
}
}
Response Example
{
"resolved_route": "/assignments/asgn-1004",
"requires_auth": true
}
POST
/api/v1/notification-deep-links/api/v1/notification-deep-links
Record a deep link tap and resolution event
Public
Request Example
{
"user_id": "usr-441",
"payload": {
"category": "assignment_posted",
"assignment_id": "asgn-1004"
},
"resolved_route": "/assignments/asgn-1004"
}
Response Example
{
"deep_link_id": "dl-7720",
"user_id": "usr-441",
"resolved_route": "/assignments/asgn-1004",
"navigated_at": "2026-03-26T10:00:00Z"
}
PUT
/api/v1/notification-deep-links/api/v1/notification-deep-links/:id
Update a deep link record (e.g. mark as pending navigation)
Public
Request Example
{
"pending": true,
"queued_at": "2026-03-26T10:01:00Z"
}
Response Example
{
"deep_link_id": "dl-7720",
"pending": true,
"queued_at": "2026-03-26T10:01:00Z"
}
DELETE
/api/v1/notification-deep-links/api/v1/notification-deep-links/:id
Delete a deep link log record
Public
Response Example
{
"deleted": true,
"deep_link_id": "dl-7701"
}