Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
version: 1.0.1
title: Leapsome Access Roles API
contact:
name: Support
url: https://leapsome.zendesk.com
description: The Content API enables you to export some raw data from Leapsome for usage within your own systems and beyond what the Leapsome application offers natively. Usage is restricted to a maximum of 20 requests per second when making requests in parallel. If you exceed this limit, you will receive a 429 status code.
servers:
- url: https://api.leapsome.com/v1
tags:
- name: Access Roles
paths:
/access-roles:
get:
summary: List access roles
description: 'Get a list of all access roles for the account. Returns role details including name,
scope type, and system default information.
Requires the standard Super Admin access role; for API tokens, assign that role to the API key.'
operationId: listAccessRoles
security:
- bearerAuth: []
tags:
- Access Roles
responses:
'200':
description: List of access roles
content:
application/json:
schema:
type: array
items:
$ref: '#/components/schemas/PublicAccessRole'
'401':
description: Authorization failed. Token is missing or invalid.
'403':
description: Insufficient permissions. Super Admin access role is required.
components:
schemas:
PublicAccessRole:
type: object
properties:
id:
type: string
pattern: ^[0-9a-f]{24}$
description: Access role ID
name:
type: string
description: Display name of the access role
userScopeType:
type: string
enum:
- none
- roleSpecific
- userSpecific
description: How user scope is determined for this role
isSystemDefault:
type: boolean
description: Whether this is a built-in system role
systemDefaultType:
type: string
description: System default role identifier when `isSystemDefault` is true
active:
type: boolean
description: Whether the role is active
securitySchemes:
bearerAuth:
type: http
scheme: bearer
bearerFormat: JWT