Skip to content

UpdateUserAttribute

PATCH/api/v1/users/{user}/userattributes/{user_attribute}

Update one of a user’s attributes.

Example request

curl -X PATCH \
-H "Authorization: Bearer ${OBLIQUE_API_KEY}" \
-H "Content-Type: application/json" \
-d '{ "integration": "string", "key": "string", "value": "string" }' \
"https://us.oblique.security/api/v1/users/{user}/userattributes/{user_attribute}?updateMask=integration,key,value"

Set OBLIQUE_API_KEY to your API key.

Path parameters

  • userAttribute.namestringrequired

    Assigned by Oblique.

Query parameters

  • updateMaskstring (field-mask)

    The list of fields to update.

  • allowMissingboolean

    If set to true, and the attribute is not found, a new attribute will be created with the given name. If created in this way, update_mask is ignored.

Request body

  • createTimestring (date-time)read-only

    Create timestamp of the attributes. This is always the same as the parent user.

  • updateTimestring (date-time)read-only

    The last time that attributes were modified.

  • integrationstringrequired

    The integration that manages the attribute.

    Format: integrations/{integration}

  • keystringrequired

    The key of the attribute, such as “department” or “costCenter”.

  • valuestringrequired

    The value of the attribute, such as “Engineering” or “12345”.

Response

200UserAttribute
  • namestring

    Assigned by Oblique.

  • createTimestring (date-time)read-only

    Create timestamp of the attributes. This is always the same as the parent user.

  • updateTimestring (date-time)read-only

    The last time that attributes were modified.

  • integrationstringrequired

    The integration that manages the attribute.

    Format: integrations/{integration}

  • keystringrequired

    The key of the attribute, such as “department” or “costCenter”.

  • valuestringrequired

    The value of the attribute, such as “Engineering” or “12345”.

Errors

StatusMeaning
400Malformed request
401Missing or invalid API key
403Not allowed for this API key
404Not found
429Too many requests
500Internal server error