> ## 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.
# Obter a plataforma padrão da organização (API do Devin)
> Consulte o posicionamento padrão das sessões do Devin na organização (um rótulo de plataforma hospedada ou um pool do outpost) por meio da API de organização v3
Retorna o posicionamento padrão de novas sessões em toda a organização, ou seja, o valor exibido em **Settings > Devin > Default platform** no webapp.
Permissões
Requer um [usuário de serviço](/pt-BR/api-reference/v3/service-users/members-service-users) ou um [token de acesso pessoal](/pt-BR/api-reference/personal-access-tokens) que seja membro da organização.
Comportamento
* Um padrão hospedado é retornado em `platform` (por exemplo, `linux` ou `windows`).
* Um padrão de outpost é retornado em `outpost_pool_id`, junto com o respectivo `outpost_pool_name` quando o pool ainda estiver disponível para a organização.
* Os três campos são `null` quando nenhum padrão está definido; nesse caso, as sessões são executadas na plataforma hospedada padrão.
* O padrão pessoal de um usuário (a estrela no seletor de plataforma do compositor de sessão) tem precedência sobre este valor nas sessões do próprio usuário.
## OpenAPI
````yaml pt-BR/v3-openapi.yaml GET /v3beta1/organizations/{org_id}/default-platform
openapi: 3.1.0
info:
description: API Devin v3 com autenticação de usuário de serviço e RBAC
title: Devin API v3
version: 3.0.0
servers: []
security:
- bearerAuth: []
paths:
/v3beta1/organizations/{org_id}/default-platform:
get:
tags:
- organization-settings
summary: Obter plataforma padrão da organização
description: >-
Obtenha o local de execução padrão da organização para novas sessões.
Este é o padrão de toda a organização exibido em Configurações > Devin;
o
padrão pessoal de um usuário, quando definido, tem precedência para suas
próprias
sessões. Um padrão armazenado que não esteja mais disponível para a
organização ainda é retornado (mas é ignorado ao criar a sessão).
operationId: >-
handle_get_org_default_platform_v3beta1_organizations__org_id__default_platform_get
parameters:
- description: 'ID da organização (prefixo: 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: Resposta bem-sucedida
'401':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Não autorizado
'403':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Proibido
'404':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Não encontrado
'409':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Conflito
'422':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Conteúdo não processável
'429':
content:
application/json:
schema:
$ref: '#/components/schemas/ProblemDetail'
description: Excesso de requisições
components:
schemas:
OrgDefaultPlatformResponse:
description: O local de execução padrão da organização para novas sessões.
properties:
outpost_pool_id:
anyOf:
- type: string
- type: 'null'
description: >-
Pool do outpost em que novas sessões são executadas por padrão. Null
quando o padrão é uma plataforma hospedada ou não está definido.
title: Outpost Pool Id
outpost_pool_name:
anyOf:
- type: string
- type: 'null'
description: >-
Nome do pool do outpost padrão. Null quando o padrão não é um pool
do outpost ou o pool não está mais disponível para a organização.
title: Outpost Pool Name
platform:
anyOf:
- type: string
- type: 'null'
description: >-
Rótulo da plataforma hospedada (por exemplo, 'linux', 'windows') em
que novas sessões são executadas por padrão. Null quando o padrão é
um pool do outpost ou não está definido.
title: Platform
required:
- platform
- outpost_pool_id
- outpost_pool_name
title: OrgDefaultPlatformResponse
type: object
ProblemDetail:
description: >-
Corpo de erro RFC 9457 application/problem+json da API v3.
detail é mantido do corpo legado {"detail": ...} por
retrocompatibilidade; os
outros membros são aditivos. errors contém falhas de validação em nível
de campo
(apenas 422).
properties:
detail:
anyOf:
- type: string
- type: 'null'
description: Uma explicação legível por humanos específica para esta ocorrência.
title: Detail
error_code:
anyOf:
- type: string
- type: 'null'
description: >-
Código legível por máquina para recusas de ações bloqueadas (por
exemplo, "user_frozen", "migrated_session").
title: Error Code
errors:
anyOf:
- items:
additionalProperties: true
type: object
type: array
- type: 'null'
description: Erros de validação no nível do campo (apenas respostas 422).
title: Errors
instance:
anyOf:
- type: string
- type: 'null'
description: >-
Uma referência de URI (o caminho da requisição) para esta
ocorrência.
title: Instance
status:
description: O código de status HTTP.
title: Status
type: integer
title:
description: Um breve resumo do tipo de problema, legível para humanos.
title: Title
type: string
type:
default: about:blank
description: Uma referência de URI que identifica o tipo de problema.
title: Type
type: string
required:
- title
- status
title: ProblemDetail
type: object
securitySchemes:
bearerAuth:
description: 'Credencial de usuário de serviço (prefixo: cog_)'
scheme: bearer
type: http
````
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.