EmbodiFlowDocs
Get startedDataWorkflows and algorithmsTraining and deploymentDeveloper reference
  • Developer reference

Authentication

  • Authentication overview
  • API keys
  • Personal access tokens
  • Browser sessions

REST API

  • Using the REST API
  • All endpoints
  • Projects
    • Recordings
      • Upload
        • Episodes and versions
          • Annotation
            • Quality and tasks
              • Search
                • Workflows
                  • Algorithms
                    • Models
                      • Artifacts and export
                        • Billing and usage
                          • Team and governance
                            • Account and notifications
                              • GET
                                List the current user activity tray for this team
                              • GET
                                Get the current user handle profile
                              • PATCH
                                Update the current user handle
                              • GET
                                List annotation assignments for a me
                              • GET
                                List collection tasks for a me
                              • GET
                                Get a collection task
                              • POST
                                Create a consent acceptance
                              • GET
                                List delivery batches for a me
                              • POST
                                Create a closure
                              • GET
                                Get the current user notification channel preferences for this team
                              • PUT
                                Replace the current user notification channel preferences for this team
                              • GET
                                List workflow runs for a me
                              • GET
                                List notifications
                              • POST
                                Create a read receipt
                              • POST
                                Create a read receipt
                              • GET
                                List unread count for a notification
                            • Webhook endpoints

                              Events

                              • Outbound events
                              • Signature verification

                              Tools

                              • CLI
                              • SDK
                              • MCP

                              Updates

                              • Changelog

                              © 2026 EmbodiFlow

                              llms.txtOpenAPI JSON
                              1. Developer reference
                              2. REST API
                              3. Account and notifications
                              4. Replace the current user notification channel preferences for this team

                              Replace the current user notification channel preferences for this team

                              PUT
                              /v1/me/notification-preferences
                              curl -X PUT 'https://api.embodiflow.io/v1/me/notification-preferences' \
                                -H 'Authorization: Bearer $EMBODIFLOW_PAT' \
                                -H 'Content-Type: application/json' \
                                -d '{
                                  "items": [
                                    {
                                      "category": "training",
                                      "inApp": true,
                                      "email": true
                                    }
                                  ]
                                }'

                              Authorization

                              Send a personal access token with every request.

                              • Authorization: Bearer PAT
                              Authentication guide

                              Header parameters

                              • Idempotency-Keystring

                                Optional idempotency key, at most 255 characters (UUIDv4 recommended). A repeated key returns the first response byte-for-byte, including a 5xx. The same key with a different body, or a second in-flight request, returns 409 IDEMPOTENCY_CONFLICT. Keys are unique per tenant and retained for 24 hours.

                              Request body

                              Content-Typeapplication/json
                              • itemsarray<NotificationPreferenceItemBodyDto>required
                                • categorystringrequired
                                  Allowed values
                                  training
                                  export
                                  annotation
                                  collection
                                  workflow
                                  billing
                                  evaluation
                                  erasure
                                  algorithm
                                • inAppbooleanrequired
                                • emailbooleanrequired

                              Responses

                              Success

                              • dataobjectrequired
                                • itemsarray<NotificationPreferenceItemBodyDto>
                              Response example
                              {
                                "data": {
                                  "items": [
                                    {
                                      "category": "training",
                                      "inApp": true,
                                      "email": true
                                    }
                                  ]
                                }
                              }
                              Servershttps://api.embodiflow.io/v1https://api.embodiflow.dev/v1
                              Previous

                              GET /me/notification-preferences

                              Next

                              GET /me/workflow-runs

                              curl -X PUT 'https://api.embodiflow.io/v1/me/notification-preferences' \
                                -H 'Authorization: Bearer $EMBODIFLOW_PAT' \
                                -H 'Content-Type: application/json' \
                                -d '{
                                  "items": [
                                    {
                                      "category": "training",
                                      "inApp": true,
                                      "email": true
                                    }
                                  ]
                                }'
                              Response example
                              Status code
                              200
                              ​
                              {
                                "data": {
                                  "items": [
                                    {
                                      "category": "training",
                                      "inApp": true,
                                      "email": true
                                    }
                                  ]
                                }
                              }