Google Chat Integrations for Workspace Chat Integrations For Workspace Media API

The Chat Integrations For Workspace Media API from Google Chat Integrations for Workspace — 2 operation(s) for chat integrations for workspace media.

GitHub OpenAPI

Operations 2

POST /v1/spaces/{spacesId}/attachments:upload Upload media #
GET /v1/media/{mediaId} Download media #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/google-chat-integrations-for-workspace:google-chat-integrations-for-workspace-media-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

google-chat-integrations-for-workspace-media-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Google Chat Media API
  version: v1
  description: Generated from Google's published Discovery document for Google Chat API (chat v1, revision 20261108). 2 operation(s).
  contact:
    name: Google
    url: https://developers.google.com/
  termsOfService: https://developers.google.com/terms
servers:
- url: https://chat.googleapis.com
tags:
- name: Media
paths:
  /v1/spaces/{spacesId}/attachments:upload:
    post:
      operationId: chat.media.upload
      summary: Upload media
      description: 'Uploads an attachment. For an example, see Upload media as a file attachment. Requires user authentication with one of the following authorization scopes: - `https://www.googleapis.com/auth/chat.messages.create` - `https://www.googleapis.com/auth/chat.messages` - `https://www.googleapis.com/auth/chat.import` (import mode spaces only) You can upload attachments up to 200 MB. Certain file types aren''t supported. For details, see File types blocked by Google Chat.'
      parameters:
      - name: spacesId
        in: path
        required: true
        description: Resource name segment (spacesId).
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UploadAttachmentRequest'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UploadAttachmentResponse'
        4XX:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: Error response (google.rpc.Status)
      security:
      - oauth2:
        - https://www.googleapis.com/auth/chat.bot
        - https://www.googleapis.com/auth/chat.import
        - https://www.googleapis.com/auth/chat.messages
        - https://www.googleapis.com/auth/chat.messages.create
      - apiKey: []
      x-google-media-upload:
        protocols:
          simple:
            multipart: true
            path: /upload/v1/{+parent}/attachments:upload
          resumable:
            path: /resumable/upload/v1/{+parent}/attachments:upload
            multipart: true
        maxSize: '209715200'
        accept:
        - '*/*'
      tags:
      - Media
  /v1/media/{mediaId}:
    get:
      operationId: chat.media.download
      summary: Download media
      description: Downloads media. Download is supported on the URI `/v1/media/{+name}?alt=media`.
      parameters:
      - name: mediaId
        in: path
        required: true
        description: Resource name segment (mediaId).
        schema:
          type: string
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Media'
        4XX:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: 'Client error (google.rpc.Status: INVALID_ARGUMENT, PERMISSION_DENIED, NOT_FOUND ...)'
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleRpcError'
          description: Error response (google.rpc.Status)
      security:
      - oauth2:
        - https://www.googleapis.com/auth/chat.bot
        - https://www.googleapis.com/auth/chat.messages
        - https://www.googleapis.com/auth/chat.messages.readonly
      - apiKey: []
      tags:
      - Media
components:
  schemas:
    UploadAttachmentResponse:
      description: Response of uploading an attachment.
      properties:
        attachmentDataRef:
          $ref: '#/components/schemas/AttachmentDataRef'
          description: Reference to the uploaded attachment.
      type: object
    Media:
      description: Media resource.
      type: object
      properties:
        resourceName:
          description: Name of the media resource.
          type: string
    AttachmentDataRef:
      properties:
        attachmentUploadToken:
          type: string
          description: Optional. Opaque token containing a reference to an uploaded attachment. Treated by clients as an opaque string and used to create or update Chat messages with attachments.
        resourceName:
          type: string
          description: Optional. The resource name of the attachment data. This field is used with the media API to download the attachment data.
      description: A reference to the attachment data.
      type: object
    GoogleRpcError:
      type: object
      description: The error envelope every Google API returns.
      properties:
        error:
          type: object
          properties:
            code:
              type: integer
            message:
              type: string
            status:
              type: string
            details:
              type: array
              items:
                type: object
    UploadAttachmentRequest:
      type: object
      description: Request to upload an attachment.
      properties:
        filename:
          description: Required. The filename of the attachment, including the file extension.
          type: string
  securitySchemes:
    apiKey:
      type: apiKey
      in: query
      name: key
      description: API key; accepted by methods that do not need user data.
    oauth2:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://accounts.google.com/o/oauth2/auth
          tokenUrl: https://oauth2.googleapis.com/token
          scopes:
            https://www.googleapis.com/auth/chat.customemojis.readonly: View custom emoji in Google Chat
            https://www.googleapis.com/auth/chat.admin.memberships.readonly: View members and managers in conversations owned by your organization
            https://www.googleapis.com/auth/chat.app.memberships.readonly: On their own behalf, apps in Google Chat can see members of conversations and spaces
            https://www.googleapis.com/auth/chat.app.all.messages.readonly: On their own behalf, apps in Google Chat can see all messages and reactions throughout your Workspace organization, even when the Chat app isn't a member of a space or conversation
            https://www.googleapis.com/auth/chat.messages.reactions.create: Add reactions to messages in Google Chat
            https://www.googleapis.com/auth/chat.spaces.readonly: View chat and spaces in Google Chat
            https://www.googleapis.com/auth/chat.delete: Delete conversations and spaces and remove access to associated files in Google Chat
            https://www.googleapis.com/auth/chat.admin.spaces.readonly: View display name, description, and other metadata for all Google Chat conversations owned by your organization
            https://www.googleapis.com/auth/chat.app.spaces.create: On their own behalf, apps in Google Chat can create conversations and spaces
            https://www.googleapis.com/auth/chat.app.spaces.readonly: On their own behalf, apps in Google Chat can see conversations and spaces and their metadata (including history settings and access settings)
            https://www.googleapis.com/auth/chat.admin.spaces: View or edit display name, description, and other metadata for all Google Chat conversations owned by your organization
            https://www.googleapis.com/auth/chat.messages.readonly: See messages as well as their reactions and message content in Google Chat
            https://www.googleapis.com/auth/chat.app.memberships: On their own behalf, apps in Google Chat can see, add, update, and remove members from conversations and spaces
            https://www.googleapis.com/auth/chat.memberships.app: Add and remove itself from conversations and spaces in Google Chat
            https://www.googleapis.com/auth/chat.memberships: See, add, update, and remove members from conversations and spaces in Google Chat
            https://www.googleapis.com/auth/chat.spaces.create: Create new conversations and spaces in Google Chat
            https://www.googleapis.com/auth/chat.app.delete: On their own behalf, apps in Google Chat can delete conversations and spaces and remove access to associated files
            https://www.googleapis.com/auth/chat.admin.delete: Delete conversations and spaces owned by your organization and remove access to associated files in Google Chat
            https://www.googleapis.com/auth/chat.messages: See, compose, send, update, and delete messages, their content, and attached cards; add, see, and delete reactions to messages.
            https://www.googleapis.com/auth/chat.app.all.spaces.readonly: On their own behalf, apps in Google Chat can see metadata about all spaces and conversations in Google Chat throughout your Workspace organization, even when the Chat app isn't a member
            https://www.googleapis.com/auth/chat.admin.memberships: View, add, update and remove members and managers in conversations owned by your organization
            https://www.googleapis.com/auth/chat.customemojis: View, create, and delete custom emoji in Google Chat
            https://www.googleapis.com/auth/chat.spaces.pins: See, add, and remove pins in your Google Chat spaces
            https://www.googleapis.com/auth/chat.users.availability.readonly: See your availability status in Google Chat.
            https://www.googleapis.com/auth/chat.import: Import spaces, messages, and memberships into Google Chat.
            https://www.googleapis.com/auth/chat.users.sections: View, create, update, and delete your sections in Google Chat; move and list your section items in Google Chat
            https://www.googleapis.com/auth/chat.users.sections.readonly: View your sections and their section items in Google Chat
            https://www.googleapis.com/auth/chat.spaces: Create conversations and spaces and see or update metadata (including history settings and access settings) in Google Chat
            https://www.googleapis.com/auth/chat.spaces.pins.readonly: See pins in your Google Chat spaces
            https://www.googleapis.com/auth/chat.app.all.memberships.readonly: On their own behalf, apps in Google Chat can see all members in Google Chat spaces and conversations throughout your Workspace organization, even when the Chat app isn't a member
            https://www.googleapis.com/auth/chat.users.readstate: View and modify last read time for Google Chat conversations
            https://www.googleapis.com/auth/chat.app.spaces: On their own behalf, apps in Google Chat can create conversations and spaces and see or update their metadata (including history settings and access settings)
            https://www.googleapis.com/auth/chat.messages.create: Compose and send messages and attach cards
            https://www.googleapis.com/auth/chat.users.availability: See and change your availability status in Google Chat.
            https://www.googleapis.com/auth/chat.app.messages.readonly: On their own behalf, apps in Google Chat can see all messages and their associated reactions and message content
            https://www.googleapis.com/auth/chat.messages.reactions.readonly: View reactions as well as their reaction content to messages in Google Chat
            https://www.googleapis.com/auth/chat.bot: 'Private Service: https://www.googleapis.com/auth/chat.bot'
            https://www.googleapis.com/auth/chat.users.readstate.readonly: View last read time for Google Chat conversations
            https://www.googleapis.com/auth/chat.memberships.readonly: View members in Google Chat conversations.
            https://www.googleapis.com/auth/chat.messages.reactions: See, add, and delete reactions as well as their reaction content to messages in Google Chat
            https://www.googleapis.com/auth/chat.users.spacesettings: Read and update your space settings
externalDocs:
  url: https://developers.google.com/workspace/chat
x-provenance:
  method: harvested
  publisher: Google
  source: https://chat.googleapis.com/$discovery/rest?version=v1
  note: converted by discovery-to-openapi.py from Google's Discovery document (revision 20261108)