> ## Documentation Index
> Fetch the complete documentation index at: https://docs.apinizer.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Roles

> You can manage user roles, use default roles and create new roles. You can configure role-based authorization and assign necessary roles for users to perform operations in projects.

<Info>
  In Apinizer, it is not possible for a user to access a project they do not have permission for, or even perform an action that is not within their authority within the same project. Users need to have role/roles to perform operations in any project.

  When the system is first installed, commonly used roles (API Developer, API Analytics, API Manager, API Creator, Project Owner) come ready. Default roles can be used to authorize users or teams, or new roles can be defined.

  In Apinizer; there are 5 default roles: API Developer, API Analytics, API Manager, API Creator and Project Owner.
</Info>

These roles and the permissions of the roles are explained in detail below:

## Default Roles and Permissions

<AccordionGroup>
  <Accordion title="API Developer">
    **Permissions:**

    * API Spec
    * API Proxy
    * Deploy/Undeploy
    * API Proxy Group
    * Global Policy
    * Task Flows
  </Accordion>

  <Accordion title="API Tester">
    **Permissions:**

    * API Tester
  </Accordion>

  <Accordion title="API Analytics">
    **Permissions:**

    * Analytics
  </Accordion>

  <Accordion title="API Manager">
    **Permissions:**

    * API Proxy
    * Deploy/Undeploy
    * API Spec
    * API Proxy Group
    * Global Policy
    * Task Flows
  </Accordion>

  <Accordion title="API Creator">
    **Permissions:**

    * API Creation
  </Accordion>

  <Accordion title="API Security">
    **Permissions:**

    * API Security
  </Accordion>

  <Accordion title="Project Owner">
    **Permissions:**

    * API Creation
    * API Spec
    * API Proxy
    * Deploy/Undeploy
    * API Proxy Group
    * Global Policy
    * Analytics
    * Project
    * Project Members
    * API Security
    * Audit
    * Import/Export
    * API Portal Plans
    * Activate/Deactivate API Products
    * Publish on Portal
    * API Products
    * Task Flows
  </Accordion>
</AccordionGroup>

<Info>
  When a new project is opened, the user who creates the project automatically acquires the **Project Owner** role.
</Info>

If it is desired for a user or team to have more or less than the permissions in the default roles, a new role can be created that can be completely customized accordingly.

## Creating a New Role

An image containing role creation settings is shown below:

<img src="https://mintcdn.com/apinizer/d3SXEcaMWWdNYFpJ/images/yonetici/roller.png?fit=max&auto=format&n=d3SXEcaMWWdNYFpJ&q=85&s=86401657c07335630f66152cfbbd2e32" alt="Creating Role" width="1000" height="700" data-path="images/yonetici/roller.png" />

The fields used for role creation configuration are shown in the table below.

| Field                           | Description                                                                                                                                                          |
| ------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**                        | Role name information for the created role.                                                                                                                          |
| **Description**                 | A description can be written to facilitate management related to the created role.                                                                                   |
| **Authorities** *(Authorities)* | Field where the permissions that the created role will have are selected. Role permissions are added by selecting the checkbox belonging to the relevant permission. |

<Warning>
  Deleted roles are also deleted from projects and teams by the system.
</Warning>