aid: riot name: Riot description: >- Riot is a Paris-based employee security posture management (human risk management) platform that helps companies reduce the human attack surface. The product suite spans phishing and smishing simulation, security awareness training courses, credential breach monitoring, employee-reported email triage (Inbox), inbound email protection (Slash), and third-party SaaS/drive exposure monitoring (Sonar), fronted by a chat assistant that runs in Slack, Microsoft Teams and the web portal. Riot publishes a public REST API (OpenAPI 3.1.1, x-api-key authentication, cursor pagination, scoped keys) that exposes organization, employee, group, course, campaign, attack, breach and inbox data, a SCIM 2.0 provisioning surface for user and group lifecycle, and Standard-Webhooks server-to-server events whose payloads follow the OCSF Detection Finding schema so they can be ingested by a SIEM or SOAR without custom mapping. url: https://raw.githubusercontent.com/api-evangelist/riot/refs/heads/main/apis.yml image: https://cms-content.tryriot.com/riot_preview_305b31b839.png x-type: company x-source: harvest:secondary-market specificationVersion: '0.20' created: '2026-08-05' modified: '2026-08-05' tags: - cybersecurity - security-awareness - human-risk-management - phishing-simulation - employee-security - security-posture-management - breach-detection - email-security - saas-security - scim - webhooks - ocsf - france apis: - aid: riot:riot-awareness-api name: Riot Awareness API description: >- Provides data about courses, their settings within the workspace and employees' learning progress. humanURL: https://docs.tryriot.com/ baseURL: https://public-api.tryriot.com/v1 tags: - Awareness properties: - type: OpenAPI url: openapi/riot-awareness-api-openapi.yml - type: Documentation url: https://docs.tryriot.com/ - type: APIReference url: https://docs.tryriot.com/ - type: Authentication url: authentication/riot-authentication.yml - type: OAuthScopes url: scopes/riot-scopes.yml - type: Conventions url: conventions/riot-conventions.yml - type: Idempotency url: conventions/riot-conventions.yml - type: ErrorCatalog url: errors/riot-error-codes.yml - type: RateLimits url: rate-limits/riot-rate-limits.yml - type: DataModel url: data-model/riot-data-model.yml - type: Webhooks url: asyncapi/riot-webhooks.yml - aid: riot:riot-breaches-api name: Riot Breaches API description: The Breaches API from Riot — 3 operation(s) for breaches. humanURL: https://docs.tryriot.com/ baseURL: https://public-api.tryriot.com/v1 tags: - Breaches properties: - type: OpenAPI url: openapi/riot-breaches-api-openapi.yml - type: Documentation url: https://docs.tryriot.com/ - type: APIReference url: https://docs.tryriot.com/ - type: Authentication url: authentication/riot-authentication.yml - type: OAuthScopes url: scopes/riot-scopes.yml - type: Conventions url: conventions/riot-conventions.yml - type: Idempotency url: conventions/riot-conventions.yml - type: ErrorCatalog url: errors/riot-error-codes.yml - type: RateLimits url: rate-limits/riot-rate-limits.yml - type: DataModel url: data-model/riot-data-model.yml - type: Webhooks url: asyncapi/riot-webhooks.yml - aid: riot:riot-general-api name: Riot General API description: Provides an overview of the organization and employees' data. humanURL: https://docs.tryriot.com/ baseURL: https://public-api.tryriot.com/v1 tags: - General properties: - type: OpenAPI url: openapi/riot-general-api-openapi.yml - type: Documentation url: https://docs.tryriot.com/ - type: APIReference url: https://docs.tryriot.com/ - type: Authentication url: authentication/riot-authentication.yml - type: OAuthScopes url: scopes/riot-scopes.yml - type: Conventions url: conventions/riot-conventions.yml - type: Idempotency url: conventions/riot-conventions.yml - type: ErrorCatalog url: errors/riot-error-codes.yml - type: RateLimits url: rate-limits/riot-rate-limits.yml - type: DataModel url: data-model/riot-data-model.yml - type: Webhooks url: asyncapi/riot-webhooks.yml - aid: riot:riot-groups-api name: Riot Groups API description: The Groups API from Riot — 2 operation(s) for groups. humanURL: https://docs.tryriot.com/ baseURL: https://public-api.tryriot.com/v1 tags: - Groups properties: - type: OpenAPI url: openapi/riot-groups-api-openapi.yml - type: Documentation url: https://docs.tryriot.com/ - type: APIReference url: https://docs.tryriot.com/ - type: Authentication url: authentication/riot-authentication.yml - type: OAuthScopes url: scopes/riot-scopes.yml - type: Conventions url: conventions/riot-conventions.yml - type: Idempotency url: conventions/riot-conventions.yml - type: ErrorCatalog url: errors/riot-error-codes.yml - type: RateLimits url: rate-limits/riot-rate-limits.yml - type: DataModel url: data-model/riot-data-model.yml - type: Webhooks url: asyncapi/riot-webhooks.yml - aid: riot:riot-inbox-api name: Riot Inbox API description: The Inbox API from Riot — 3 operation(s) for inbox. humanURL: https://docs.tryriot.com/ baseURL: https://public-api.tryriot.com/v1 tags: - Inbox properties: - type: OpenAPI url: openapi/riot-inbox-api-openapi.yml - type: Documentation url: https://docs.tryriot.com/ - type: APIReference url: https://docs.tryriot.com/ - type: Authentication url: authentication/riot-authentication.yml - type: OAuthScopes url: scopes/riot-scopes.yml - type: Conventions url: conventions/riot-conventions.yml - type: Idempotency url: conventions/riot-conventions.yml - type: ErrorCatalog url: errors/riot-error-codes.yml - type: RateLimits url: rate-limits/riot-rate-limits.yml - type: DataModel url: data-model/riot-data-model.yml - type: Webhooks url: asyncapi/riot-webhooks.yml - aid: riot:riot-scim-api name: Riot SCIM API description: The SCIM API from Riot — 9 operation(s) for scim. humanURL: https://docs.tryriot.com/ baseURL: https://public-api.tryriot.com/v1 tags: - SCIM properties: - type: OpenAPI url: openapi/riot-scim-api-openapi.yml - type: Documentation url: https://docs.tryriot.com/ - type: APIReference url: https://docs.tryriot.com/ - type: Authentication url: authentication/riot-authentication.yml - type: OAuthScopes url: scopes/riot-scopes.yml - type: Conventions url: conventions/riot-conventions.yml - type: Idempotency url: conventions/riot-conventions.yml - type: ErrorCatalog url: errors/riot-error-codes.yml - type: RateLimits url: rate-limits/riot-rate-limits.yml - type: DataModel url: data-model/riot-data-model.yml - type: Webhooks url: asyncapi/riot-webhooks.yml - aid: riot:riot-simulation-api name: Riot Simulation API description: Provides data about phishing campaigns, corresponding attacks and related events. humanURL: https://docs.tryriot.com/ baseURL: https://public-api.tryriot.com/v1 tags: - Simulation properties: - type: OpenAPI url: openapi/riot-simulation-api-openapi.yml - type: Documentation url: https://docs.tryriot.com/ - type: APIReference url: https://docs.tryriot.com/ - type: Authentication url: authentication/riot-authentication.yml - type: OAuthScopes url: scopes/riot-scopes.yml - type: Conventions url: conventions/riot-conventions.yml - type: Idempotency url: conventions/riot-conventions.yml - type: ErrorCatalog url: errors/riot-error-codes.yml - type: RateLimits url: rate-limits/riot-rate-limits.yml - type: DataModel url: data-model/riot-data-model.yml - type: Webhooks url: asyncapi/riot-webhooks.yml - aid: riot:riot-slash-api name: Riot Slash API description: The Slash API from Riot — 2 operation(s) for slash. humanURL: https://docs.tryriot.com/ baseURL: https://public-api.tryriot.com/v1 tags: - Slash properties: - type: OpenAPI url: openapi/riot-slash-api-openapi.yml - type: Documentation url: https://docs.tryriot.com/ - type: APIReference url: https://docs.tryriot.com/ - type: Authentication url: authentication/riot-authentication.yml - type: OAuthScopes url: scopes/riot-scopes.yml - type: Conventions url: conventions/riot-conventions.yml - type: Idempotency url: conventions/riot-conventions.yml - type: ErrorCatalog url: errors/riot-error-codes.yml - type: RateLimits url: rate-limits/riot-rate-limits.yml - type: DataModel url: data-model/riot-data-model.yml - type: Webhooks url: asyncapi/riot-webhooks.yml - aid: riot:riot-sonar-api name: Riot Sonar API description: The Sonar API from Riot — 0 operation(s) for sonar. humanURL: https://docs.tryriot.com/ baseURL: https://public-api.tryriot.com/v1 tags: - Sonar properties: - type: OpenAPI url: openapi/riot-sonar-api-openapi.yml - type: Documentation url: https://docs.tryriot.com/ - type: APIReference url: https://docs.tryriot.com/ - type: Authentication url: authentication/riot-authentication.yml - type: OAuthScopes url: scopes/riot-scopes.yml - type: Conventions url: conventions/riot-conventions.yml - type: Idempotency url: conventions/riot-conventions.yml - type: ErrorCatalog url: errors/riot-error-codes.yml - type: RateLimits url: rate-limits/riot-rate-limits.yml - type: DataModel url: data-model/riot-data-model.yml - type: Webhooks url: asyncapi/riot-webhooks.yml - aid: riot:riot-team-awareness-api name: Riot Team awareness API description: The Team awareness API from Riot — 4 operation(s) for team awareness. humanURL: https://docs.tryriot.com/ baseURL: https://public-api.tryriot.com/v1 tags: - Team awareness properties: - type: OpenAPI url: openapi/riot-team-awareness-api-openapi.yml - type: Documentation url: https://docs.tryriot.com/ - type: APIReference url: https://docs.tryriot.com/ - type: Authentication url: authentication/riot-authentication.yml - type: OAuthScopes url: scopes/riot-scopes.yml - type: Conventions url: conventions/riot-conventions.yml - type: Idempotency url: conventions/riot-conventions.yml - type: ErrorCatalog url: errors/riot-error-codes.yml - type: RateLimits url: rate-limits/riot-rate-limits.yml - type: DataModel url: data-model/riot-data-model.yml - type: Webhooks url: asyncapi/riot-webhooks.yml - aid: riot:riot-team-inbox-api name: Riot Team inbox API description: The Team inbox API from Riot — 5 operation(s) for team inbox. humanURL: https://docs.tryriot.com/ baseURL: https://public-api.tryriot.com/v1 tags: - Team inbox properties: - type: OpenAPI url: openapi/riot-team-inbox-api-openapi.yml - type: Documentation url: https://docs.tryriot.com/ - type: APIReference url: https://docs.tryriot.com/ - type: Authentication url: authentication/riot-authentication.yml - type: OAuthScopes url: scopes/riot-scopes.yml - type: Conventions url: conventions/riot-conventions.yml - type: Idempotency url: conventions/riot-conventions.yml - type: ErrorCatalog url: errors/riot-error-codes.yml - type: RateLimits url: rate-limits/riot-rate-limits.yml - type: DataModel url: data-model/riot-data-model.yml - type: Webhooks url: asyncapi/riot-webhooks.yml - aid: riot:riot-team-platform-api name: Riot Team platform API description: The Team platform API from Riot — 15 operation(s) for team platform. humanURL: https://docs.tryriot.com/ baseURL: https://public-api.tryriot.com/v1 tags: - Team platform properties: - type: OpenAPI url: openapi/riot-team-platform-api-openapi.yml - type: Documentation url: https://docs.tryriot.com/ - type: APIReference url: https://docs.tryriot.com/ - type: Authentication url: authentication/riot-authentication.yml - type: OAuthScopes url: scopes/riot-scopes.yml - type: Conventions url: conventions/riot-conventions.yml - type: Idempotency url: conventions/riot-conventions.yml - type: ErrorCatalog url: errors/riot-error-codes.yml - type: RateLimits url: rate-limits/riot-rate-limits.yml - type: DataModel url: data-model/riot-data-model.yml - type: Webhooks url: asyncapi/riot-webhooks.yml - aid: riot:riot-team-simulation-api name: Riot Team simulation API description: The Team simulation API from Riot — 8 operation(s) for team simulation. humanURL: https://docs.tryriot.com/ baseURL: https://public-api.tryriot.com/v1 tags: - Team simulation properties: - type: OpenAPI url: openapi/riot-team-simulation-api-openapi.yml - type: Documentation url: https://docs.tryriot.com/ - type: APIReference url: https://docs.tryriot.com/ - type: Authentication url: authentication/riot-authentication.yml - type: OAuthScopes url: scopes/riot-scopes.yml - type: Conventions url: conventions/riot-conventions.yml - type: Idempotency url: conventions/riot-conventions.yml - type: ErrorCatalog url: errors/riot-error-codes.yml - type: RateLimits url: rate-limits/riot-rate-limits.yml - type: DataModel url: data-model/riot-data-model.yml - type: Webhooks url: asyncapi/riot-webhooks.yml - aid: riot:riot-webhook-events-api name: Riot Webhook Events API description: Server-to-server events Riot sends to customer-configured endpoints. humanURL: https://docs.tryriot.com/ baseURL: https://public-api.tryriot.com/v1 tags: - Webhook Events properties: - type: OpenAPI url: openapi/riot-webhook-events-api-openapi.yml - type: Documentation url: https://docs.tryriot.com/ - type: APIReference url: https://docs.tryriot.com/ - type: Authentication url: authentication/riot-authentication.yml - type: OAuthScopes url: scopes/riot-scopes.yml - type: Conventions url: conventions/riot-conventions.yml - type: Idempotency url: conventions/riot-conventions.yml - type: ErrorCatalog url: errors/riot-error-codes.yml - type: RateLimits url: rate-limits/riot-rate-limits.yml - type: DataModel url: data-model/riot-data-model.yml - type: Webhooks url: asyncapi/riot-webhooks.yml maintainers: - FN: Kin Lane email: kin@apievangelist.com - FN: APIs.json email: info@apis.io common: - type: MCPServer url: mcp/riot-mcp.yml - type: AgenticAccess url: agentic-access/riot-agentic-access.yml - type: Website url: https://tryriot.com/ - type: DeveloperPortal url: https://docs.tryriot.com/ - type: Documentation url: https://docs.tryriot.com/ - type: APIReference url: https://docs.tryriot.com/ - type: Blog url: https://tryriot.com/blog/ - type: Support url: https://tryriot.com/support/ - type: GitHubOrganization url: https://github.com/tryriot - type: Pricing url: https://tryriot.com/pricing/ - type: Login url: https://app.tryriot.com/ - type: TermsOfService url: https://tryriot.com/terms/ - type: PrivacyPolicy url: https://tryriot.com/privacy/ - type: StatusPage url: https://status.tryriot.com/ - type: ChangeLog url: https://tryriot.com/changelog/ - type: ChangeLog url: changelog/riot-changelog.yml - type: Security url: https://tryriot.com/security/ - type: TrustCenter url: security/riot-trust-center.yml - type: Compliance url: https://trust.tryriot.com/ - type: VulnerabilityDisclosure url: security/riot-vulnerability-disclosure.yml - type: DomainSecurity url: security/riot-domain-security.yml - type: SecurityTxt url: well-known/riot-security.txt - type: WellKnown url: well-known/riot-well-known.yml - type: Authentication url: authentication/riot-authentication.yml - type: OAuthScopes url: scopes/riot-scopes.yml - type: Conventions url: conventions/riot-conventions.yml - type: Idempotency url: conventions/riot-conventions.yml - type: RateLimits url: rate-limits/riot-rate-limits.yml - type: ErrorCatalog url: errors/riot-error-codes.yml - type: Lifecycle url: lifecycle/riot-lifecycle.yml - type: Conformance url: conformance/riot-conformance.yml - type: DataModel url: data-model/riot-data-model.yml - type: Webhooks url: asyncapi/riot-webhooks.yml - type: AgentSkill url: skills/_index.yml - type: LLMsTxt url: llms/riot-llms.txt - type: Overlay url: overlays/riot-public-api-overlay.yaml x-enrichment: date: '2026-08-05' status: enriched artifacts_added: 26 pass: local-v1