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

# Définir les organisations de facturation des utilisateurs

> Définir l’organisation de facturation de 100 utilisateurs au maximum.

Seuls les utilisateurs indiqués dans la requête sont concernés par la modification. Les attributions valides sont enregistrées ensemble même
si d’autres sont invalides ; une réponse `200` peut donc inclure des échecs : vérifiez toujours `failed`.
Une réponse d’erreur signifie que rien n’a été enregistré. Le renvoi d’une attribution remplace
l’organisation de facturation actuelle de l’utilisateur et ajoute une nouvelle entrée au journal d’audit.

Définit l’[organisation de facturation](https://docs.devinenterprise.com/fr/admin/billing/org-acu-limits#billing-organization-attribution) d’un maximum de 100 utilisateurs en une seule requête. Seuls les utilisateurs envoyés sont modifiés ; le reste de l’Enterprise reste inchangé. Pour modifier un seul utilisateur à la fois, l’[endpoint des paramètres utilisateur](https://docs.devinenterprise.com/fr/admin/billing/legacy-user-acu-limits#user-endpoints), en bêta, accepte également `billing_org_id`.

## Réussite partielle

Les attributions valides sont enregistrées ensemble même lorsque d’autres lignes de la même requête sont invalides ; une réponse `200` peut donc contenir des échecs. Consultez toujours `failed` : chaque entrée indique l’utilisateur, l’organisation demandée et une `reason`. L’organisation de facturation de ces utilisateurs n’a pas été modifiée ; corrigez les lignes concernées et renvoyez-les.

| `reason` | Signification |
| - | - |
| `user_not_found` | L’utilisateur n’est pas membre de l’Enterprise, ni directement ni via un groupe du fournisseur d’identité. |
| `org_not_found` | L’organisation n’appartient pas à l’Enterprise. |
| `user_not_org_member` | L’organisation n’est pas l’organisation principale de l’Enterprise et l’utilisateur n’en est pas membre. |

De nouveaux motifs pourront être ajoutés à l’avenir ; traitez donc les valeurs inconnues comme un échec plutôt que comme une erreur.

Une réponse d’erreur (`4xx` ou `5xx`) signifie qu’aucun élément de la requête n’a été enregistré. Les requêtes sans attribution, avec plus de 100 attributions ou contenant plusieurs fois le même `user_id` sont rejetées avec une erreur `422`.

Renvoyer une attribution écrase l’organisation de facturation actuelle de l’utilisateur et ajoute une nouvelle entrée au journal d’audit : les appels répétés sont donc sans risque, mais pas sans effet.

## Autorisations

Nécessite un [utilisateur de service](https://docs.devinenterprise.com/fr/api-reference/v3/service-users/members-service-users.md) ou un [jeton d’accès personnel](https://docs.devinenterprise.com/fr/api-reference/personal-access-tokens.md) disposant à la fois des autorisations `ManageBilling` et `ViewOrganizations` au niveau Enterprise. L’autorisation `ManageOrganizations` suffit également à la place de `ViewOrganizations`, puisqu’elle l’inclut.


## OpenAPI

````yaml fr/v3-openapi.yaml PUT /v3/enterprise/members/users/billing-orgs
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:
  /v3/enterprise/members/users/billing-orgs:
    put:
      tags:
        - user-billing-orgs
      summary: Définir les organisations de facturation des utilisateurs
      description: >-
        Définir l’organisation de facturation de 100 utilisateurs au maximum.


        Seuls les utilisateurs indiqués dans la requête sont concernés par la
        modification. Les attributions valides sont enregistrées ensemble même

        si d’autres sont invalides ; une réponse `200` peut donc inclure des
        échecs : vérifiez toujours `failed`.

        Une réponse d’erreur signifie que rien n’a été enregistré. Le renvoi
        d’une attribution remplace

        l’organisation de facturation actuelle de l’utilisateur et ajoute une
        nouvelle entrée au journal d’audit.
      operationId: >-
        handle_update_user_billing_orgs_v3_enterprise_members_users_billing_orgs_put
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UserBillingOrgsUpdateRequest'
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserBillingOrgsUpdateResponse'
          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
        '410':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Ressource supprimée
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Contenu impossible à traiter
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Trop de requêtes
components:
  schemas:
    UserBillingOrgsUpdateRequest:
      properties:
        assignments:
          description: >-
            Organisation de facturation à définir pour chaque utilisateur. Un
            utilisateur ne peut apparaître qu’une seule fois.
          items:
            $ref: '#/components/schemas/UserBillingOrgAssignmentRequest'
          maxItems: 100
          minItems: 1
          title: Assignments
          type: array
      required:
        - assignments
      title: UserBillingOrgsUpdateRequest
      type: object
    UserBillingOrgsUpdateResponse:
      properties:
        assigned:
          description: Attributions appliquées.
          items:
            $ref: '#/components/schemas/UserBillingOrgAssignmentResponse'
          title: Assigned
          type: array
        failed:
          description: >-
            Attributions ignorées, avec le motif correspondant. Les
            organisations de facturation de ces utilisateurs restent inchangées.
          items:
            $ref: '#/components/schemas/UserBillingOrgFailureResponse'
          title: Failed
          type: array
      required:
        - assigned
        - failed
      title: UserBillingOrgsUpdateResponse
      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
    UserBillingOrgAssignmentRequest:
      properties:
        billing_org_id:
          description: >-
            Organisation à laquelle facturer l’utilisation de Devin Desktop et
            de la CLI par l’utilisateur.
          title: Billing Org Id
          type: string
        user_id:
          description: ID de l’utilisateur de l’Enterprise.
          title: User Id
          type: string
      required:
        - user_id
        - billing_org_id
      title: UserBillingOrgAssignmentRequest
      type: object
    UserBillingOrgAssignmentResponse:
      properties:
        billing_org_id:
          description: >-
            Organisation à laquelle l’utilisation de Devin Desktop et de la CLI
            par l’utilisateur est désormais facturée.
          title: Billing Org Id
          type: string
        user_id:
          description: ID de l’utilisateur de l’Enterprise.
          title: User Id
          type: string
      required:
        - user_id
        - billing_org_id
      title: UserBillingOrgAssignmentResponse
      type: object
    UserBillingOrgFailureResponse:
      properties:
        billing_org_id:
          description: ID de l’organisation de facturation demandée.
          title: Billing Org Id
          type: string
        reason:
          $ref: '#/components/schemas/UserBillingOrgFailureReason'
          description: >-
            Motif pour lequel l’attribution a été ignorée. Si l’organisation
            n’est pas l’organisation principale de l’Enterprise, l’utilisateur
            doit en être membre. De nouveaux motifs peuvent être ajoutés ;
            prévoyez donc de gérer les valeurs inconnues.
        user_id:
          description: ID de l’utilisateur qui n’a pas été mis à jour.
          title: User Id
          type: string
      required:
        - user_id
        - billing_org_id
        - reason
      title: UserBillingOrgFailureResponse
      type: object
    UserBillingOrgFailureReason:
      enum:
        - user_not_found
        - org_not_found
        - user_not_org_member
      title: UserBillingOrgFailureReason
      type: string
  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.