REST APIs
- v2
- v1
- Organizations
- Folders
- Documents
- Users
- User Groups
- Comments Feature
- Notifications
- GDPR
- Live State
- Auth
- Workspace
SDK
- APIs
- Models
Notifications
Set Config
POST
/
v1
/
notifications
/
config
/
set
Copy
Ask AI
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>"
}
}
}'
Copy
Ask AI
{
"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
Copy
Ask AI
{
"data": {
"organizationId": "org1",
"documentIds": ["doc1"],
"userIds":["USER_ID1"],
"config":{
"inbox": "ALL", // ALL | MINE | NONE
"email": "ALL" // ALL | MINE | NONE
}
}
}
Response
Success Response
Copy
Ask AI
{
"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
Copy
Ask AI
{
"error": {
"message": "ERROR_MESSAGE",
"status": "INVALID_ARGUMENT"
}
}
Copy
Ask AI
{
"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?
Copy
Ask AI
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>"
}
}
}'
Copy
Ask AI
{
"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.