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

# Manage a team with CometAPI Workspace

> Learn how to invite and remove CometAPI Workspace members, understand Workspace roles, and manage shared Organization Credits.

Use a Workspace to manage a team inside a CometAPI Organization. A Workspace defines who can participate in that team. A Workspace does not have a separate Credits balance. Requests from Workspace members use Credits that are available in the Organization context.

<Note>
  Workspace roles and Organization roles control different actions. The permission table refers to Workspace roles. Credit administration requires the Organization Owner role.
</Note>

## Workspace roles

Workspace roles control member management. They do not determine who can administer Organization Credits.

| Action                     | Available Workspace roles |
| -------------------------- | ------------------------- |
| View the member list       | Owner, Admin, Member      |
| Invite members             | Owner, Admin              |
| Cancel pending invitations | Owner, Admin              |
| Remove another member      | Owner, Admin              |

## Invite a member

To add a person to a Workspace, send an invitation from the Workspace settings.

<Steps>
  <Step title="Open Workspace settings">
    Open [Workspace settings](https://www.cometapi.com/console/workspace/setting), then select the Workspace that you want to manage.
  </Step>

  <Step title="Start an invitation">
    In the member list, select **Invite Member**.
  </Step>

  <Step title="Send the invitation">
    Enter the person's email address, then send the invitation.
  </Step>

  <Step title="Accept the invitation">
    The recipient must sign in with the invited email address and accept the invitation within 24 hours. The recipient joins with the Workspace Member role.
  </Step>
</Steps>

Workspace Owners and Workspace Admins can cancel a pending invitation from the Workspace settings.

## Remove a member

To remove a person from a Workspace, open [Workspace settings](https://www.cometapi.com/console/workspace/setting). In the member list, select the removal action for that member and confirm the change.

<Warning>
  Removing a member removes every API key record that the member created in this Workspace. If the member does not belong to another Workspace in the Organization, CometAPI also removes the Organization membership.
</Warning>

## Credit administration

API requests from Workspace members use the shared Credits that are available in the Organization context. A Workspace does not have a separate Credits balance.

Only the Organization Owner can add Credits, configure **Auto Top-Up**, or redeem a redemption code for the Organization. A Workspace Owner or Workspace Admin does not receive these billing permissions unless that person is also the Organization Owner.

To manage the shared Credits, open the [Credits page](https://www.cometapi.com/console/credits).

## FAQ

<AccordionGroup>
  <Accordion title="What is a CometAPI Workspace?">
    A CometAPI Workspace is a team membership area inside an Organization. Workspace roles control who can view and manage the member list.
  </Accordion>

  <Accordion title="How is a Workspace different from an Organization?">
    An Organization provides the shared billing context for one or more Workspaces. A Workspace manages its own members and does not have a separate Credits balance.
  </Accordion>

  <Accordion title="Who can invite or remove Workspace members?">
    A Workspace Owner or Workspace Admin can invite members, cancel pending invitations, and remove other members. All Workspace roles can view the member list.
  </Accordion>

  <Accordion title="How long is a Workspace invitation valid?">
    A Workspace invitation expires 24 hours after it is created.
  </Accordion>

  <Accordion title="Which role does an invited person receive?">
    A person who accepts a Workspace invitation joins with the Workspace Member role.
  </Accordion>

  <Accordion title="Can a Workspace Admin manage Credits?">
    No. A Workspace Admin can manage Workspace members, but Credits permissions require the Organization Owner role.
  </Accordion>

  <Accordion title="Who can add Credits or configure Auto Top-Up?">
    Only the Organization Owner can add Credits, configure Auto Top-Up, and redeem a redemption code for the Organization.
  </Accordion>

  <Accordion title="What happens when I remove a Workspace member?">
    CometAPI removes every API key record that the member created in that Workspace. If the member has no membership in another Workspace, CometAPI also removes the member from the Organization.
  </Accordion>
</AccordionGroup>

## Related links

* [Create an API key](/overview/quick-start)
* [Query balance and usage](/pricing/balance-query)
* [About pricing](/pricing/about-pricing)
* [Help Center](/support/help-center)

<script type="application/ld+json">
  {`
    {
    "@context": "https://schema.org",
    "@graph": [
      {
        "@type": "TechArticle",
        "@id": "https://apidoc.cometapi.com/workspace/overview",
        "headline": "Manage a team with CometAPI Workspace",
        "description": "Learn how to invite and remove CometAPI Workspace members, understand Workspace roles, and manage shared Organization Credits.",
        "url": "https://apidoc.cometapi.com/workspace/overview",
        "author": {
          "@type": "Organization",
          "name": "CometAPI"
        },
        "publisher": {
          "@type": "Organization",
          "name": "CometAPI",
          "url": "https://www.cometapi.com"
        }
      },
      {
        "@type": "BreadcrumbList",
        "itemListElement": [
          {
            "@type": "ListItem",
            "position": 1,
            "name": "CometAPI Docs",
            "item": "https://apidoc.cometapi.com/"
          },
          {
            "@type": "ListItem",
            "position": 2,
            "name": "Manage a team",
            "item": "https://apidoc.cometapi.com/workspace/overview"
          }
        ]
      },
      {
        "@type": "FAQPage",
        "mainEntity": [
          {
            "@type": "Question",
            "name": "What is a CometAPI Workspace?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "A CometAPI Workspace is a team membership area inside an Organization. Workspace roles control who can view and manage the member list."
            }
          },
          {
            "@type": "Question",
            "name": "How is a Workspace different from an Organization?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "An Organization provides the shared billing context for one or more Workspaces. A Workspace manages its own members and does not have a separate Credits balance."
            }
          },
          {
            "@type": "Question",
            "name": "Who can invite or remove Workspace members?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "A Workspace Owner or Workspace Admin can invite members, cancel pending invitations, and remove other members. All Workspace roles can view the member list."
            }
          },
          {
            "@type": "Question",
            "name": "How long is a Workspace invitation valid?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "A Workspace invitation expires 24 hours after it is created."
            }
          },
          {
            "@type": "Question",
            "name": "Which role does an invited person receive?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "A person who accepts a Workspace invitation joins with the Workspace Member role."
            }
          },
          {
            "@type": "Question",
            "name": "Can a Workspace Admin manage Credits?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "No. A Workspace Admin can manage Workspace members, but Credits permissions require the Organization Owner role."
            }
          },
          {
            "@type": "Question",
            "name": "Who can add Credits or configure Auto Top-Up?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "Only the Organization Owner can add Credits, configure Auto Top-Up, and redeem a redemption code for the Organization."
            }
          },
          {
            "@type": "Question",
            "name": "What happens when I remove a Workspace member?",
            "acceptedAnswer": {
              "@type": "Answer",
              "text": "CometAPI removes every API key record that the member created in that Workspace. If the member has no membership in another Workspace, CometAPI also removes the member from the Organization."
            }
          }
        ]
      }
    ]
    }
    `}
</script>