action exavault_get_notification_by_id {
  label: "Get notification details"
  description: "Get the details for a notification with a specific ID number. You'll be able to review its path, triggers and who's getting the notification. \n\n**Notes**\n\n- You need to have the [notifications permission](/docs/account/04-users/00-introduction#managing-user-roles-and-permissions) to view the detail for a notification.\n- You can only retrieve notifications owned by your user account."
  provider: exavault
  method: GET
  path: "/notifications/{id}"
  encoding: json
  input: {
    type: "object"
    properties: {
      "ev-access-token": {
        type: "string"
      }
      "ev-api-key": {
        type: "string"
      }
      id: {
        type: "integer"
      }
      include: {
        type: "string"
      }
    }
    required: ["ev-access-token", "ev-api-key", "id"]
    additionalProperties: false
  }
  output: {
    type: "object"
    description: "Response object for notifications."
    properties: {
      data: {
        type: "object"
        description: "Object containing notification properties."
        properties: {
          attributes: {
            type: "object"
            description: "Attributes for the notification including the path, recipients, and share data. "
            properties: {
              action: {
                type: "string"
                description: "Action that triggers notification."
                enum: ["upload", "download", "delete", "all"]
              }
              created: {
                type: "string"
                format: "date-time"
                description: "Timestamp of notifiction creation."
              }
              message: {
                type: "string"
                description: "Custom message that will be sent to the notification recipients."
              }
              modified: {
                type: "string"
                format: "date-time"
                description: "Timestamp of notification modification."
              }
              name: {
                type: "string"
                description: "Name of the item that the notification is set on."
              }
              path: {
                type: "string"
                description: "Path to the item that the notification is set on."
              }
              readableDescription: {
                type: "string"
                description: "Human readable description of the notification."
              }
              readableDescriptionWithoutPath: {
                type: "string"
                description: "Human readable description of the notification without item path."
              }
              recipients: {
                type: "array"
                description: "Notification recipients."
                items: {
                  type: "object"
                  properties: {
                    created: {
                      type: "string"
                      format: "date-time"
                      description: "Timestamp of adding notification recipient."
                    }
                    email: {
                      type: "string"
                      description: "Recipient email."
                    }
                    id: {
                      type: "integer"
                      format: "int32"
                      description: "ID of the recipient."
                    }
                    modified: {
                      type: "string"
                      format: "date-time"
                      description: "Timestamp of notification recipient modification."
                    }
                    notificationId: {
                      type: "integer"
                      description: "ID of the notification that the recipient belongs to."
                    }
                  }
                }
              }
              sendEmail: {
                type: "boolean"
                description: "Whether or not an email will send when the notification is triggered."
                enum: [true, false]
              }
              shareId: {
                type: "string"
                description: "ID of the share that the notification belogns to."
              }
              type: {
                type: "string"
                description: "Type of the resource the notification is attached to. "
                enum: ["file", "folder", "shared_folder", "send_receipt", "share_receipt", "file_drop"]
              }
              userId: {
                type: "string"
                description: "ID of the user that the notification belongs to."
              }
              usernames: {
                type: "array"
                description: "Detail on which users can trigger the notification."
                items: {
                  type: "string"
                }
              }
            }
          }
          id: {
            type: "integer"
            format: "int32"
          }
          relationships: {
            type: "object"
            properties: {
              ownerUser: {
                type: "object"
                properties: {
                  data: {
                    type: "object"
                    properties: {
                      id: {
                        type: "integer"
                      }
                      type: {
                        type: "string"
                        enum: ["user"]
                      }
                    }
                  }
                }
              }
              resource: {
                type: "object"
                properties: {
                  data: {
                    type: "object"
                    properties: {
                      id: {
                        type: "integer"
                        format: "int64"
                      }
                      type: {
                        type: "string"
                      }
                    }
                  }
                }
              }
              share: {
                type: "object"
                properties: {
                  data: {
                    type: "object"
                    properties: {
                      id: {
                        type: "integer"
                        format: "int32"
                      }
                      type: {
                        type: "string"
                      }
                    }
                  }
                }
              }
            }
          }
          type: {
            type: "string"
          }
        }
      }
      included: {
        type: "array"
        items: {
          type: "object"
        }
      }
      responseStatus: {
        type: "integer"
        description: "Http status code of the response."
      }
    }
  }
}