> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devin.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Obtener la plataforma predeterminada de la organización (API de Devin)

> Consulta la ubicación predeterminada de las sesiones de Devin en la organización (una etiqueta de plataforma alojada o un pool de outpost) mediante la API de organización v3

Devuelve la ubicación predeterminada de las nuevas sesiones en toda la organización, es decir, el valor que aparece en **Settings > Devin > Default platform** en la webapp.

<h2 id="permissions">
  Permisos
</h2>

Requiere un [usuario de servicio](/es/api-reference/v3/service-users/members-service-users) o un [token de acceso personal](/es/api-reference/personal-access-tokens) que sea miembro de la organización.

<h2 id="behavior">
  Comportamiento
</h2>

* Un valor predeterminado alojado se devuelve en `platform` (por ejemplo, `linux` o `windows`).
* Un valor predeterminado de outpost se devuelve en `outpost_pool_id`, junto con su `outpost_pool_name` si el pool sigue disponible para la organización.
* Los tres campos son `null` cuando no hay ningún valor predeterminado configurado; en ese caso, las sesiones se ejecutan en la plataforma alojada estándar.
* El valor predeterminado personal de un usuario (la estrella del selector de plataforma en el editor de sesiones) tiene prioridad sobre este valor en las sesiones de ese usuario.


## OpenAPI

````yaml es/v3-openapi.yaml GET /v3beta1/organizations/{org_id}/default-platform
openapi: 3.1.0
info:
  description: API de Devin v3 con autenticación mediante usuario de servicio y RBAC
  title: Devin API v3
  version: 3.0.0
servers: []
security:
  - bearerAuth: []
paths:
  /v3beta1/organizations/{org_id}/default-platform:
    get:
      tags:
        - organization-settings
      summary: Obtener la plataforma predeterminada de la organización
      description: >-
        Obtener la ubicación predeterminada de la organización para las nuevas
        sesiones.


        Este es el valor predeterminado para toda la organización que se muestra
        en Settings > Devin; el

        valor predeterminado personal de un usuario, si está configurado, tiene
        prioridad para sus propias

        sesiones. Si un valor predeterminado guardado ya no está disponible para
        la

        organización, se sigue devolviendo (pero se omite al crear la sesión).
      operationId: >-
        handle_get_org_default_platform_v3beta1_organizations__org_id__default_platform_get
      parameters:
        - description: 'ID de la organización (prefijo: org-)'
          in: path
          name: org_id
          required: true
          schema:
            example: org-abc123def456
            title: Org Id
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/OrgDefaultPlatformResponse'
          description: Respuesta satisfactoria
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: No autorizado
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Prohibido
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: No encontrado
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Conflicto
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Contenido no procesable
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Demasiadas solicitudes
components:
  schemas:
    OrgDefaultPlatformResponse:
      description: >-
        Ubicación de ejecución predeterminada de la organización para las nuevas
        sesiones.
      properties:
        outpost_pool_id:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Pool de outposts en el que se ejecutan las nuevas sesiones de forma
            predeterminada. Null cuando el valor predeterminado es una
            plataforma alojada o no está definido.
          title: Outpost Pool Id
        outpost_pool_name:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Nombre del pool de outposts predeterminado. Null cuando el valor
            predeterminado no es un pool de outposts o el pool ya no está
            disponible para la organización.
          title: Outpost Pool Name
        platform:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Etiqueta de la plataforma alojada (p. ej., 'linux', 'windows') en la
            que se ejecutan las nuevas sesiones de forma predeterminada. Null
            cuando el valor predeterminado es un pool de outposts o no está
            definido.
          title: Platform
      required:
        - platform
        - outpost_pool_id
        - outpost_pool_name
      title: OrgDefaultPlatformResponse
      type: object
    ProblemDetail:
      description: >-
        Cuerpo de error RFC 9457 application/problem+json para la API v3.


        detail se conserva del cuerpo heredado {"detail": ...} por
        compatibilidad con versiones anteriores; los

        otros miembros son adicionales. errors contiene errores de validación

        a nivel de campo (solo 422).
      properties:
        detail:
          anyOf:
            - type: string
            - type: 'null'
          description: Explicación legible para humanos específica de esta ocurrencia.
          title: Detail
        error_code:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Código legible por máquina que indica el rechazo de una acción
            bloqueada (p. ej., "user_frozen", "migrated_session").
          title: Error Code
        errors:
          anyOf:
            - items:
                additionalProperties: true
                type: object
              type: array
            - type: 'null'
          description: Errores de validación por campo (solo en respuestas 422).
          title: Errors
        instance:
          anyOf:
            - type: string
            - type: 'null'
          description: Una referencia URI (la ruta de la solicitud) para esta ocurrencia.
          title: Instance
        status:
          description: El código de estado HTTP.
          title: Status
          type: integer
        title:
          description: Un breve resumen del tipo de problema, legible para humanos.
          title: Title
          type: string
        type:
          default: about:blank
          description: Una referencia URI que identifica el tipo de problema.
          title: Type
          type: string
      required:
        - title
        - status
      title: ProblemDetail
      type: object
  securitySchemes:
    bearerAuth:
      description: 'Credencial de usuario de servicio (prefijo: cog_)'
      scheme: bearer
      type: http

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.