Crear cuenta de servicio miembro del espacio de trabajo

ServiceAccountWorkspaceMember Organization.Workspaces.ServiceAccounts.Add(parameters, cancellationToken = default)

POST/v1/organizations/workspaces/{workspace_id}/service_accounts

Requiere un token de acceso OAuth con el alcance org:admin, obtenido de ant auth login --scope org:admin o de una regla de federación de identidades de carga de trabajo; no se aceptan claves de Admin API. Consulta Administrar WIF con la Admin API.

Agrega una cuenta de servicio a un espacio de trabajo con el workspace_role indicado.

El rol determina lo que la cuenta de servicio puede hacer en el espacio de trabajo y qué permisos con alcance de espacio de trabajo se le pueden otorgar al autenticarse mediante federación. Cada cuenta de servicio ya es miembro implícito workspace_user del espacio de trabajo predeterminado; agregarla explícitamente le asigna un rol elegido. Si la cuenta de servicio ya es miembro explícito del espacio de trabajo, su workspace_role se reemplaza por el valor proporcionado aquí. Los espacios de trabajo archivados devuelven 400. Las cuentas de servicio archivadas no se pueden agregar y se rechazan.

Parameters

ServiceAccountAddParams parameters

required string workspaceID⁠Path

ID of the workspace.

required string serviceAccountID

Tagged service account ID to add.

required NoBillingWorkspaceRole workspaceRole

Role to assign to the service account in this workspace.

Returns

class ServiceAccountWorkspaceMember { Type = "service_account_workspace_member"; CreatedByActorID; Implicit; /* 3 more */ }

JsonElement Type = "service_account_workspace_member"

required string? CreatedByActorID

Tagged ID (user_.../svac_...) of the actor who created this membership.

required bool? Implicit

True when this is the implicit default-workspace membership every service account has when no explicit membership exists. Implicit memberships have role workspace_user and cannot be removed.

required string ServiceAccountID

Tagged service account ID (svac_...).

required string WorkspaceID

Tagged workspace ID (wrkspc_...).

required WorkspaceRole WorkspaceRole

Role of the service account in this workspace. Service accounts cannot hold the workspace_billing role.

One of the following:

WorkspaceAdmin("workspace_admin")

WorkspaceBilling("workspace_billing")

WorkspaceDeveloper("workspace_developer")

WorkspaceRestrictedDeveloper("workspace_restricted_developer")

WorkspaceUser("workspace_user")

Crear cuenta de servicio miembro del espacio de trabajo

using System;
using Anthropic.Models.Organization.Workspaces;
using Anthropic.Models.Organization.Workspaces.ServiceAccounts;

ServiceAccountAddParams parameters = new()
{
    WorkspaceID = "workspace_id",
    ServiceAccountID = "service_account_id",
    WorkspaceRole = NoBillingWorkspaceRole.WorkspaceAdmin,
};

var serviceAccountWorkspaceMember = await client.Organization.Workspaces.ServiceAccounts.Add(parameters);

Console.WriteLine(serviceAccountWorkspaceMember);

Response 200

{
  "created_by_actor_id": "created_by_actor_id",
  "implicit": true,
  "service_account_id": "service_account_id",
  "type": "service_account_workspace_member",
  "workspace_id": "workspace_id",
  "workspace_role": "workspace_admin"
}

Returns Examples

Response 200

{
  "created_by_actor_id": "created_by_actor_id",
  "implicit": true,
  "service_account_id": "service_account_id",
  "type": "service_account_workspace_member",
  "workspace_id": "workspace_id",
  "workspace_role": "workspace_admin"
}