list_notifications
/notificationsA service principal's credential, or a person's access token, AgentFlow's own or an installed app's. A service principal's effective permissions are its role permissions intersected with the credential's scopes.
In: header
Query Parameters
Page size, from 1 to 200; 50 when absent.
int321 <= value <= 200Cursor walking forward, from next_cursor.
Cursor walking backward, from prev_cursor.
The field to sort by; created_at when absent.
Value in
- "created_at"
The sort direction; desc, newest first, when absent.
Value in
- "asc"
- "desc"
Matches an event kind by prefix, exactly as written: work_ finds
the work_* kinds, and workflow_ finds workflow_task_completed.
Only unread notifications.
Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X GET "https://example.com/notifications"{ "items": [ { "action_url": "string", "created_at": "2019-08-24T14:15:22Z", "event_kind": "string", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "instance_id": "06587974-2dbe-4e10-8bf9-38cce0f5a366", "is_read": true, "params": null, "read_at": "2019-08-24T14:15:22Z" } ], "next_cursor": "string", "prev_cursor": "string"}