Saltar al contenido principal
PATCH
Actualizar un perfil de seguridad de la empresa
Actualiza un perfil de seguridad perteneciente a la empresa. Las sesiones en ejecución conservan las restricciones que se resolvieron en su último arranque o reactivación; los cambios se aplican de inmediato a las sesiones nuevas y, en el caso de las sesiones existentes, la próxima vez que se reanuden.

Permisos

Requiere un usuario de servicio o un token de acceso personal con el permiso ManageAccountSecureModeProfiles a nivel empresarial. Solo disponible en cuentas empresariales.

Comportamiento

  • Los campos omitidos no se modifican.
  • Un null explícito borra la configuración que el perfil define para net_policy, mcp_config, slack_channel_access, slack_dm_scope, teams_channel_access, teams_dm_scope y teams_group_chat_scope. En los demás campos, null se rechaza.
  • net_policy: null significa que el perfil no define ninguna configuración de red, no que se deniegue todo. Para denegar todo, usa {"allow": []}.
  • mcp_config.servers lista los servidores MCP por slug (un slug del mercado de aplicaciones, como github, o el slug de una instalación).

Autorizaciones

Authorization
string
header
requerido

Credencial de usuario de servicio (prefijo: cog_)

Parámetros de ruta

profile_id
string
requerido

Cuerpo

application/json

Semántica de PATCH: los campos omitidos no se modifican; un valor null explícito borra los campos que admiten valores nulos (net_policy, mcp_config, slack_channel_access, slack_dm_scope, teams_channel_access, teams_dm_scope, teams_group_chat_scope) y se rechaza para los demás.

devin_mcp_read_only
boolean | null
enforcement_level
enum<string> | null
Opciones disponibles:
recommended,
mandatory
git_access_level
enum<string> | null
Opciones disponibles:
read_only,
read_write
mcp_config
SecurityProfileMcpConfig · object | null
name
string | null
Required string length: 1 - 128
net_policy
SecurityProfileNetPolicy · object | null
remove_github_cli_token
boolean | null
slack_channel_access
SecurityProfileSlackChannelAccess · object | null
slack_dm_scope
enum<string> | null
Opciones disponibles:
disabled,
org_members,
workspace
teams_channel_access
SecurityProfileTeamsChannelAccess · object | null
teams_dm_scope
enum<string> | null
Opciones disponibles:
disabled,
installed_users
teams_group_chat_scope
enum<string> | null
Opciones disponibles:
disabled,
origin_chat

Respuesta

Respuesta satisfactoria

Un perfil de seguridad propiedad de una empresa, compartido con todas las organizaciones de la empresa. La empresa propietaria se deduce del token de quien realiza la llamada.

created_at
integer
requerido
devin_mcp_read_only
boolean
requerido

Cuando es true, las sesiones solo pueden invocar herramientas MCP de Devin de solo lectura (sin creación de sesiones, gestión de automatizaciones ni otras operaciones de escritura).

enforcement_level
enum<string>
requerido

los perfiles recomendados pueden sobrescribirse mediante asociaciones de niveles inferiores; los perfiles obligatorios establecen restricciones mínimas que las políticas de niveles inferiores solo pueden hacer más estrictas.

Opciones disponibles:
recommended,
mandatory
git_access_level
enum<string>
requerido
Opciones disponibles:
read_only,
read_write
name
string
requerido
profile_id
string
requerido

El ID del perfil de seguridad.

remove_github_cli_token
boolean
requerido

Cuando es true, el token de la CLI de GitHub se elimina de la máquina de la sesión, lo que impide el acceso directo a la API de GitHub.

updated_at
integer
requerido
mcp_config
SecurityProfileMcpConfig · object | null

null = este perfil no tiene preferencia respecto a MCP.

net_policy
SecurityProfileNetPolicy · object | null

null = este perfil no tiene preferencia respecto a la red (NO significa denegar todo).

slack_channel_access
SecurityProfileSlackChannelAccess · object | null

Define los canales de Slack en los que, como máximo, pueden leer y publicar las sesiones regidas por este perfil. null = este perfil no tiene preferencia y se aplica la configuración de Slack de la organización.

slack_dm_scope
enum<string> | null

Define quiénes pueden, como máximo, enviar mensajes directos a Devin en Slack con este perfil. null = este perfil no tiene preferencia y se aplica la configuración de Slack de la organización. 'workspace' se restringe a 'org_members' para las cuentas empresariales.

Opciones disponibles:
disabled,
org_members,
workspace
teams_channel_access
SecurityProfileTeamsChannelAccess · object | null

Define los canales de Microsoft Teams en los que, como máximo, pueden leer y publicar las sesiones regidas por este perfil. null = este perfil no tiene preferencia y se aplica el acceso predeterminado de Teams de la organización.

teams_dm_scope
enum<string> | null

Define a quiénes puede, como máximo, enviar Devin mensajes directos en Microsoft Teams con este perfil. null = este perfil no tiene preferencia y se aplica el acceso predeterminado de Teams de la organización.

Opciones disponibles:
disabled,
installed_users
teams_group_chat_scope
enum<string> | null

Define los chats de grupo de Teams que, como máximo, puede leer Devin con este perfil; origin_chat = solo el chat de grupo desde el que se inició la sesión; null = sin preferencia, se determina a partir del acceso predeterminado de Teams de la organización, al igual que con los mensajes directos.

Opciones disponibles:
disabled,
origin_chat