> ## 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 abrufen (Devin API)
> Liest über die v3-Organisations-API die Standardplatzierung für Devin-Sitzungen der Organisation aus (ein Label einer gehosteten Plattform oder einen Outpost-Pool)
Gibt die organisationsweite Standardplatzierung für neue Sitzungen zurück, also den Wert, der in der Webapp unter **Settings > Devin > Default platform** angezeigt wird.
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), das Member der Organisation ist.
Verhalten
* Ein gehosteter Standard wird in `platform` zurückgegeben (zum Beispiel `linux` oder `windows`).
* Ein Outpost-Standard wird in `outpost_pool_id` zurückgegeben, zusammen mit dem zugehörigen `outpost_pool_name`, sofern der Pool für die Organisation noch verfügbar ist.
* Ist kein Standard festgelegt, sind alle drei Felder `null`; Sitzungen laufen dann auf der standardmäßigen gehosteten Plattform.
* Der persönliche Standard eines Nutzers (der Stern in der Plattformauswahl des Sitzungs-Composers) hat für dessen eigene Sitzungen Vorrang vor diesem Wert.
## OpenAPI
````yaml de/v3-openapi.yaml GET /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:
get:
tags:
- organization-settings
summary: Standardplattform der Organisation abrufen
description: >-
Ruft die Standardausführungsumgebung der Organisation für neue Sitzungen
ab.
Dies ist die organisationsweite Standardeinstellung unter Settings >
Devin. Die
persönliche Standardeinstellung eines Nutzers hat, sofern festgelegt,
Vorrang für dessen eigene
Sitzungen. Eine gespeicherte Standardeinstellung, die der Organisation
nicht mehr zur Verfügung
steht, wird weiterhin zurückgegeben (bei der Sitzungserstellung jedoch
ignoriert).
operationId: >-
handle_get_org_default_platform_v3beta1_organizations__org_id__default_platform_get
parameters:
- description: 'Organisations-ID (Präfix: 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: 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:
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.