github-rest-openapi-agent/skills/notifications/SKILL.md

name, description

name	description
notifications-routes	Handle 8 OpenAPI operation(s) under /notifications for the notifications route group.

notifications API Routes

Handle 8 OpenAPI operation(s) under /notifications for the notifications route group.

Use the generated operation tools to make real API calls. Do not invent API responses. If a tool reports missing setup, return the exact setup field name to the caller. For write, update, or delete operations, state the intended action before calling the tool.

Operations

activity_list_notifications_for_authenticated_user

• Operation ID: activity_list_notifications_for_authenticated_user
• Route: GET /notifications
• Mode: READ
• Summary: List notifications for the authenticated user
• Parameters:
  • all in query
  • participating in query
  • since in query
  • before in query
  • page in query
  • per_page in query

activity_mark_notifications_as_read

• Operation ID: activity_mark_notifications_as_read
• Route: PUT /notifications
• Mode: WRITE
• Summary: Mark notifications as read
• Body: JSON request body accepted.

activity_get_thread

• Operation ID: activity_get_thread
• Route: GET /notifications/threads/{thread_id}
• Mode: READ
• Summary: Get a thread
• Parameters:
  • thread_id in path required

activity_mark_thread_as_read

• Operation ID: activity_mark_thread_as_read
• Route: PATCH /notifications/threads/{thread_id}
• Mode: WRITE
• Summary: Mark a thread as read
• Parameters:
  • thread_id in path required

activity_mark_thread_as_done

• Operation ID: activity_mark_thread_as_done
• Route: DELETE /notifications/threads/{thread_id}
• Mode: WRITE
• Summary: Mark a thread as done
• Parameters:
  • thread_id in path required

activity_get_thread_subscription_for_authenticated_user

• Operation ID: activity_get_thread_subscription_for_authenticated_user
• Route: GET /notifications/threads/{thread_id}/subscription
• Mode: READ
• Summary: Get a thread subscription for the authenticated user
• Parameters:
  • thread_id in path required

activity_set_thread_subscription

• Operation ID: activity_set_thread_subscription
• Route: PUT /notifications/threads/{thread_id}/subscription
• Mode: WRITE
• Summary: Set a thread subscription
• Parameters:
  • thread_id in path required
• Body: JSON request body accepted.

activity_delete_thread_subscription

• Operation ID: activity_delete_thread_subscription
• Route: DELETE /notifications/threads/{thread_id}/subscription
• Mode: WRITE
• Summary: Delete a thread subscription
• Parameters:
  • thread_id in path required