Roles

Get Organization Roles

Retrieve a list of all roles of an organization.

SecurityNone or DevBrowser or ProductionBrowser or ProductionNativeApp and ProductionNativeFlag)

Request

path Parameters

organization_id

required

string

The organization ID.

query Parameters

limit	integer [ 1 .. 500 ] Default: 10 Applies a limit to the number of results returned. Can be used for paginating the results together with `offset`.
offset	integer >= 0 Default: 0 Skip the first `offset` results when paginating. Needs to be an integer greater or equal to zero. To be used in conjunction with `limit`.

Responses

200

Returns the response for Client wrapped Roles objects.

401

Request was not successful

403

Request was not successful

get/v1/organizations/{organization_id}/roles

Response samples

application/json

{"response": {"data": [{"object": "role",
"id": "string",
"name": "string",
"key": "string",
"description": "string",
"is_creator_eligible": true,
"permissions": [{"object": "permission",
"id": "string",
"name": "string",
"key": "string",
"description": "string",
"type": "system",
"created_at": 0,
"updated_at": 0
}
],
"created_at": 0,
"updated_at": 0
}
],
"total_count": 0
},
"client": {"object": "client",
"id": "string",
"sessions": [{"id": "string",
"object": "session",
"status": "active",
"expire_at": 0,
"abandon_at": 0,
"last_active_at": 0,
"last_active_token": {"object": "token",
"jwt": "string"
},
"actor": { },
"last_active_organization_id": "string",
"user": {"id": "string",
"object": "user",
"username": "string",
"first_name": "string",
"last_name": "string",
"image_url": "string",
"has_image": true,
"primary_email_address_id": "string",
"primary_phone_number_id": "string",
"primary_web3_wallet_id": "string",
"password_enabled": true,
"two_factor_enabled": true,
"totp_enabled": true,
"backup_code_enabled": true,
"email_addresses": [{"id": "string",
"object": "email_address",
"email_address": "string",
"reserved": true,
"verification": {"status": null,
"strategy": null,
"attempts": null,
"expire_at": null
},
"linked_to": [null
],
"matches_sso_connection": true,
"created_at": 0,
"updated_at": 0
}
],
"phone_numbers": [{"id": "string",
"object": "phone_number",
"phone_number": "string",
"reserved_for_second_factor": true,
"default_second_factor": true,
"reserved": true,
"verification": {"status": null,
"strategy": null,
"attempts": null,
"expire_at": null
},
"linked_to": [null
],
"backup_codes": [null
],
"created_at": 0,
"updated_at": 0
}
],
"web3_wallets": [{"id": "string",
"object": "web3_wallet",
"web3_wallet": "string",
"verification": {"status": null,
"strategy": null,
"attempts": null,
"expire_at": null,
"nonce": null,
"message": null
},
"created_at": 0,
"updated_at": 0
}
],
"passkeys": [{"id": "string",
"object": "passkey",
"name": "string",
"last_used_at": 0,
"verification": {"status": null,
"strategy": null,
"attempts": null,
"expire_at": null,
"nonce": null
},
"created_at": 0,
"updated_at": 0
}
],
"organization_memberships": [{"id": "string",
"object": "organization_membership",
"public_metadata": { },
"role": "string",
"role_name": "string",
"permissions": [null
],
"created_at": 0,
"updated_at": 0,
"organization": {"id": null,
"object": null,
"name": null,
"slug": null,
"image_url": null,
"has_image": null,
"members_count": null,
"pending_invitations_count": null,
"max_allowed_memberships": null,
"admin_delete_enabled": null,
"public_metadata": { },
"created_at": null,
"updated_at": null,
"logo_url": null
},
"public_user_data": {"first_name": null,
"last_name": null,
"image_url": null,
"has_image": null,
"identifier": null,
"profile_image_url": null,
"user_id": null
}
}
],
"external_accounts": [{"object": "external_account",
"id": "string",
"provider": "string",
"identification_id": "string",
"provider_user_id": "string",
"approved_scopes": "string",
"email_address": "string",
"first_name": "string",
"last_name": "string",
"avatar_url": "string",
"image_url": "string",
"username": "string",
"public_metadata": { },
"label": "string",
"created_at": 0,
"updated_at": 0,
"verification": {"status": null,
"strategy": null,
"external_verification_redirect_url": null,
"error": { },
"expire_at": null,
"attempts": null,
"verified_at_client": null
}
}
],
"saml_accounts": [{"id": "string",
"object": "saml_account",
"provider": "string",
"active": true,
"email_address": "string",
"first_name": "string",
"last_name": "string",
"provider_user_id": "string",
"public_metadata": { },
"verification": {"status": null,
"strategy": null,
"external_verification_redirect_url": null,
"error": null,
"expire_at": null,
"attempts": null
},
"saml_connection": {"id": null,
"name": null,
"domain": null,
"active": null,
"provider": null,
"sync_user_attributes": null,
"allow_subdomains": null,
"allow_idp_initiated": null,
"disable_additional_identifications": null,
"created_at": null,
"updated_at": null
}
}
],
"password_last_updated_at": 1700690400000,
"public_metadata": { },
"private_metadata": { },
"unsafe_metadata": { },
"external_id": "string",
"last_sign_in_at": 1700690400000,
"banned": true,
"locked": true,
"lockout_expires_in_seconds": 300,
"verification_attempts_remaining": 0,
"created_at": 1700690400000,
"updated_at": 1700690400000,
"delete_self_enabled": true,
"create_organization_enabled": true,
"create_organizations_limit": 0,
"last_active_at": 1700690400000,
"mfa_enabled_at": 1700690400000,
"mfa_disabled_at": 1700690400000,
"legal_accepted_at": 1700690400000,
"profile_image_url": "string"
},
"public_user_data": {"first_name": "string",
"last_name": "string",
"image_url": "string",
"has_image": true,
"identifier": "string",
"profile_image_url": "string",
"user_id": "string"
},
"factor_verification_age": [0
],
"created_at": 1700690400000,
"updated_at": 1700690400000
}
],
"sign_in": {"object": "sign_in_attempt",
"id": "string",
"status": "abandoned",
"supported_identifiers": ["email_address"
],
"supported_first_factors": [{"strategy": "ticket",
"safe_identifier": "string",
"email_address_id": "string",
"phone_number_id": "string",
"web3_wallet_id": "string",
"passkey_id": "string",
"primary": true,
"external_verification_redirect_url": "string",
"default": true
}
],
"supported_second_factors": [{"strategy": "ticket",
"safe_identifier": "string",
"email_address_id": "string",
"phone_number_id": "string",
"web3_wallet_id": "string",
"passkey_id": "string",
"primary": true,
"external_verification_redirect_url": "string",
"default": true
}
],
"first_factor_verification": {"status": "unverified",
"strategy": "password",
"attempts": 0,
"expire_at": 0
},
"second_factor_verification": {"status": "unverified",
"strategy": "phone_code",
"attempts": 0,
"expire_at": 0
},
"identifier": "string",
"user_data": {"first_name": "string",
"last_name": "string",
"image_url": "string",
"has_image": true,
"profile_image_url": "string"
},
"created_session_id": "string",
"abandon_at": 1700690400000
},
"sign_up": {"object": "sign_up_attempt",
"id": "string",
"status": "abandoned",
"required_fields": ["string"
],
"optional_fields": ["string"
],
"missing_fields": ["string"
],
"unverified_fields": ["string"
],
"verifications": {"email_address": {"next_action": "needs_prepare",
"supported_strategies": ["string"
]
},
"phone_number": {"next_action": "needs_prepare",
"supported_strategies": ["string"
]
},
"web3_wallet": {"next_action": "needs_prepare",
"supported_strategies": ["string"
]
},
"external_account": {"status": "unverified",
"strategy": "string",
"external_verification_redirect_url": "string",
"error": {"message": "string",
"long_message": "string",
"code": "string",
"meta": { },
"clerk_trace_id": "string"
},
"expire_at": 0,
"attempts": 0
}
},
"username": "string",
"email_address": "string",
"phone_number": "string",
"web3_wallet": "string",
"password_enabled": true,
"first_name": "string",
"last_name": "string",
"unsafe_metadata": { },
"public_metadata": { },
"custom_action": true,
"external_id": "string",
"created_session_id": "string",
"created_user_id": "string",
"abandon_at": 1700690400000,
"legal_accepted_at": 1700690400000
},
"last_active_session_id": "string",
"cookie_expires_at": 0,
"captcha_bypass": true,
"created_at": 0,
"updated_at": 0
}
}

➔ Next to Well Known