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

# Agent Permissions

> Control how others can interact with your shared agents

## Permission control

Set granular access rights to determine exactly how others can use your shared agents.

## Permission levels

<CardGroup cols={2}>
  <Card title="View" icon="eye">
    Recipients can chat with the agent but cannot make changes or see its configuration.
  </Card>

  <Card title="Use" icon="user-check">
    Recipients can use the agent in their workflows and integrations but cannot modify it.
  </Card>

  <Card title="Edit" icon="pen-to-square">
    Recipients can modify appearance, description, and basic settings, but not core functionality.
  </Card>

  <Card title="Clone" icon="copy">
    Recipients can create their own independent copy to customize completely.
  </Card>

  <Card title="Admin" icon="user-gear">
    Recipients have full control including sharing with others and modifying all aspects.
  </Card>
</CardGroup>

## Setting permissions

<Steps>
  <Step title="Share process">
    Start the sharing process from your agent's page.
  </Step>

  <Step title="Select recipients">
    Choose who you're sharing with.
  </Step>

  <Step title="Assign permissions">
    Select the appropriate permission level for each recipient or group.
  </Step>

  <Step title="Custom permissions">
    For advanced needs, click "Custom" to set specific rights individually.
  </Step>
</Steps>

## Custom permission options

| Permission      | Description                          |
| --------------- | ------------------------------------ |
| Chat            | Basic conversation access            |
| Export chat     | Allow saving conversation history    |
| View code       | See but not modify underlying code   |
| Edit appearance | Change name, avatar, description     |
| Edit behavior   | Modify main configuration settings   |
| Edit code       | Change underlying implementation     |
| Share further   | Allow recipient to share with others |
| API access      | Use agent through API endpoints      |

<Tip>
  Custom permissions give you precise control for specialized collaboration needs.
</Tip>

## Usage restrictions

Optionally set limits on shared agents:

* Conversation count limits
* Time-based access (expiration dates)
* Usage hour restrictions
* Feature limitations
* API call quotas

## Managing permissions

<Steps>
  <Step title="Access sharing settings">
    Go to your agent's page and click "Settings" then "Sharing".
  </Step>

  <Step title="View current shares">
    See a list of all users and their current permission levels.
  </Step>

  <Step title="Modify permissions">
    Select any user to change their permission level.
  </Step>

  <Step title="Revoke access">
    Click the "Remove" button to completely revoke a user's access.
  </Step>
</Steps>

<Warning>
  Permission changes take effect immediately and will affect what users can currently do with your agent.
</Warning>

## Group permissions

Create permission groups for efficient management:

1. Define a permission group (e.g., "Team Members")
2. Set permission level for the group
3. Add multiple users to the group
4. Update permissions for the entire group at once

<Info>
  Groups are especially useful for team, department, or organization-wide sharing.
</Info>

## Next steps

<Card title="Advanced Customization" icon="sliders" href="/agents/code-editor">
  Learn how to create highly customized agents with the code editor
</Card>