Google Vertex AI Vertex Ai Media API

The Vertex Ai Media API from Google Vertex AI — 1 operation(s) for vertex ai media.

GitHub OpenAPI

Operations 1

POST /v1/projects/{projectsId}/locations/{locationsId}/ragCorpora/{ragCorporaId}/ragFiles:upload Upload 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-vertex-ai:google-vertex-ai-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-vertex-ai-media-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Agent Platform Media API
  version: v1
  description: Generated from Google's published Discovery document for Agent Platform API (aiplatform v1, revision 20261106). 1 operation(s).
  contact:
    name: Google
    url: https://developers.google.com/
  termsOfService: https://developers.google.com/terms
servers:
- url: https://aiplatform.googleapis.com
tags:
- name: Media
paths:
  /v1/projects/{projectsId}/locations/{locationsId}/ragCorpora/{ragCorporaId}/ragFiles:upload:
    post:
      operationId: aiplatform.media.upload
      summary: Upload media
      description: Upload a file into a RagCorpus.
      parameters:
      - name: projectsId
        in: path
        required: true
        description: Resource name segment (projectsId).
        schema:
          type: string
      - name: locationsId
        in: path
        required: true
        description: Resource name segment (locationsId).
        schema:
          type: string
      - name: ragCorporaId
        in: path
        required: true
        description: Resource name segment (ragCorporaId).
        schema:
          type: string
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GoogleCloudAiplatformV1UploadRagFileRequest'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GoogleCloudAiplatformV1UploadRagFileResponse'
        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/aiplatform
        - https://www.googleapis.com/auth/cloud-platform
      - apiKey: []
      x-google-media-upload:
        protocols:
          simple:
            path: /upload/v1/{+parent}/ragFiles:upload
            multipart: true
        accept:
        - '*/*'
      tags:
      - Media
components:
  schemas:
    GoogleCloudAiplatformV1UploadRagFileConfig:
      description: Config for uploading RagFile.
      type: object
      properties:
        ragFileTransformationConfig:
          $ref: '#/components/schemas/GoogleCloudAiplatformV1RagFileTransformationConfig'
          description: Specifies the transformation config for RagFiles.
    GoogleCloudAiplatformV1JiraSourceJiraQueries:
      type: object
      properties:
        serverUri:
          description: Required. The Jira server URI.
          type: string
        customQueries:
          type: array
          items:
            type: string
          description: A list of custom Jira queries to import. For information about JQL (Jira Query Language), see https://support.atlassian.com/jira-service-management-cloud/docs/use-advanced-search-with-jira-query-language-jql/
        projects:
          description: A list of Jira projects to import in their entirety.
          items:
            type: string
          type: array
        email:
          description: Required. The Jira email address.
          type: string
        apiKeyConfig:
          $ref: '#/components/schemas/GoogleCloudAiplatformV1ApiAuthApiKeyConfig'
          description: Required. The SecretManager secret version resource name (e.g. projects/{project}/secrets/{secret}/versions/{version}) storing the Jira API key. See [Manage API tokens for your Atlassian account](https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/).
      description: JiraQueries contains the Jira queries and corresponding authentication.
    GoogleCloudAiplatformV1RagFileChunkingConfig:
      type: object
      properties:
        fixedLengthChunking:
          $ref: '#/components/schemas/GoogleCloudAiplatformV1RagFileChunkingConfigFixedLengthChunking'
          description: Specifies the fixed length chunking config.
      description: Specifies the size and overlap of chunks for RagFiles.
    GoogleCloudAiplatformV1SlackSourceSlackChannels:
      type: object
      description: SlackChannels contains the Slack channels and corresponding access token.
      properties:
        apiKeyConfig:
          $ref: '#/components/schemas/GoogleCloudAiplatformV1ApiAuthApiKeyConfig'
          description: 'Required. The SecretManager secret version resource name (e.g. projects/{project}/secrets/{secret}/versions/{version}) storing the Slack channel access token that has access to the slack channel IDs. See: https://api.slack.com/tutorials/tracks/getting-a-token.'
        channels:
          description: Required. The Slack channel IDs.
          type: array
          items:
            $ref: '#/components/schemas/GoogleCloudAiplatformV1SlackSourceSlackChannelsSlackChannel'
    GoogleCloudAiplatformV1GcsSource:
      properties:
        uris:
          type: array
          description: Required. Google Cloud Storage URI(-s) to the input file(s). May contain wildcards. For more information on wildcards, see https://cloud.google.com/storage/docs/wildcards.
          items:
            type: string
      description: The Google Cloud Storage location for the input content.
      type: object
    GoogleCloudAiplatformV1UploadRagFileResponse:
      description: Response message for VertexRagDataService.UploadRagFile.
      properties:
        ragFile:
          $ref: '#/components/schemas/GoogleCloudAiplatformV1RagFile'
          description: The RagFile that had been uploaded into the RagCorpus.
        error:
          $ref: '#/components/schemas/GoogleRpcStatus'
          description: The error that occurred while processing the RagFile.
      type: object
    GoogleCloudAiplatformV1SharePointSourcesSharePointSource:
      description: An individual SharePointSource.
      properties:
        tenantId:
          type: string
          description: Unique identifier of the Azure Active Directory Instance.
        driveId:
          type: string
          description: The ID of the drive to download from.
        clientId:
          type: string
          description: The Application ID for the app registered in Microsoft Azure Portal. The application must also be configured with MS Graph permissions "Files.ReadAll", "Sites.ReadAll" and BrowserSiteLists.Read.All.
        sharepointFolderPath:
          description: The path of the SharePoint folder to download from.
          type: string
        sharepointFolderId:
          description: The ID of the SharePoint folder to download from.
          type: string
        clientSecret:
          $ref: '#/components/schemas/GoogleCloudAiplatformV1ApiAuthApiKeyConfig'
          description: The application secret for the app registered in Azure.
        sharepointSiteName:
          type: string
          description: The name of the SharePoint site to download from. This can be the site name or the site id.
        driveName:
          type: string
          description: The name of the drive to download from.
        fileId:
          description: Output only. The SharePoint file id. Output only.
          readOnly: true
          type: string
      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
    GoogleCloudAiplatformV1FileStatus:
      type: object
      description: RagFile status.
      properties:
        state:
          type: string
          enum:
          - STATE_UNSPECIFIED
          - ACTIVE
          - ERROR
          readOnly: true
          description: Output only. RagFile state.
        errorStatus:
          description: Output only. Only when the `state` field is ERROR.
          type: string
          readOnly: true
    GoogleCloudAiplatformV1SlackSource:
      description: The Slack source for the ImportRagFilesRequest.
      properties:
        channels:
          description: Required. The Slack channels.
          items:
            $ref: '#/components/schemas/GoogleCloudAiplatformV1SlackSourceSlackChannels'
          type: array
      type: object
    GoogleCloudAiplatformV1JiraSource:
      type: object
      properties:
        jiraQueries:
          type: array
          items:
            $ref: '#/components/schemas/GoogleCloudAiplatformV1JiraSourceJiraQueries'
          description: Required. The Jira queries.
      description: The Jira source for the ImportRagFilesRequest.
    GoogleCloudAiplatformV1ApiAuthApiKeyConfig:
      type: object
      description: The API secret.
      properties:
        apiKeyString:
          description: The API key string. Either this or `api_key_secret_version` must be set.
          type: string
        apiKeySecretVersion:
          type: string
          description: Required. The SecretManager secret version resource name storing API key. e.g. projects/{project}/secrets/{secret}/versions/{version}
    GoogleCloudAiplatformV1RagFile:
      type: object
      description: A RagFile contains user data for chunking, embedding and indexing.
      properties:
        gcsSource:
          $ref: '#/components/schemas/GoogleCloudAiplatformV1GcsSource'
          description: Output only. Google Cloud Storage location of the RagFile. It does not support wildcards in the Cloud Storage uri for now.
        jiraSource:
          $ref: '#/components/schemas/GoogleCloudAiplatformV1JiraSource'
          description: The RagFile is imported from a Jira query.
        displayName:
          description: Required. The display name of the RagFile. The name can be up to 128 characters long and can consist of any UTF-8 characters.
          type: string
        sharePointSources:
          $ref: '#/components/schemas/GoogleCloudAiplatformV1SharePointSources'
          description: The RagFile is imported from a SharePoint source.
        googleDriveSource:
          $ref: '#/components/schemas/GoogleCloudAiplatformV1GoogleDriveSource'
          description: Output only. Google Drive location. Supports importing individual files as well as Google Drive folders.
        updateTime:
          type: string
          readOnly: true
          format: google-datetime
          description: Output only. Timestamp when this RagFile was last updated.
        directUploadSource:
          $ref: '#/components/schemas/GoogleCloudAiplatformV1DirectUploadSource'
          description: Output only. The RagFile is encapsulated and uploaded in the UploadRagFile request.
        createTime:
          description: Output only. Timestamp when this RagFile was created.
          format: google-datetime
          type: string
          readOnly: true
        userMetadata:
          readOnly: true
          description: Output only. The metadata for metadata search. The user_metadata Needs to be in JSON format.
          type: string
        fileStatus:
          $ref: '#/components/schemas/GoogleCloudAiplatformV1FileStatus'
          description: Output only. State of the RagFile.
        name:
          type: string
          readOnly: true
          description: Output only. The resource name of the RagFile.
        description:
          type: string
          description: Optional. The description of the RagFile.
        slackSource:
          $ref: '#/components/schemas/GoogleCloudAiplatformV1SlackSource'
          description: The RagFile is imported from a Slack channel.
    GoogleCloudAiplatformV1RagFileChunkingConfigFixedLengthChunking:
      type: object
      properties:
        chunkOverlap:
          type: integer
          format: int32
          description: The overlap between chunks.
        chunkSize:
          description: The size of the chunks.
          format: int32
          type: integer
      description: Specifies the fixed length chunking config.
    GoogleCloudAiplatformV1GoogleDriveSourceResourceId:
      description: The type and ID of the Google Drive resource.
      properties:
        resourceType:
          type: string
          enum:
          - RESOURCE_TYPE_UNSPECIFIED
          - RESOURCE_TYPE_FILE
          - RESOURCE_TYPE_FOLDER
          description: Required. The type of the Google Drive resource.
        resourceId:
          type: string
          description: Required. The ID of the Google Drive resource.
      type: object
    GoogleRpcStatus:
      type: object
      properties:
        details:
          items:
            type: object
            additionalProperties:
              description: Properties of the object. Contains field @type with type URL.
          type: array
          description: A list of messages that carry the error details. There is a common set of message types for APIs to use.
        code:
          type: integer
          format: int32
          description: The status code, which should be an enum value of google.rpc.Code.
        message:
          description: A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
          type: string
      description: 'The `Status` type defines a logical error model that is suitable for different programming environments, including REST APIs and RPC APIs. It is used by [gRPC](https://github.com/grpc). Each `Status` message contains three pieces of data: error code, error message, and error details. You can find out more about this error model and how to work with it in the [API Design Guide](https://cloud.google.com/apis/design/errors).'
    GoogleCloudAiplatformV1UploadRagFileRequest:
      description: Request message for VertexRagDataService.UploadRagFile.
      properties:
        ragFile:
          $ref: '#/components/schemas/GoogleCloudAiplatformV1RagFile'
          description: Required. The RagFile to upload.
        uploadRagFileConfig:
          $ref: '#/components/schemas/GoogleCloudAiplatformV1UploadRagFileConfig'
          description: Required. The config for the RagFiles to be uploaded into the RagCorpus. VertexRagDataService.UploadRagFile.
      type: object
    GoogleCloudAiplatformV1SlackSourceSlackChannelsSlackChannel:
      properties:
        channelId:
          type: string
          description: Required. The Slack channel ID.
        startTime:
          format: google-datetime
          type: string
          description: Optional. The starting timestamp for messages to import.
        endTime:
          description: Optional. The ending timestamp for messages to import.
          type: string
          format: google-datetime
      description: SlackChannel contains the Slack channel ID and the time range to import.
      type: object
    GoogleCloudAiplatformV1DirectUploadSource:
      description: The input content is encapsulated and uploaded in the request.
      properties: {}
      type: object
    GoogleCloudAiplatformV1SharePointSources:
      properties:
        sharePointSources:
          type: array
          description: The SharePoint sources.
          items:
            $ref: '#/components/schemas/GoogleCloudAiplatformV1SharePointSourcesSharePointSource'
      description: The SharePointSources to pass to ImportRagFiles.
      type: object
    GoogleCloudAiplatformV1GoogleDriveSource:
      type: object
      properties:
        resourceIds:
          description: Required. Google Drive resource IDs.
          items:
            $ref: '#/components/schemas/GoogleCloudAiplatformV1GoogleDriveSourceResourceId'
          type: array
      description: The Google Drive location for the input content.
    GoogleCloudAiplatformV1RagFileTransformationConfig:
      type: object
      properties:
        ragFileChunkingConfig:
          $ref: '#/components/schemas/GoogleCloudAiplatformV1RagFileChunkingConfig'
          description: Specifies the chunking config for RagFiles.
      description: Specifies the transformation config for RagFiles.
  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/cloud-platform.read-only: View your data across Google Cloud services and see the email address of your Google Account
            https://www.googleapis.com/auth/aiplatform: See, edit, configure, and delete your Google Cloud Vertex AI data and see the email address for your Google Account
            https://www.googleapis.com/auth/cloud-platform: See, edit, configure, and delete your Google Cloud data and see the email address for your Google Account.
externalDocs:
  url: https://cloud.google.com/vertex-ai/
x-provenance:
  method: harvested
  publisher: Google
  source: https://aiplatform.googleapis.com/$discovery/rest?version=v1
  note: converted by discovery-to-openapi.py from Google's Discovery document (revision 20261106)