Aplicações Admin

Uma aplicação é um cliente OAuth2 que pode possuir uma conta de bot. Estas rotas inspecionam aplicações e transferem sua propriedade.

Esses registros são os mesmos servidos pelo recurso público de Aplicações. Criação, exclusão, renomeação, criação de bot, edição de URI de redirecionamento e rotação de credenciais estão disponíveis apenas por meio desse recurso.

As operações Admin relatam apenas os metadados de credencial

O objeto de aplicação Admin relata se um segredo do cliente ou hash do token do bot está armazenado, quando foi criado, e a visualização do token do bot não secreta.

Objeto Admin application

A visão de administrador de uma aplicação. Uma aplicação e sua conta de bot compartilham um identificador, portanto, uma aplicação que possui um bot relata o mesmo snowflake em id e bot_user_id.

Estrutura

Campo	Tipo	Descrição
id	snowflake	O ID da aplicação
name	string	O nome de exibição (1-256 caracteres)
owner_user_id	snowflake	O ID da conta proprietária
owner_username1	?string	O nome de usuário do proprietário
owner_global_name1	?string	O nome de exibição do proprietário, ou nulo quando não definido
owner_discriminator1	?string	O discriminador do proprietário, como quatro dígitos decimais com zeros à esquerda
bot_user_id	?snowflake	O ID da conta de bot, ou nulo quando a aplicação não tem bot
bot_username2	?string	O nome de usuário do bot
bot_global_name2	?string	O nome de exibição do bot, ou nulo quando não definido
bot_discriminator2	?string	O discriminador do bot, como quatro dígitos decimais com zeros à esquerda
bot_is_public	boolean	Se uma conta diferente do proprietário pode adicionar o bot
bot_require_code_grant	boolean	Se a adição do bot requer uma concessão de código de autorização concluída
oauth2_redirect_uris3	array[string]	As URIs de redirecionamento OAuth2 registradas (no máximo 10 entradas)
has_client_secret	boolean	Se um hash do segredo do cliente está armazenado
has_bot_token	boolean	Se um hash do token do bot está armazenado
bot_token_preview	?string	A visualização final não secreta do token do bot, ou nulo quando nenhum estiver armazenado
bot_token_created_at	?ISO8601 timestamp	Quando o token do bot foi criado, ou nulo quando nenhum estiver armazenado
client_secret_created_at4	?ISO8601 timestamp	Quando o segredo do cliente foi criado
version5	integer	A versão de bloqueio otimista do registro armazenado (0-2147483647)

¹ Nulo quando nenhuma conta com owner_user_id existe

² Nulo quando a aplicação não possui bot, e também nulo quando nenhuma conta com bot_user_id existe

³ O conjunto armazenado não chega em nenhuma ordem garantida

⁴ Nulo quando nenhum segredo do cliente está armazenado, e nulo para a aplicação Admin integrada

⁵ Incrementado por toda alteração armazenada, incluindo uma feita por meio do recurso público de Aplicações

Exemplo

{
  "id": "1501314428688998182",
  "name": "Metronome",
  "owner_user_id": "1483920011884392448",
  "owner_username": "wren",
  "owner_global_name": "Wren",
  "owner_discriminator": "0042",
  "bot_user_id": "1501314428688998182",
  "bot_username": "metronome",
  "bot_global_name": null,
  "bot_discriminator": "0001",
  "bot_is_public": true,
  "bot_require_code_grant": false,
  "oauth2_redirect_uris": ["https://example.com/oauth2/callback"],
  "has_client_secret": true,
  "has_bot_token": true,
  "bot_token_preview": "kQ9x",
  "bot_token_created_at": "2026-02-11T09:14:02.117Z",
  "client_secret_created_at": "2026-02-11T09:13:58.004Z",
  "version": 7
}

A aplicação Admin integrada

O Decoding Chat serve uma aplicação sintética para o seu próprio cliente OAuth2 Admin. A aplicação não possui bot, portanto todos os campos bot_ são nulos ou false e has_bot_token é false. Ele também relata estes valores:

• id é a constante fixa 1234567890123456789.
• name é Decoding Chat Admin, e owner_user_id é a conta de sistema 0.
• oauth2_redirect_uris possui uma entrada, o endpoint Admin configurado seguido de /oauth2_callback.
• has_client_secret é verdadeiro em cada resposta que retorna esta aplicação, e client_secret_created_at é nulo.
• version é sempre 1.

A aplicação integrada é somente leitura

Get application retorna a aplicação apenas enquanto um segredo do cliente Admin estiver configurado para a implantação, e retorna um application nulo caso contrário. List applications nunca o retorna. Transfer application ownership responde 403 FORBIDDEN.

List applications

GET/v1/admin/applicationsAudit reason

Retorna os objetos Admin application selecionados por exatamente um de owner_id e guild_id. Exige application:lookup ou application:list:by_owner.

A rota retorna a seleção completa em uma resposta. Não há cursor, limite e nenhuma busca por nome.

Parâmetros de consulta

Campo	Tipo	Descrição
owner_id?1 2	snowflake	Seleciona as aplicações pertencentes a esta conta
guild_id?1 3	snowflake	Seleciona as aplicações cuja conta de bot é membro desta guilda

¹ Fornecer ambos falha com 400 INVALID_FORM_BODY reportado em guild_id, e fornecer nenhum falha em owner_id

² Um owner_id nomeando nenhuma conta falha com 404 UNKNOWN_USER

³ Um guild_id nomeando nenhuma guilda falha com 404 UNKNOWN_GUILD

owner_id retorna todas as aplicações que a conta possui, com ou sem bot. guild_id retorna uma aplicação apenas enquanto sua própria conta de bot for membro daquela guilda.

Corpo da resposta

Campo	Tipo	Descrição
applications1	array[objeto Admin application]	As aplicações selecionadas

¹ Nenhuma ordem é garantida e o array fica vazio quando a conta não possui aplicações ou a guilda não possui membro bot

Resposta

Status	Corpo	Condição
200	corpo da resposta	As aplicações selecionadas foram retornadas
404	resposta de erro	UNKNOWN_USER quando owner_id não nomeia nenhuma conta, ou UNKNOWN_GUILD quando guild_id não nomeia nenhuma guilda

Efeitos colaterais

A operação registra uma entrada de auditoria Admin com a chave de metadados application_count. Uma solicitação owner_id registra a ação list_user_applications, o tipo de alvo user e o proprietário como ID do alvo. Uma solicitação guild_id registra a ação list_guild_applications, o tipo de alvo guild e a guilda como ID do alvo. Uma solicitação com falha não registra nada.

Limite de taxa

200 solicitações por minuto para cada usuário autenticado, no bucket admin:lookup.

Get application

GET/v1/admin/applications/{application_id}Audit reason

Retorna um objeto Admin application contido em um objeto de membro único. Exige application:lookup.

O Decoding Chat responde 200 com application definido como nulo quando o ID não nomeia nenhuma aplicação.

Parâmetros de caminho

Campo	Tipo	Descrição
application_id	snowflake	O ID da aplicação

Corpo da resposta

Campo	Tipo	Descrição
application1	?objeto Admin application	A aplicação resolvida ou nulo quando nenhuma aplicação possui esse ID

¹ Também nulo para a aplicação Admin integrada em uma implantação sem o segredo do cliente Admin configurado

Resposta

Status	Corpo	Condição
200	corpo da resposta	A busca foi concluída, independentemente de ter resolvido ou não a aplicação

Efeitos colaterais

A operação registra uma entrada de auditoria Admin com a ação get_application, tipo de alvo application, o caminho application_id como ID do alvo, e a chave de metadados found. found é true quando application é um objeto e false quando é nulo. Uma aplicação retornada adiciona owner_user_id e bot_user_id quando a aplicação tem um bot.

Limite de taxa

200 solicitações por minuto para cada usuário autenticado, no bucket admin:lookup.

Transfer application ownership

PATCH/v1/admin/applications/{application_id}Audit reason

Move a aplicação para outra conta e retorna o objeto Admin application armazenado. Exige application:transfer_ownership.

A propriedade é o único campo que esta operação grava. O novo proprietário pode ser qualquer conta existente e o Decoding Chat não notifica o proprietário anterior.

Parâmetros de caminho

Campo	Tipo	Descrição
application_id	snowflake	O ID da aplicação

Corpo JSON

Campo	Tipo	Descrição
new_owner_id1	snowflake	A conta para a qual transferir a aplicação

¹ Uma aplicação desconhecida falha com 404 UNKNOWN_APPLICATION, e um proprietário substituto desconhecido falha com 404 UNKNOWN_USER. O Decoding Chat pesquisa primeiro a aplicação, portanto, uma solicitação em que ambos são desconhecidos falha com UNKNOWN_APPLICATION

Corpo da resposta

Campo	Tipo	Descrição
application	objeto Admin application	A aplicação como foi armazenada após a transferência

Resposta

Status	Corpo	Condição
200	corpo da resposta	A propriedade foi transferida
403	resposta de erro	FORBIDDEN porque o alvo é a aplicação Admin integrada
404	resposta de erro	UNKNOWN_APPLICATION para a aplicação, ou UNKNOWN_USER para o proprietário substituto

Efeitos colaterais

A transferência altera owner_user_id, incrementa a version e atualiza os resultados de List applications e List user applications. Ela não emite nenhum Despacho de Gateway.

O Decoding Chat registra uma entrada de auditoria Admin com o tipo de alvo application, o ID do alvo igual ao ID da aplicação, e a ação transfer_ownership. Seus metadados são old_owner_id e new_owner_id. Nenhum dos proprietários é resolvido em related_users.

Limite de taxa

100 solicitações por minuto para cada usuário autenticado, no bucket admin:guild:modify.