×

Login to Safe Shepherd

Recover your password

Safe Shepherd API Documentation

Update user information

Updates account information for a user.

PUT /api/:integration_name/:api_key/v2/users/:id(.:format)

Parameters

api_key
API access key - String*
api_secret
API secret key - String*
id
User id returned during user creation - Integer*
secret
Secret associated with user account during creation - Integer*
first_name
User's first name - String
last_name
User's last name - String
middle_name
User's middle name - String
birth_date
Integer of unix epoch representing user's birth date (UTC) - Integer
aliases
List of <alias> objects representing any user aliases to update, delete or append - List
emails
List of <email> objects representing any user emails to update, delete or append - List
phone_numbers
List of <phone number> objects representing any phone numbers to update, delete or append - List
addresses
List of <address> objects representing any addresses to update, delete or append - Json

Custom Types

Address
for Requests
"address" request object:
{ 'id': String (if updating), address1': String, 'address2': String, 'city': String, 'state': String, 'zip': String, 'country': String, _destroy: Boolean }
Alias
for Requests
"alias" request object:
{ 'id': String (if updating), first_name: String, last_name: String, alias_type: {nickname|maiden}, _destroy: Boolean }
Email
for Requests
"email" request object:
{ 'id': String (if updating), address: String, _destroy: Boolean }
Phone_number
for Requests
"phone number" request object:
{ 'id': String (if updating), number: String, _destroy: Boolean }

Returns

HTTP 401 - Unauthorized

If api_key missing or invalid, or user-secret failed authorization.

HTTP 400 - Bad Request

If fields missing or invalid

HTTP 200 - Success

Returns JSON/XML-encoded struct { user: <details for given user (see example)> }

View Example
{
  "user": {
    "id": 12,
    "secret": "TOP SECRET",
    "birth_date": null,
    "first_name": "Tommy",
    "middle_name": "Lee",
    "last_name": "Jones",
    "aliases": [
      {
        "id": 123,
        "first_name": "Tom",
        "last_name": "Yorke"
      }
    ],
    "emails": [
      {
        "id": 123,
        "address": "tom@example.com"
      }
    ],
    "phone_numbers": [
      {
        "id": 123,
        "number": "3128881212"
      },
      {
        "id": 124,
        "number": "2153331212"
      }
    ],
    "addresses": [
      {
        "id": 123,
        "address1": "123 N Jones Street",
        "address2": null,
        "city": "Pasadena",
        "state": "CA",
        "zip": "91101"
      }
    ],
    "records": [
      {
        "id": 318,
        "name": "Tommy Lee Jones",
        "site": "Intelius",
        "status": "discovered",
        "age": null,
        "href": null,
        "relations": [
          "Maria Jones",
          "Jesse Jones"
        ],
        "aliases": [
          "Thom"
        ],
        "locations": [
          "Glendale, CA",
          "Pasadena, CA",
          "North Hollywood, CA"
        ],
        "reference_id": "000560228488"
      }
    ],
    "links": [
      {
        "url": "http://github.com/hayesgm",
        "title": "Github | hayesgm",
        "contains": [
          "email",
          "address"
        ]
      }
    ],
    "service_history": [
      {
        "activated_service_on": "2012/05/27 00:46:39 +0000"
      },
      {
        "deactivated_service_on": "2012/05/30 00:46:39 +0000"
      },
      {
        "activated_service_on": "2012/06/01 00:46:39 +0000"
      }
    ],
    "is_scanning": false,
    "identification_on_file": true
  }
}

Notes

While missing inputs will be ignored, blank strings will truncate if present. Phone numbers, addresses, etc. will be appended to existing.