> ## 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.
# Standardplattform der Organisation festlegen (Devin API)
> Legen Sie über die v3-Organisations-API fest, ob Devin-Sitzungen der Organisation standardmäßig auf einer gehosteten Plattform oder in einem Outpost-Pool ausgeführt werden, oder setzen Sie diese Einstellung zurück
Legt die organisationsweite Standardplatzierung für neue Sitzungen fest. Dies entspricht der Einstellung **Settings > Devin > Default platform** in der Webapp. Für Sitzungen, die ohne explizite `platform` erstellt werden, gilt zunächst der persönliche Standard des Erstellers und danach diese Einstellung.
Berechtigungen
Erfordert einen [Service-Benutzer](/de/api-reference/v3/service-users/members-service-users) oder ein [persönliches Zugriffstoken](/de/api-reference/personal-access-tokens) mit der Berechtigung `ManageOrgSettings` auf Organisationsebene.
Request-Felder
Senden Sie höchstens eines der folgenden Felder:
* `platform`: ein für die Organisation konfiguriertes Label einer gehosteten Plattform (zum Beispiel `linux`, `windows` oder `macos`) oder der Name eines gemeinsam genutzten Outpost-Pools; Groß-/Kleinschreibung wird nicht beachtet. Wenn ein Name auf beides zutrifft, haben Plattformen Vorrang.
* `outpost_pool_id`: die ID eines gemeinsam genutzten Outpost-Pools, der für die Organisation verfügbar ist.
Senden Sie ein leeres JSON-Objekt (`{}`) oder beide Felder als `null`, um den Standard zurückzusetzen. Der Request-Body ist erforderlich.
Nur gemeinsam genutzte Outpost-Pools sind zulässig. Persönliche Outposts können nicht als Organisationsstandard festgelegt werden, da nur ihr Eigentümer darauf Sitzungen starten kann.
Organisationen im Nur-Outposts-Modus
Wenn sich das Enterprise im Nur-Outposts-Modus befindet, werden ausschließlich Outpost-Pools akzeptiert. Labels gehosteter Plattformen führen zu einem `400`-Fehler.
Fehler
* `400`, wenn `platform` keiner konfigurierten Plattform und keinem gemeinsam genutzten Outpost-Pool entspricht, auf mehrere Outpost-Pools zutrifft oder in einer Organisation, die ausschließlich Outposts nutzt, eine gehostete Plattform angibt; oder wenn `outpost_pool_id` kein gemeinsam genutzter Pool ist, der der Organisation zur Verfügung steht. Der Fehler-Body listet die verfügbaren Plattformen und Outpost-Pools auf.
* `403`, wenn dem Aufrufer die Berechtigung `ManageOrgSettings` fehlt.
* `422`, wenn sowohl `platform` als auch `outpost_pool_id` gesetzt sind.
Beispiel
```bash theme={null}
curl -X PUT "https://api.devin.ai/v3beta1/organizations/$ORG_ID/default-platform" \
-H "Authorization: Bearer $DEVIN_API_KEY" \
-H "Content-Type: application/json" \
-d '{"platform": "gpu-pool"}'
```
## OpenAPI
````yaml de/v3-openapi.yaml PUT /v3beta1/organizations/{org_id}/default-platform
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:
/v3beta1/organizations/{org_id}/default-platform:
put:
tags:
- organization-settings
summary: Standardplattform der Organisation festlegen
description: >-
Legt die Standardausführungsumgebung der Organisation für neue Sitzungen
fest oder entfernt sie.
Akzeptiert eine Bezeichnung für eine gehostete Plattform, den Namen
eines gemeinsam genutzten Outpost-Pools
(``platform``) oder die ID eines gemeinsam genutzten Outpost-Pools
(``outpost_pool_id``).
Organisationen, die ausschließlich Outposts nutzen, akzeptieren nur
Outpost-Pools. Wird keiner dieser Werte gesendet,
wird die Standardeinstellung entfernt.
operationId: >-
handle_update_org_default_platform_v3beta1_organizations__org_id__default_platform_put
parameters:
- description: 'Organisations-ID (Präfix: org-)'
in: path
name: org_id
required: true
schema:
example: org-abc123def456
title: Org Id
type: string
requestBody:
content:
application/json:
schema:
$ref: '#/components/schemas/OrgDefaultPlatformUpdateRequest'
required: true
responses:
'200':
content:
application/json:
schema:
$ref: '#/components/schemas/OrgDefaultPlatformResponse'
description: Erfolgreiche Antwort
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Nicht autorisiert
'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
'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:
OrgDefaultPlatformUpdateRequest:
description: >-
Legen Sie den Standardausführungsort der Organisation für neue Sitzungen
fest.
Übergeben Sie höchstens einen der Parameter ``platform`` und
``outpost_pool_id``; übergeben Sie beide als
null (zum Beispiel ``{}``), um den Standard zurückzusetzen.
properties:
outpost_pool_id:
anyOf:
- maxLength: 128
type: string
- type: 'null'
description: >-
ID eines gemeinsam genutzten Outpost-Pools, der der Organisation zur
Verfügung steht.
title: Outpost Pool Id
platform:
anyOf:
- maxLength: 128
type: string
- type: 'null'
description: >-
Eine für die Organisation konfigurierte Bezeichnung einer gehosteten
Plattform (z. B. 'linux', 'windows', 'macos') oder der Name eines
gemeinsam genutzten Outpost-Pools. Groß- und Kleinschreibung werden
nicht berücksichtigt; bei gleichnamigen Plattformen und Pools haben
Plattformen Vorrang. Unbekannte Werte werden mit dem HTTP-Statuscode
400 abgelehnt; die Antwort listet die verfügbaren Plattformen und
Outpost-Pools auf.
title: Platform
title: OrgDefaultPlatformUpdateRequest
type: object
OrgDefaultPlatformResponse:
description: Der Standardausführungsort der Organisation für neue Sitzungen.
properties:
outpost_pool_id:
anyOf:
- type: string
- type: 'null'
description: >-
Outpost-Pool, in dem neue Sitzungen standardmäßig ausgeführt werden.
Null, wenn als Standard eine gehostete Plattform festgelegt ist oder
kein Standard festgelegt wurde.
title: Outpost Pool Id
outpost_pool_name:
anyOf:
- type: string
- type: 'null'
description: >-
Name des Standard-Outpost-Pools. Null, wenn als Standard kein
Outpost-Pool festgelegt ist oder der Pool der Organisation nicht
mehr zur Verfügung steht.
title: Outpost Pool Name
platform:
anyOf:
- type: string
- type: 'null'
description: >-
Bezeichnung der gehosteten Plattform (z. B. 'linux', 'windows'), auf
der neue Sitzungen standardmäßig ausgeführt werden. Null, wenn als
Standard ein Outpost-Pool festgelegt ist oder kein Standard
festgelegt wurde.
title: Platform
required:
- platform
- outpost_pool_id
- outpost_pool_name
title: OrgDefaultPlatformResponse
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
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.