# Roles Endpoint

<EndpointPage
  breadcrumbs={[
    { label: "REST APIs", href: "/rest-api/rest-api" },
    { label: "Common", href: "/rest-api/rest-api#common" },
    { label: "Admin", href: "/rest-api/common/admin" },
    { label: "Roles Endpoint" },
  ]}
  title="Roles Endpoint"
  method="POST"
  url="https://api.gemini.com/v1/roles"
  description={<>The <InlineBadge>v1/roles</InlineBadge> endpoint will return a string of the role of the current API key. The response fields will be different for account-level and master-level API keys.</>}
  example={{
    request: {
      method: "POST",
      url: "https://api.gemini.com/v1/roles",
      headers: [
        { name: "X-GEMINI-APIKEY", value: "<string>" },
        { name: "X-GEMINI-PAYLOAD", value: "<string>" },
        { name: "X-GEMINI-SIGNATURE", value: "<string>" },
      ],
      body: {
        request: "/v1/roles",
        nonce: "<nonce>",
      },
    },
  }}
  sections={[
    {
      heading: "Headers",
      children: <SpecHeaders operationId="getRoles" />,
    },
    {
      heading: "Request Body",
      children: <SpecParams operationId="getRoles" />,
    },
    {
      heading: "Responses",
      children: <SpecResponses operationId="getRoles" />,
    },
  ]}
/>

<PageNavigation
  prev={{ label: "Rename Account", href: "/rest-api/common/admin/rename-account" }}
/>