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

# Get a role

> Retrieve the details of an existing role.

### Parameters

<ParamField type="string" path="id" initialValue="wrl_cNqYX2J3s9bI2Aa" required>
  The ID of a role in your Plane workspace.
</ParamField>

### Returns

Returns a role if a valid identifier was provided, and returns an error otherwise.

<ResponseExample>
  ```json Response theme={null}
  {
    "id": "wrl_cNqYX2J3s9bI2Aa",
    "worker": "wr_5yMmVvd6Cz7Ptx",
    "title": "Software Engineer",
    "responsibilities": "Design, develop, and maintain software applications.",
    "level": 3,
    "created": "2024-01-15T00:00:00Z"
  }
  ```
</ResponseExample>