Saltar al contenido principal
PATCH
Actualizar un perfil de seguridad de la organización
Actualiza un perfil de seguridad que pertenece a una organización. Las sesiones en ejecución mantienen las restricciones resueltas en su último arranque o reactivación; los cambios se aplican de inmediato a las sesiones nuevas y a las existentes la próxima vez que se reanuden.

Permisos

Requiere un usuario de servicio o un token de acceso personal con el permiso ManageSecureModeProfiles a nivel de organización. Se rechazan los tokens que utiliza una sesión de Devin en ejecución, de modo que una sesión no puede modificar los perfiles que la rigen.

Comportamiento

  • Los campos omitidos no se modifican.
  • Un null explícito borra la opinión del perfil sobre net_policy, mcp_config, slack_channel_access, slack_dm_scope, teams_channel_access, teams_dm_scope y teams_group_chat_scope. Para los demás campos, null se rechaza.
  • net_policy: null significa que el perfil no tiene ninguna opinión sobre la red, no que se deniegue todo. Use {"allow": []} para denegar todo.
  • mcp_config.servers enumera 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
org_id
string
requerido

ID de organización (prefijo: org-)

Ejemplo:

"org-abc123def456"

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 que pertenece a una organización.

created_at
integer
requerido
devin_mcp_read_only
boolean
requerido

Cuando es true, las sesiones solo pueden invocar herramientas de Devin MCP 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 quedar anulados por asociaciones de niveles inferiores; los perfiles obligatorios establecen unas restricciones mínimas que las políticas de niveles inferiores solo pueden endurecer.

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

El ID del perfil de seguridad.

remove_github_cli_token
boolean
requerido

Cuando es true, se elimina el token de la CLI de GitHub 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 sobre MCP.

net_policy
SecurityProfileNetPolicy · object | null

null = este perfil no tiene preferencia en materia de red (NO significa denegar todo).

slack_channel_access
SecurityProfileSlackChannelAccess · object | null

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

slack_dm_scope
enum<string> | null

Restricción de quién puede 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

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

teams_dm_scope
enum<string> | null

Restricción de los destinatarios a los que Devin puede enviar 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

Restricción de los chats grupales de Teams que Devin puede leer con este perfil; origin_chat = solo el chat grupal desde el que se inició la sesión; null = sin preferencia, se deriva del acceso predeterminado de Teams de la organización, como ocurre con los mensajes directos.

Opciones disponibles:
disabled,
origin_chat