Overview
PUT/me/communication-settingssettings

Replace the caller's communication/presence dial (upsert; full representation)

Masks must combine only the known AUDIENCE bits (PUBLIC=1, HUB=2, TEAM=4, ORG=8, FRIEND=32); 0 means nobody. Blocks always override the dial, and appear_offline hides presence from everyone.

Auth: bearerAuth — calls run as the authenticated user.

Request body

application/json · optional

  • dmAudienceMaskinteger

    AUDIENCE bitmask of who may DM the user (0 = nobody; default PUBLIC|HUB = 3)

  • presenceAudienceMaskinteger

    AUDIENCE bitmask of who may see the user presence (0 = nobody; default PUBLIC|HUB = 3)

  • appearOfflineboolean

    When true, presence is hidden from EVERYONE regardless of the mask

Example
{
  "dmAudienceMask": 0,
  "presenceAudienceMask": 0,
  "appearOffline": true
}
Responses
200

The saved communication dial

  • dmAudienceMaskinteger

    AUDIENCE bitmask of who may DM the user (0 = nobody; default PUBLIC|HUB = 3)

  • presenceAudienceMaskinteger

    AUDIENCE bitmask of who may see the user presence (0 = nobody; default PUBLIC|HUB = 3)

  • appearOfflineboolean

    When true, presence is hidden from EVERYONE regardless of the mask

Example
{
  "dmAudienceMask": 0,
  "presenceAudienceMask": 0,
  "appearOffline": true
}
400

Error

  • erroroptionalobject
Example
{
  "error": {
    "message": "string",
    "code": "string"
  }
}
401

Error

  • erroroptionalobject
Example
{
  "error": {
    "message": "string",
    "code": "string"
  }
}
Code examples
cURL
curl -X PUT "https://api.agenticdeveloperhub.com/me/communication-settings" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "dmAudienceMask": 0,
  "presenceAudienceMask": 0,
  "appearOffline": true
}'
JavaScript
const res = await fetch("https://api.agenticdeveloperhub.com/me/communication-settings", {
  method: "PUT",
  headers: {
    "Authorization": "Bearer YOUR_TOKEN",
    "Content-Type": "application/json"
  },
  body: "{\n  \"dmAudienceMask\": 0,\n  \"presenceAudienceMask\": 0,\n  \"appearOffline\": true\n}",
});
const data = await res.json();