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.
openapi: 3.2.0
info:
title: Google Keep Media API
version: v1
description: Generated from Google's published Discovery document for Google Keep API (keep v1, revision 20261107). 1 operation(s).
contact:
name: Google
url: https://developers.google.com/
termsOfService: https://developers.google.com/terms
servers:
- url: https://keep.googleapis.com
tags:
- name: Media
paths:
/v1/notes/{notesId}/attachments/{attachmentsId}:
get:
operationId: keep.media.download
summary: Download media
description: Gets an attachment. To download attachment media via REST requires the alt=media query parameter. Returns a 400 bad request error if attachment media is not available in the requested MIME type.
parameters:
- name: notesId
in: path
required: true
description: Resource name segment (notesId).
schema:
type: string
- name: attachmentsId
in: path
required: true
description: Resource name segment (attachmentsId).
schema:
type: string
- name: mimeType
in: query
required: false
description: The IANA MIME type format requested. The requested MIME type must be one specified in the attachment.mime_type. Required when downloading attachment media and ignored otherwise.
schema:
type: string
responses:
'200':
description: Successful response
content:
application/json:
schema:
$ref: '#/components/schemas/Attachment'
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/keep
- https://www.googleapis.com/auth/keep.readonly
- apiKey: []
tags:
- Media
components:
schemas:
Attachment:
properties:
name:
type: string
description: The resource name;
mimeType:
items:
type: string
type: array
description: The MIME types (IANA media types) in which the attachment is available.
description: An attachment to a note.
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
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/keep: See, edit, create and permanently delete all your Google Keep data
https://www.googleapis.com/auth/keep.readonly: View all your Google Keep data
externalDocs:
url: https://developers.google.com/workspace/keep/api
x-provenance:
method: harvested
publisher: Google
source: https://keep.googleapis.com/$discovery/rest?version=v1
note: converted by discovery-to-openapi.py from Google's Discovery document (revision 20261107)