REST APIs
- Organizations
- Folders
- Documents
- Users
- Organization User Groups
- Comments Feature
- Notifications
- Live State
- Workspace
SDK
- APIs
- Models
Notifications
Set Config
POST
/
v1
/
notifications
/
config
/
set
curl --request POST \
--url https://api.velt.dev/v1/notifications/config/set \
--header 'Content-Type: application/json' \
--header 'x-velt-api-key: <x-velt-api-key>' \
--header 'x-velt-auth-token: <x-velt-auth-token>' \
--data '{
"data": {
"organizationId": "<string>",
"documentIds": [
"<string>"
],
"userIds": [
"<string>"
],
"config": {
"inbox": "<string>",
"email": "<string>",
"slack": "<string>"
}
}
}'
{
"result": {
"status": "success",
"message": "User config set successfully.",
"data": {
"USER_ID1": {
"success": true,
"userId": "USER_ID1",
"documentId": "doc1",
"message": "User config set successfully."
}
}
}
}
To use this API, you must have the this feature enabled in Velt console
Use this API to set the notifications config for users.
Endpoint
POST https://api.velt.dev/v1/notifications/config/set
Headers
Your API key.
Your Auth Token.
Body
Params
The ID of the organization.
An array of document IDs. The notification configuration will be applied to these documents for the specified users.
An array of user IDs. The notification configuration will be set for these users.
Object containing the notification preferences.
In-app inbox notification preference. Valid values:
ALL
: User receives all notifications in their inbox.MINE
: User receives notifications in their inbox only for activities directly involving them (e.g., mentions, replies).NONE
: User receives no notifications in their inbox.
Optional.
Email notification preference. Valid values:
ALL
: User receives email notifications for all activities.MINE
: User receives email notifications only for activities directly involving them.NONE
: User receives no email notifications.
Optional.
Slack notification preference (requires Slack integration to be effective). Valid values:
ALL
: User receives Slack notifications for all activities.MINE
: User receives Slack notifications only for activities directly involving them.NONE
: User receives no Slack notifications.
Optional.
Example Request
{
"data": {
"organizationId": "org1",
"documentIds": ["doc1"],
"userIds":["USER_ID1"],
"config":{
"inbox": "ALL", // ALL | MINE | NONE
"email": "ALL" // ALL | MINE | NONE
}
}
}
Response
Success Response
{
"result": {
"status": "success",
"message": "User config set successfully.",
"data": {
"USER_ID1": {
"success": true,
"userId": "USER_ID1",
"documentId": "doc1",
"message": "User config set successfully."
}
}
}
}
Failure Response
{
"error": {
"message": "ERROR_MESSAGE",
"status": "INVALID_ARGUMENT"
}
}
{
"result": {
"status": "success",
"message": "User config set successfully.",
"data": {
"USER_ID1": {
"success": true,
"userId": "USER_ID1",
"documentId": "doc1",
"message": "User config set successfully."
}
}
}
}
Was this page helpful?
curl --request POST \
--url https://api.velt.dev/v1/notifications/config/set \
--header 'Content-Type: application/json' \
--header 'x-velt-api-key: <x-velt-api-key>' \
--header 'x-velt-auth-token: <x-velt-auth-token>' \
--data '{
"data": {
"organizationId": "<string>",
"documentIds": [
"<string>"
],
"userIds": [
"<string>"
],
"config": {
"inbox": "<string>",
"email": "<string>",
"slack": "<string>"
}
}
}'
{
"result": {
"status": "success",
"message": "User config set successfully.",
"data": {
"USER_ID1": {
"success": true,
"userId": "USER_ID1",
"documentId": "doc1",
"message": "User config set successfully."
}
}
}
}
Assistant
Responses are generated using AI and may contain mistakes.