Overview
Comprehensive guide to integrating with the Insion Content Moderation API
Getting started
To integrate with Insion, you'll use our RESTful API endpoints secured with Bearer token authentication.
Base URL
All API requests are made to the following base URL:
https://api.insion.coAuthentication
All API endpoints require authentication using a Bearer token. You can obtain your API key from your Insion dashboard.
Include the API key in the Authorization header of every request:
Authorization: Bearer YOUR_API_KEYAvailable endpoints
Our API provides endpoints for content moderation and management:
Moderate record
Moderate a record and return results immediately
Ingest record
Create or update content records for asynchronous moderation
Ingest user
Create or update a user without ingesting a record
Delete record
Remove content records from the moderation system
List records
Retrieve records for your organization
Retrieve record
Retrieve one record by its Insion ID
List users
Retrieve users for your organization
Retrieve user
Retrieve one user by its Insion ID
Create appeal
Create an appeal for a suspended user
API specification
Download the complete OpenAPI specification
Additional information
- Content accessibility: Ensure that any fileUrls provided remain accessible by Insion for as long as the record exists.
- Protected users: Users marked as protected are exempt from certain moderation actions, allowing you to safeguard administrators or trusted users.
- Retryable moderation failures: Synchronous moderation returns
503 Service Unavailablewith aRetry-Afterheader when a moderation provider cannot complete the decision. The record is persisted before moderation and can be retried safely. Asynchronous moderation remains pending and is retried automatically.
For detailed implementation guidance, refer to the endpoint documentation above. For any questions or assistance, feel free to reach out to our support team.