Update status

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

{
  "Lasso Moderation API MCP server": {
    "url": "https://api-reference.lassomoderation.com/mcp"
  }
}

PUT /status

Bearer auth

Update the status of content, users or subcategories. This endpoint should only be used if you have actions that change the object's status. Call this endpoint if you want to sync the status of the object(s) with Lasso.

IDs that don't exist in Lasso are silently ignored. Updating the status of content that already has a newer version returns a 400 error.

Default rate limit: 300 requests per minute.

application/json

Body

Send status updates in bulk by sending a list of IDs, or send a single ID in a list. Optionally, you can send the email of a moderator if you want to attribute the action to this moderator. Otherwise, it will by default attribute it to the API bot.

status string | null Required

The status of an object

Values are allowed, flagged, or hidden.
moderator_email string(email)
content_ids array[string]

Maximum length of each is 100.
subcategory_ids array[string]

Maximum length of each is 100.
user_ids array[string]

Maximum length of each is 100.
temporary object

Can be used when temporarily hiding/banning a user. To ban a user for 2 weeks, set ban_duration to 2 and the ban_duration_period to week. Only applied when setting users to hidden. For a user who is already hidden, the latest request replaces the current ban. Without temporary the ban becomes permanent, with temporary it ends after the new duration. Re-sending a ban of the same duration changes nothing and does not restart it.

Additional properties are NOT allowed.
Hide temporary attributes Show temporary attributes object
- ban_duration number
- ban_duration_period string
  
  Values are hour, day, or week.
policy_id string

The id of the policy that is used for the status change
scope string

What the content status changes are a decision about. Use account when you remove content because you removed or banned its author, not because of the content itself. The content gets the new status, but it is left out of false positives and false negatives in the dashboard and analytics. A later status change without account makes it a content decision again. Only applies to content_ids.

Values are content or account. Default value is content.
category_id string

Required when updating subcategories

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

PUT /status

curl \
 --request PUT 'https://api.lassomoderation.com/api/v1/status' \
 --header "Authorization: Bearer $ACCESS_TOKEN" \
 --header "Content-Type: application/json" \
 --data '{
  "status": "hidden",
  "moderator_email": "moderator@example.com",
  "content_ids": [
    "clemwm8ix0007sa8stctcndvj"
  ]
}'

Request examples

{
  "status": "hidden",
  "moderator_email": "moderator@example.com",
  "content_ids": [
    "clemwm8ix0007sa8stctcndvj"
  ]
}

{
  "status": "allowed",
  "user_ids": [
    "cleslnvoo0006ukjygou5r4r6"
  ],
  "content_ids": [
    "clf43i7hw00nusax3u298ucmu",
    "clf43i6v600ltsax3mjdko2r1"
  ]
}

{
  "status": "hidden",
  "scope": "account",
  "content_ids": [
    "clf43i7hw00nusax3u298ucmu",
    "clf43i6v600ltsax3mjdko2r1"
  ]
}

{
  "status": "hidden",
  "user_ids": [
    "cleslnvoo0006ukjygou5r4r6"
  ],
  "policy_id": "harassment",
  "temporary": {
    "ban_duration": 2,
    "ban_duration_period": "week"
  }
}

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"
}