Add or update a user

Add MCP server to your AI tool

Allow AI tools and LLMs to interact with the API documentation portal through MCP.

MCP server URL

https://api-reference.lassomoderation.com/mcp

Standard setup for AI tools providing an mcp.json file

mcp.json 
{
  "Lasso Moderation API MCP server": {
    "url": "https://api-reference.lassomoderation.com/mcp"
  }
}
Close
POST /user
Bearer auth

Add or update a user. The user is ingested asynchronously.

Default rate limit: 300 requests per minute (free workspaces: 1000 users per week).

application/json

Body

  • user object Required

    Model for a user that you can send to Lasso. If the id of the user does not yet exist a new user will be made.

    Hide user attributes Show user attributes object
    • id string Required

      Maximum length is 100.

    • name string

      Maximum length is 100.

    • created_at string(date-time)

      ISO Date e.g. 2022-07-21T18:12:39.000Z https://en.wikipedia.org/wiki/ISO_8601

    • email_domain string

      The email domain of your user. So "user@example.com" would be "example.com"

      Maximum length is 100.

    • email string

      Maximum length is 100.

    • phone_number string

      Maximum length is 100.

    • country_code string

      Two letter code according to the https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2 standard

      Minimum length is 2, maximum length is 2.

    • ip_address string

      The IP address of the user

      Maximum length is 100.

    • profile_image_url string(uri)

      Maximum length is 1400.

    • signup_method string

      The method the user has used to sign up on your platform. This can be email, google, facebook, apple, phone, twitter, or unknown.

      Maximum length is 100.

    • metadata object | null

      Extra free-form data about the object as key-value pairs. Values can be strings, numbers, booleans, null, or an object with one more level of key-value pairs.

      • The metadata may be at most 4KB (4096 bytes) when serialized as JSON.
      • Keys are not allowed to contain /.
    • category_id string

      Set this if the user is only part of a specific category. Cannot be changed after the user is created.

      Maximum length is 100.

    • type string

      Specify what kind of user this is in your platform. By default this is a "normal" user. The "state_actor" type requires the DSA compliance feature.

      Values are normal, moderator, admin, trusted, testing, or state_actor. Default value is normal.

    • status string | null

      Optional status to set the initial status of the user. This status is only applied when creating the user, not when it is updated. Use the update status API for this.

      Values are allowed, flagged, or hidden.

    • tags array[string]

      The identifiers of the tags. When tags is set, it will override all currently set tags on the user.

      Not more than 100 elements. Maximum length of each is 100.

    • published_at string(date-time) | null

      (optional) ISO Date e.g. 2022-07-21T18:12:39.000Z https://en.wikipedia.org/wiki/ISO_8601

      This field can be used to let Lasso know this object has not yet been published.

      • If the field is set to null the object is marked as not yet published.
      • If the field is set to a date, we use that date as the published date.
      • If the field is not specified, we assume the created at date as the published date. Note: this field can only be set when creating the object, use the publish endpoint to publish it.
    • photo_id_urls array[string(uri)]

      Photo IDs can be used to recognize this user's face in the content.

      Not more than 25 elements. Maximum length of each is 1400.

Responses

  • 200 application/json

    OK

    Hide response attribute Show response attribute object
    • success boolean Required
  • 400 application/json

    The request is invalid, see the error field for details

    Hide response attributes Show response attributes object
    • success boolean Required

    • error string | object Required

      A message describing the error. For validation errors this is an object with an error message per field.

      One of:
      string-1 string object-2 object
  • 401 application/json

    The API token is missing or invalid

    Hide response attributes Show response attributes object
    • success boolean Required

    • error string | object Required

      A message describing the error. For validation errors this is an object with an error message per field.

      One of:
      string-1 string object-2 object
  • 429 application/json

    The rate limit has been exceeded, check the X-RateLimit headers for limits

    Hide headers attributes Show headers attributes
    • X-RateLimit-Limit

      The rate limit interval in milliseconds

    • X-RateLimit-Remaining

      The number of requests remaining in the current interval

    • X-RateLimit-Reset

      The number of milliseconds until requests are allowed again

    Hide response attribute Show response attribute object
    • error string Required
POST /user 
curl \
 --request POST 'https://api.lassomoderation.com/api/v1/user' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '"{\n  \"user\": {\n    \"id\": \"clczbfbhh0000sa90h45xv3cg\",\n    \"created_at\": \"2022-07-21T18:12:39.000Z\",\n    \"name\": \"John Doe\",\n    \"email_domain\": \"gmail.com\",\n    \"signup_method\": \"google\",\n    \"country_code\": \"US\",\n    \"profile_image_url\": \"https://www.example.com/profile/image.png\",\n    \"tags\": [\n      \"suspicious-user\"\n    ],\n    \"metadata\": {\n      \"tag_line\": \"I am a person of mystery...\",\n      \"connections\": 8\n    }\n  }\n}"'
Request example 
{
  "user": {
    "id": "clczbfbhh0000sa90h45xv3cg",
    "created_at": "2022-07-21T18:12:39.000Z",
    "name": "John Doe",
    "email_domain": "gmail.com",
    "signup_method": "google",
    "country_code": "US",
    "profile_image_url": "https://www.example.com/profile/image.png",
    "tags": [
      "suspicious-user"
    ],
    "metadata": {
      "tag_line": "I am a person of mystery...",
      "connections": 8
    }
  }
}
Response examples (200) 
{
  "success": true
}
Response examples (400) 
{
  "success": false,
  "error": {
    "content_id": "Value can be at most 100 characters"
  }
}
Response examples (401) 
{
  "success": false,
  "error": "Invalid API key"
}
Response examples (429) 
{
  "error": "Too many requests, check headers for limits"
}