--- title: "POST /applications/{application_id}/attachment" method: POST path: "/applications/{application_id}/attachment" --- # POST /applications/{application_id}/attachment `POST /applications/{application_id}/attachment` ## Response `200` 200 response for upload_application_attachment - ActivitiesAttachmentResponse - `attachment` AttachmentResponse, required - `id` string, snowflake, required - `filename` string, required - `size` integer, required - `url` string, uri, required - `proxy_url` string, uri, required - `width` integer - `height` integer - `duration_secs` number, double - `waveform` string - `description` string - `content_type` string - `ephemeral` boolean - `flags` integer - `placeholder` string - `placeholder_version` integer - `title` string, nullable - `application` ApplicationResponse - `id` string, snowflake, required - `name` string, required - `icon` string, nullable, required - `description` string, required - `type` 4, required - `cover_image` string - `primary_sku_id` string, snowflake - `bot` UserResponse - `id` string, snowflake, required - `username` string, required — the user's username, not unique across the platform - `avatar` string, nullable, required — the user's avatar hash - `discriminator` string, required — the user's Discord-tag - `public_flags` integer, required — the public flags on a user's account - `flags` integer, required - `bot` boolean — whether the user belongs to an OAuth2 application - `system` boolean — whether the user is an Official Discord System user (part of the urgent message system) - `banner` string, nullable — the user's banner hash - `accent_color` integer, nullable — the user's banner color encoded as an integer representation of hexadecimal color code - `global_name` string, nullable, required — the user's display name, if it is set - `avatar_decoration_data` UserAvatarDecorationResponse - `asset` string, required — the avatar decoration hash - `sku_id` string, snowflake, required - `collectibles` UserCollectiblesResponse - `nameplate` UserNameplateResponse, required - `sku_id` string, snowflake, required - `asset` string, required — Path to the nameplate asset - `label` string, required — The label of this nameplate. Currently unused - `palette` union, required - … - `primary_guild` UserPrimaryGuildResponse, required - `identity_guild_id` string, snowflake, required - `identity_enabled` boolean, nullable, required — whether the user is displaying the primary guild's server tag - `tag` string, nullable, required — the text of the user's server tag, limited to 4 characters - `badge` string, nullable, required — the server tag badge hash - `slug` string - `guild_id` string, snowflake - `rpc_origins` string[] - `bot_public` boolean - `bot_require_code_grant` boolean - `terms_of_service_url` string, uri - `privacy_policy_url` string, uri - `custom_install_url` string, uri - `install_params` ApplicationOAuth2InstallParamsResponse - `scopes` OAuth2Scopes[], required - union - 'identify' — allows /users/@me without email - 'email' — enables /users/@me to return an email - 'connections' — allows /users/@me/connections to return linked third-party accounts - 'guilds' — allows /users/@me/guilds to return basic information about all of a user's guilds - 'guilds.join' — allows /guilds/{guild.id}/members/{user.id} to be used for joining users to a guild - 'guilds.members.read' — allows /users/@me/guilds/{guild.id}/member to return a user's member information in a guild - 'gdm.join' — allows your app to join users to a group dm - 'bot' — for oauth2 bots, this puts the bot in the user's selected guild by default - 'rpc' — for local rpc server access, this allows you to control a user's local Discord client - requires Discord approval - 'rpc.notifications.read' — for local rpc server access, this allows you to receive notifications pushed out to the user - requires Discord approval - 'rpc.voice.read' — for local rpc server access, this allows you to read a user's voice settings and listen for voice events - requires Discord approval - 'rpc.voice.write' — for local rpc server access, this allows you to update a user's voice settings - requires Discord approval - 'rpc.video.read' — for local rpc server access, this allows you to read a user's video status - requires Discord approval - 'rpc.video.write' — for local rpc server access, this allows you to update a user's video settings - requires Discord approval - 'rpc.screenshare.read' — for local rpc server access, this allows you to read a user's screenshare status- requires Discord approval - 'rpc.screenshare.write' — for local rpc server access, this allows you to update a user's screenshare settings- requires Discord approval - 'rpc.activities.write' — for local rpc server access, this allows you to update a user's activity - requires Discord approval - 'webhook.incoming' — this generates a webhook that is returned in the oauth token response for authorization code grants - 'messages.read' — for local rpc server api access, this allows you to read messages from all client channels (otherwise restricted to channels/guilds your app creates) - 'applications.builds.upload' — allows your app to upload/update builds for a user's applications - requires Discord approval - 'applications.builds.read' — allows your app to read build data for a user's applications - 'applications.commands' — allows your app to use commands in a guild - 'applications.commands.permissions.update' — allows your app to update permissions for its commands in a guild a user has permissions to - 'applications.commands.update' — allows your app to update its commands using a Bearer token - client credentials grant only - 'applications.store.update' — allows your app to read and update store data (SKUs, store listings, achievements, etc.) for a user's applications - 'applications.entitlements' — allows your app to read entitlements for a user's applications - 'activities.read' — allows your app to fetch data from a user's "Now Playing/Recently Played" list - requires Discord approval - 'activities.write' — allows your app to update a user's activity - requires Discord approval (NOT REQUIRED FOR GAMESDK ACTIVITY MANAGER) - 'activities.invites.write' — allows your app to send activity invites - requires Discord approval (NOT REQUIRED FOR GAMESDK ACTIVITY MANAGER) - 'relationships.read' — allows your app to know a user's friends and implicit relationships - requires Discord approval - 'voice' — allows your app to connect to voice on user's behalf and see all the voice members - requires Discord approval - 'dm_channels.read' — allows your app to see information about the user's DMs and group DMs - requires Discord approval - 'role_connections.write' — allows your app to update a user's connection and metadata for the app - 'openid' — for OpenID Connect, this allows your app to receive user id and basic profile information - `permissions` string, required - `integration_types_config` object - `verify_key` string, required - `flags` integer, required - `flags_new` string, required - `max_participants` integer, nullable - `tags` string[] - `clip_created_at` string, date-time - `clip_participants` UserResponse[] - `id` string, snowflake, required - `username` string, required — the user's username, not unique across the platform - `avatar` string, nullable, required — the user's avatar hash - `discriminator` string, required — the user's Discord-tag - `public_flags` integer, required — the public flags on a user's account - `flags` integer, required - `bot` boolean — whether the user belongs to an OAuth2 application - `system` boolean — whether the user is an Official Discord System user (part of the urgent message system) - `banner` string, nullable — the user's banner hash - `accent_color` integer, nullable — the user's banner color encoded as an integer representation of hexadecimal color code - `global_name` string, nullable, required — the user's display name, if it is set - `avatar_decoration_data` UserAvatarDecorationResponse - `asset` string, required — the avatar decoration hash - `sku_id` string, snowflake, required - `collectibles` UserCollectiblesResponse - `nameplate` UserNameplateResponse, required - `sku_id` string, snowflake, required - `asset` string, required — Path to the nameplate asset - `label` string, required — The label of this nameplate. Currently unused - `palette` union, required - 'crimson' — Crimson color palette - 'berry' — Berry color palette - 'sky' — Sky color palette - 'teal' — Teal color palette - 'forest' — Forest color palette - 'bubble_gum' — Bubble gum color palette - 'violet' — Violet color palette - 'cobalt' — Cobalt color palette - 'clover' — Clover color palette - 'lemon' — Lemon color palette - 'white' — White color palette - 'black' — Black color palette - `primary_guild` UserPrimaryGuildResponse, required - `identity_guild_id` string, snowflake, required - `identity_enabled` boolean, nullable, required — whether the user is displaying the primary guild's server tag - `tag` string, nullable, required — the text of the user's server tag, limited to 4 characters - `badge` string, nullable, required — the server tag badge hash ## Other responses - `429` — Client ratelimited response - `4XX` — Client error response ## Changes - **2026-06-05** `693bf1f99bba` — 2 breaking - added `subschema #1: CRIMSON, subschema #2: BERRY, subschema #3: SKY, subschema #4: TEAL, subschema #5: FOREST, subschema #6: BUBBLE_GUM, subschema #7: VIOLET, subschema #8: COBALT, subschema #9: CLOVER, subschema #10: LEMON, subschema #11: WHITE, subschema #12: BLACK` to the `attachment/application/bot/collectibles/oneOf[#/components/schemas/UserCollectiblesResponse]/nameplate/oneOf[#/components/schemas/UserNameplateResponse]/palette` response property `oneOf` list for the response status `200` - added `subschema #1: CRIMSON, subschema #2: BERRY, subschema #3: SKY, subschema #4: TEAL, subschema #5: FOREST, subschema #6: BUBBLE_GUM, subschema #7: VIOLET, subschema #8: COBALT, subschema #9: CLOVER, subschema #10: LEMON, subschema #11: WHITE, subschema #12: BLACK` to the `attachment/clip_participants/items/collectibles/oneOf[#/components/schemas/UserCollectiblesResponse]/nameplate/oneOf[#/components/schemas/UserNameplateResponse]/palette` response property `oneOf` list for the response status `200` - **2026-05-06** `902436547978` — 1 info - added the required property `attachment/application/flags_new` to the response with the `200` status - **2026-04-22** `eb185d2add92` — 1 warning - removed the optional property `attachment/clip_events_timeline` from the response with the `200` status - …earlier changes not shown [Full history](https://skmtc.dev/discord/apis/discord-http-api-preview/changes/applications/:application_id/attachment/post.md) --- [API](https://skmtc.dev/discord/apis/discord-http-api-preview.md) · [All operations](https://skmtc.dev/discord/apis/discord-http-api-preview/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/discord/discord-http-api-preview/revisions/49efa428e0dd/schema)