Saltar al contenido principal
POST
Crear un perfil de seguridad de la empresa
Crea un perfil de seguridad que pertenece a la empresa y se comparte con todas sus organizaciones. Las organizaciones pueden seleccionarlo, pero solo los Admin de Enterprise pueden editarlo. Para aplicarlo a nivel Enterprise, usa Establecer el perfil predeterminado de la empresa.

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

  • Solo name es obligatorio. Los nombres de perfil deben ser únicos dentro de la empresa.
  • Si se omite net_policy, el perfil parte de una lista de permitidos que contiene únicamente el host de la integración con Git (el mismo punto de partida que en la página de configuración). Un null explícito significa que el perfil no define ninguna política de red, no que se deniegue todo.
  • remove_github_cli_token tiene como valor predeterminado true. Para conservar el token (false), se requiere git_access_level: read_write y, si se establece una política de red, una lista de permitidos que incluya api.github.com.
  • git_access_level tiene como valor predeterminado read_write, y enforcement_level, recommended.

Autorizaciones

Authorization
string
header
requerido

Credencial de usuario de servicio (prefijo: cog_)

Cuerpo

application/json
name
string
requerido
Required string length: 1 - 128
devin_mcp_read_only
boolean
predeterminado:false
enforcement_level
enum<string>
predeterminado:recommended
Opciones disponibles:
recommended,
mandatory
git_access_level
enum<string>
predeterminado:read_write
Opciones disponibles:
read_only,
read_write
mcp_config
SecurityProfileMcpConfig · object | null
net_policy
SecurityProfileNetPolicy · object | null

Si se omite = una lista de permitidos que contiene únicamente el host de la integración con Git (el mismo valor predeterminado que ofrece inicialmente la interfaz de usuario de Perfiles de Seguridad); null explícito = este perfil no tiene preferencia en materia de red (NO significa denegar todo). Como la lista de permitidos predeterminada no incluye api.github.com, una solicitud con remove_github_cli_token=false debe incluir explícitamente net_policy (o null).

remove_github_cli_token
boolean
predeterminado:true
slack_channel_access
SecurityProfileSlackChannelAccess · object | null

Si se omite o es null = este perfil no tiene preferencia sobre los canales de Slack (se aplica la configuración de Slack de la organización).

slack_dm_scope
enum<string> | null

Si se omite o es null = este perfil no tiene preferencia sobre los mensajes directos de Slack (se aplica la configuración de Slack de la organización).

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

Si se omite o es null = este perfil no tiene preferencia sobre los canales de Teams (se aplica el acceso predeterminado de Teams de la organización).

teams_dm_scope
enum<string> | null

Si se omite o es null = este perfil no tiene preferencia sobre los mensajes directos de Teams (se aplica el acceso predeterminado de Teams de la organización).

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

Si se omite o es null = este perfil no tiene preferencia sobre los chats grupales de Teams (se deriva del acceso predeterminado de Teams de la organización, como ocurre con los mensajes directos).

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