Setup
Prerequisites
Before making API calls, you need:
- A Platzi Business company with a Flexible subscription plan
- An API key — requested to the Platzi team
Making Your First Request
Test your credentials by listing company users:
curl "https://api-sls.platzi.com/production-sls-business-domains/v3/users/{company_id}?page=1&page_size=5" \
-H "x-platzi-company-api-key: YOUR_API_KEY" \
-H "User-Agent: YOUR_USER_AGENT"
A successful response returns a paginated list of users with a 200 status code.
Flexible Plans
Most write endpoints (invite, update, resend, validate, bulk-modify) only support companies with Flexible subscription plans. Requests to companies with traditional plans will return:
{
"errors": [
{
"code": "NOT_FLEXIBLE_PLAN",
"message": "Company does not have a flexible plan"
}
]
}
Exception: DELETE /v3/users/{company_id} is plan-type agnostic so that legacy companies whose only plans are non-flexible (typically expired) can still remove their users.
Rate Limits
The API enforces the following rate limits:
| Limit | Threshold |
|---|---|
| Per minute | 400 requests |
| Per 5-minute window | 15,000 requests |
Bulk operations (invite, update, delete) are processed asynchronously and have a concurrency limit of 100 users processed in parallel.