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

# Abrechnungsorganisationen der Nutzer festlegen

> Die Abrechnungsorganisation für bis zu 100 Nutzer festlegen.

Änderungen betreffen nur die übermittelten Nutzer. Gültige Zuweisungen werden gemeinsam gespeichert, auch
wenn andere ungültig sind. Daher kann eine `200`-Antwort Fehlschläge enthalten: Prüfen Sie immer `failed`.
Eine Fehlerantwort bedeutet, dass nichts gespeichert wurde. Das erneute Senden einer Zuweisung überschreibt
die aktuelle Abrechnungsorganisation des Nutzers und erzeugt einen weiteren Eintrag im Audit-Protokoll.

Legt die [Abrechnungsorganisation](https://docs.devinenterprise.com/de/admin/billing/org-acu-limits#billing-organization-attribution) für bis zu 100 Nutzer in einer einzigen Anfrage fest. Geändert werden nur die von Ihnen übermittelten Nutzer; alle übrigen Nutzer der Enterprise bleiben unverändert. Für einzelne Nutzer akzeptiert auch der [Endpunkt für Nutzereinstellungen](https://docs.devinenterprise.com/de/admin/billing/legacy-user-acu-limits#user-endpoints) (Beta) den Parameter `billing_org_id`.

## Teilweiser Erfolg

Gültige Zuweisungen werden gespeichert, auch wenn andere Zeilen derselben Anfrage ungültig sind. Eine `200`-Antwort kann daher Fehlschläge enthalten. Werten Sie immer `failed` aus: Jeder Eintrag nennt den Nutzer, die angeforderte Organisation und einen `reason`. Die Abrechnungsorganisationen dieser Nutzer wurden nicht geändert. Korrigieren Sie die betroffenen Zeilen und senden Sie sie erneut.

| `reason` | Bedeutung |
| - | - |
| `user_not_found` | Der Nutzer ist weder direkt noch über eine Gruppe eines Identity Providers Mitglied des Enterprise. |
| `org_not_found` | Die Organisation gehört nicht zum Enterprise. |
| `user_not_org_member` | Die Organisation ist nicht die primäre Organisation des Enterprise, und der Nutzer ist nicht Mitglied dieser Organisation. |

Künftig können weitere Gründe hinzukommen. Behandeln Sie unbekannte Werte daher als Fehlschlag und nicht als Fehler.

Eine Fehlerantwort (`4xx` oder `5xx`) bedeutet, dass nichts aus der Anfrage gespeichert wurde. Anfragen ohne Zuweisungen, mit mehr als 100 Zuweisungen oder mit mehrfach vorkommender `user_id` werden mit `422` abgelehnt.

Wird eine Zuweisung erneut gesendet, überschreibt sie die aktuelle Abrechnungsorganisation des Nutzers und erzeugt einen weiteren Eintrag im Audit-Protokoll. Wiederholte Aufrufe sind daher unbedenklich, aber nicht folgenlos.

## Berechtigungen

Erfordert einen [Service-Benutzer](https://docs.devinenterprise.com/de/api-reference/v3/service-users/members-service-users.md) oder ein [persönliches Zugriffstoken](https://docs.devinenterprise.com/de/api-reference/personal-access-tokens.md) mit den beiden Berechtigungen `ManageBilling` und `ViewOrganizations` auf Enterprise-Ebene. Alternativ zu `ViewOrganizations` genügt auch `ManageOrganizations`, da diese Berechtigung `ViewOrganizations` einschließt.


## OpenAPI

````yaml de/v3-openapi.yaml PUT /v3/enterprise/members/users/billing-orgs
openapi: 3.1.0
info:
  description: Devin v3 API mit Service-User-Authentifizierung und 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: Abrechnungsorganisationen der Nutzer festlegen
      description: >-
        Die Abrechnungsorganisation für bis zu 100 Nutzer festlegen.


        Änderungen betreffen nur die übermittelten Nutzer. Gültige Zuweisungen
        werden gemeinsam gespeichert, auch

        wenn andere ungültig sind. Daher kann eine `200`-Antwort Fehlschläge
        enthalten: Prüfen Sie immer `failed`.

        Eine Fehlerantwort bedeutet, dass nichts gespeichert wurde. Das erneute
        Senden einer Zuweisung überschreibt

        die aktuelle Abrechnungsorganisation des Nutzers und erzeugt einen
        weiteren Eintrag im Audit-Protokoll.
      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: Erfolgreiche Antwort
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Nicht authentifiziert
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Zugriff verweigert
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Nicht gefunden
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Konflikt
        '410':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Nicht mehr verfügbar
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Nicht verarbeitbarer Inhalt
        '429':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ProblemDetail'
          description: Zu Viele Anfragen
components:
  schemas:
    UserBillingOrgsUpdateRequest:
      properties:
        assignments:
          description: >-
            Abrechnungsorganisation, die für jeden Nutzer festgelegt werden
            soll. Ein Nutzer darf nur einmal vorkommen.
          items:
            $ref: '#/components/schemas/UserBillingOrgAssignmentRequest'
          maxItems: 100
          minItems: 1
          title: Assignments
          type: array
      required:
        - assignments
      title: UserBillingOrgsUpdateRequest
      type: object
    UserBillingOrgsUpdateResponse:
      properties:
        assigned:
          description: Angewendete Zuweisungen.
          items:
            $ref: '#/components/schemas/UserBillingOrgAssignmentResponse'
          title: Assigned
          type: array
        failed:
          description: >-
            Übersprungene Zuweisungen mit Begründung. Die
            Abrechnungsorganisationen dieser Nutzer wurden nicht geändert.
          items:
            $ref: '#/components/schemas/UserBillingOrgFailureResponse'
          title: Failed
          type: array
      required:
        - assigned
        - failed
      title: UserBillingOrgsUpdateResponse
      type: object
    ProblemDetail:
      description: >-
        RFC 9457 application/problem+json-Fehlertext für die v3-API.


        detail wird aus dem Legacy-Body {"detail": ...} aus Gründen der
        Abwärtskompatibilität beibehalten; die

        anderen Member sind additiv. errors enthält Validierungsfehler auf
        Feldebene

        (nur 422).
      properties:
        detail:
          anyOf:
            - type: string
            - type: 'null'
          description: Eine menschenlesbare Erklärung, die speziell für diesen Fall gilt.
          title: Detail
        error_code:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Maschinenlesbarer Code für die Ablehnung blockierter Aktionen (z. B.
            "user_frozen", "migrated_session").
          title: Error Code
        errors:
          anyOf:
            - items:
                additionalProperties: true
                type: object
              type: array
            - type: 'null'
          description: Validierungsfehler auf Feldebene (nur bei 422-Antworten).
          title: Errors
        instance:
          anyOf:
            - type: string
            - type: 'null'
          description: Eine URI-Referenz (der Anfragepfad) für diesen Fall.
          title: Instance
        status:
          description: Der HTTP-Statuscode.
          title: Status
          type: integer
        title:
          description: Eine kurze, menschenlesbare Zusammenfassung des Problemtyps.
          title: Title
          type: string
        type:
          default: about:blank
          description: Eine URI-Referenz, die den Problemtyp identifiziert.
          title: Type
          type: string
      required:
        - title
        - status
      title: ProblemDetail
      type: object
    UserBillingOrgAssignmentRequest:
      properties:
        billing_org_id:
          description: >-
            Organisation, der die Nutzung von Devin Desktop und CLI durch den
            Nutzer in Rechnung gestellt werden soll.
          title: Billing Org Id
          type: string
        user_id:
          description: ID des Enterprise-Nutzers.
          title: User Id
          type: string
      required:
        - user_id
        - billing_org_id
      title: UserBillingOrgAssignmentRequest
      type: object
    UserBillingOrgAssignmentResponse:
      properties:
        billing_org_id:
          description: >-
            Organisation, der die Nutzung von Devin Desktop und CLI durch den
            Nutzer nun in Rechnung gestellt wird.
          title: Billing Org Id
          type: string
        user_id:
          description: ID des Enterprise-Nutzers.
          title: User Id
          type: string
      required:
        - user_id
        - billing_org_id
      title: UserBillingOrgAssignmentResponse
      type: object
    UserBillingOrgFailureResponse:
      properties:
        billing_org_id:
          description: ID der angeforderten Abrechnungsorganisation.
          title: Billing Org Id
          type: string
        reason:
          $ref: '#/components/schemas/UserBillingOrgFailureReason'
          description: >-
            Grund, warum die Zuweisung übersprungen wurde. Bei einer anderen
            Organisation als der primären Organisation der Enterprise muss der
            Nutzer Mitglied dieser Organisation sein. Neue Gründe können
            hinzukommen; behandeln Sie daher auch unbekannte Werte.
        user_id:
          description: ID des Nutzers, der nicht aktualisiert wurde.
          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: 'Servicebenutzer-Anmeldedaten (Präfix: cog_)'
      scheme: bearer
      type: http

````

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