The Admin API is unavailable for individual accounts. To collaborate with teammates and add members, set up your organization in Console → Settings → Organization.
La API de administración te permite gestionar programáticamente los recursos de tu organización, incluyendo miembros de la organización, espacios de trabajo y claves API. Esto proporciona un control programático sobre tareas administrativas que de otro modo requerirían configuración manual en la Consola de Anthropic.
La API de administración requiere acceso especial
La API de administración requiere una clave API de administración especial (que comienza con sk-ant-admin...) que difiere de las claves API estándar. Solo los miembros de la organización con el rol de administrador pueden aprovisionar claves API de administración a través de la Consola de Anthropic.
Puedes listar miembros de la organización, actualizar roles de miembros y eliminar miembros.
# Listar miembros de la organizacióncurl"https://api.anthropic.com/v1/organizations/users?limit=10"\--header"anthropic-version: 2023-06-01"\--header"x-api-key: $ANTHROPIC_ADMIN_KEY"# Actualizar rol de miembrocurl"https://api.anthropic.com/v1/organizations/users/{user_id}"\--header"anthropic-version: 2023-06-01"\--header"x-api-key: $ANTHROPIC_ADMIN_KEY"\--data'{"role": "developer"}'# Eliminar miembrocurl--request DELETE "https://api.anthropic.com/v1/organizations/users/{user_id}"\--header"anthropic-version: 2023-06-01"\--header"x-api-key: $ANTHROPIC_ADMIN_KEY"
# Crear espacio de trabajocurl--request POST "https://api.anthropic.com/v1/organizations/workspaces"\--header"anthropic-version: 2023-06-01"\--header"x-api-key: $ANTHROPIC_ADMIN_KEY"\--data'{"name": "Production"}'# Listar espacios de trabajocurl"https://api.anthropic.com/v1/organizations/workspaces?limit=10&include_archived=false"\--header"anthropic-version: 2023-06-01"\--header"x-api-key: $ANTHROPIC_ADMIN_KEY"# Archivar espacio de trabajocurl--request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/archive"\--header"anthropic-version: 2023-06-01"\--header"x-api-key: $ANTHROPIC_ADMIN_KEY"
Gestiona el acceso de usuarios a espacios de trabajo específicos:
# Añadir miembro al espacio de trabajocurl--request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members"\--header"anthropic-version: 2023-06-01"\--header"x-api-key: $ANTHROPIC_ADMIN_KEY"\--data '{"user_id":"user_xxx","workspace_role":"workspace_developer"}'# Listar miembros del espacio de trabajocurl"https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members?limit=10"\--header"anthropic-version: 2023-06-01"\--header"x-api-key: $ANTHROPIC_ADMIN_KEY"# Actualizar rol de miembrocurl--request POST "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members/{user_id}"\--header"anthropic-version: 2023-06-01"\--header"x-api-key: $ANTHROPIC_ADMIN_KEY"\--data '{"workspace_role":"workspace_admin"}'# Eliminar miembro del espacio de trabajocurl--request DELETE "https://api.anthropic.com/v1/organizations/workspaces/{workspace_id}/members/{user_id}"\--header"anthropic-version: 2023-06-01"\--header"x-api-key: $ANTHROPIC_ADMIN_KEY"
Solo los miembros de la organización con el rol de administrador pueden usar la API de administración. También deben tener una clave API de administración especial (que comienza con sk-ant-admin).
No, las nuevas claves API solo pueden crearse a través de la Consola de Anthropic por razones de seguridad. La API de administración solo puede gestionar claves API existentes.
Las claves API persisten en su estado actual ya que están vinculadas a la Organización, no a usuarios individuales.
No, los miembros de la organización con el rol de administrador no pueden ser eliminados a través de la API por razones de seguridad.
Las invitaciones a la organización caducan después de 21 días. Actualmente no hay forma de modificar este período de caducidad.
Sí, puedes tener un máximo de 100 espacios de trabajo por Organización. Los espacios de trabajo archivados no cuentan para este límite.
Cada Organización tiene un “Espacio de trabajo predeterminado” que no se puede editar ni eliminar, y no tiene ID. Este Espacio de trabajo no aparece en los endpoints de lista de espacios de trabajo.
Los administradores de la organización obtienen automáticamente el rol workspace_admin en todos los espacios de trabajo. Los miembros de facturación de la organización obtienen automáticamente el rol workspace_billing. Los usuarios y desarrolladores de la organización deben ser añadidos manualmente a cada espacio de trabajo.
A los usuarios y desarrolladores de la organización se les pueden asignar roles de workspace_admin, workspace_developer o workspace_user. El rol workspace_billing no se puede asignar manualmente - se hereda al tener el rol de billing en la organización.
Solo los miembros de facturación de la organización pueden tener su rol de espacio de trabajo actualizado a un rol de administrador. De lo contrario, los administradores y miembros de facturación de la organización no pueden cambiar sus roles de espacio de trabajo ni ser eliminados de los espacios de trabajo mientras mantengan esos roles en la organización. Su acceso al espacio de trabajo debe modificarse cambiando primero su rol en la organización.
Si un administrador o miembro de facturación de la organización es degradado a usuario o desarrollador, pierde acceso a todos los espacios de trabajo excepto aquellos donde se les asignaron roles manualmente. Cuando los usuarios son promovidos a roles de administrador o facturación, obtienen acceso automático a todos los espacios de trabajo.
