Criar membro de workspace de conta de serviço

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

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

Requer um token de acesso OAuth com o escopo org:admin, obtido via ant auth login --scope org:admin ou uma regra de federação de identidade de workload; chaves de Admin API não são aceitas. Consulte Gerenciar WIF com a Admin API.

Adicione uma conta de serviço a um workspace com o workspace_role informado.

A função determina o que a conta de serviço pode fazer no workspace e quais permissões com escopo de workspace podem ser concedidas a ela ao se autenticar por meio de federação. Toda conta de serviço já é membro implícito workspace_user do workspace padrão; adicioná-la explicitamente atribui uma função escolhida. Se a conta de serviço já for membro explícito do workspace, seu workspace_role é substituído pelo valor fornecido aqui. Workspaces arquivados retornam 400. Contas de serviço arquivadas não podem ser adicionadas e são rejeitadas.

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")

Criar membro de workspace de conta de serviço

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"
}