Saltar al contenido principal
POST
Crear un perfil de seguridad de la organización
Crea un perfil de seguridad que pertenece a la organización. Crear un perfil no lo aplica a ningún recurso; para vincularlo como valor predeterminado, usa Establecer los valores predeterminados del perfil de seguridad de la organización.

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

  • Solo name es obligatorio. Los nombres de perfil deben ser únicos dentro de la organización.
  • 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 el tráfico.
  • 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.
  • El valor predeterminado de git_access_level es read_write, y el de enforcement_level, recommended.

Autorizaciones

Authorization
string
header
requerido

Credencial de usuario de servicio (prefijo: cog_)

Parámetros de ruta

org_id
string
requerido

ID de organización (prefijo: org-)

Ejemplo:

"org-abc123def456"

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