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

# Obtenir la plateforme par défaut de l'organisation (API Devin)

> Récupérez l'emplacement par défaut des sessions Devin de l'organisation (un libellé de plateforme hébergée ou un pool Outposts) via l'API d'organisation v3

Renvoie l'emplacement par défaut appliqué aux nouvelles sessions dans toute l'organisation, c'est-à-dire la valeur affichée sous **Settings > Devin > Default platform** dans la webapp.

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

Nécessite un [utilisateur de service](/fr/api-reference/v3/service-users/members-service-users) ou un [jeton d’accès personnel](/fr/api-reference/personal-access-tokens) membre de l’organisation.

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

* Une valeur par défaut hébergée est renvoyée dans `platform` (par exemple `linux` ou `windows`).
* Une valeur par défaut d'outpost est renvoyée dans `outpost_pool_id`, accompagnée de son `outpost_pool_name` si le pool est toujours disponible pour l'organisation.
* Les trois champs valent `null` lorsqu'aucune valeur par défaut n'est définie ; les sessions s'exécutent alors sur la plateforme hébergée standard.
* La valeur par défaut personnelle d'un utilisateur (l'étoile dans le sélecteur de plateforme du composer de session) prévaut sur cette valeur pour ses propres sessions.


## OpenAPI

````yaml fr/v3-openapi.yaml GET /v3beta1/organizations/{org_id}/default-platform
openapi: 3.1.0
info:
  description: API Devin v3 avec authentification par compte de service et RBAC
  title: Devin API v3
  version: 3.0.0
servers: []
security:
  - bearerAuth: []
paths:
  /v3beta1/organizations/{org_id}/default-platform:
    get:
      tags:
        - organization-settings
      summary: Obtenir la plateforme par défaut de l’organisation
      description: >-
        Récupère l’emplacement par défaut de l’organisation pour les nouvelles
        sessions.


        Il s’agit de l’emplacement par défaut pour toute l’organisation, affiché
        sous Settings > Devin ;

        l’emplacement personnel par défaut d’un utilisateur, s’il est défini,
        est prioritaire pour ses propres

        sessions. Un emplacement par défaut enregistré qui n’est plus accessible
        à

        l’organisation est tout de même renvoyé (mais ignoré lors de la création
        d’une session).
      operationId: >-
        handle_get_org_default_platform_v3beta1_organizations__org_id__default_platform_get
      parameters:
        - description: 'ID de l’organisation (préfixe : 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: Réponse réussie
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Non autorisé
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Accès interdit
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Introuvable
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Conflit
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Contenu non traitable
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Trop de requêtes
components:
  schemas:
    OrgDefaultPlatformResponse:
      description: >-
        Environnement d’exécution par défaut de l’organisation pour les
        nouvelles sessions.
      properties:
        outpost_pool_id:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Pool Outposts sur lequel les nouvelles sessions s’exécutent par
            défaut. Vaut null si l’environnement par défaut est une plateforme
            hébergée ou n’est pas défini.
          title: Outpost Pool Id
        outpost_pool_name:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Nom du pool Outposts par défaut. Vaut null si l’environnement par
            défaut n’est pas un pool Outposts ou si le pool n’est plus
            disponible pour l’organisation.
          title: Outpost Pool Name
        platform:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Libellé de la plateforme hébergée (p. ex. 'linux', 'windows') sur
            laquelle les nouvelles sessions s’exécutent par défaut. Vaut null si
            l’environnement par défaut est un pool Outposts ou n’est pas défini.
          title: Platform
      required:
        - platform
        - outpost_pool_id
        - outpost_pool_name
      title: OrgDefaultPlatformResponse
      type: object
    ProblemDetail:
      description: "Corps d’erreur RFC 9457 application/problem+json pour l’API v3.\n\ndetail est conservé de l’ancien corps {\"detail\": ...} pour assurer la rétrocompatibilité\_; les\nautres membres sont ajoutés de manière additive. errors contient les échecs de validation\nau niveau des champs (422 uniquement)."
      properties:
        detail:
          anyOf:
            - type: string
            - type: 'null'
          description: Explication en langage clair, spécifique à cette occurrence.
          title: Detail
        error_code:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Code exploitable par machine indiquant le refus d’une action bloquée
            (p. ex. "user_frozen", "migrated_session").
          title: Error Code
        errors:
          anyOf:
            - items:
                additionalProperties: true
                type: object
              type: array
            - type: 'null'
          description: Erreurs de validation par champ (réponses 422 uniquement).
          title: Errors
        instance:
          anyOf:
            - type: string
            - type: 'null'
          description: Une référence d’URI (le chemin de la requête) pour cette occurrence.
          title: Instance
        status:
          description: Le code d’état HTTP.
          title: Status
          type: integer
        title:
          description: Un bref résumé du type de problème, compréhensible par un humain.
          title: Title
          type: string
        type:
          default: about:blank
          description: Une référence d’URI identifiant le type de problème.
          title: Type
          type: string
      required:
        - title
        - status
      title: ProblemDetail
      type: object
  securitySchemes:
    bearerAuth:
      description: "Identifiant de compte de service (préfixe\_: cog_)"
      scheme: bearer
      type: http

````

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