> ## Documentation Index > Fetch the complete documentation index at: https://openworklabs.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Create a Gmail draft or threaded reply draft without attachments > Creates a plain-text Gmail draft in the calling member own mailbox. For workspace attachments, use the openwork-cloud-uploads gmail_create_draft_with_attachments action so file bytes stay outside model context. Set threadId for replies and forwards. Always share the returned draftUrl. ## OpenAPI ````yaml /openapi.json post /v1/capabilities/google-workspace/gmail-drafts openapi: 3.1.0 info: title: Den API description: >- OpenAPI spec for the Den control plane API. Authentication: - Use `Authorization: Bearer ` for user-authenticated routes that require a Den session. - Use `x-api-key: ` for API-key-authenticated routes that accept organization API keys. - Public routes like health and documentation do not require authentication. Swagger tip: use the security schemes in the Authorize dialog to set either `bearerAuth` or `denApiKey` before trying protected endpoints. version: dev servers: - url: http://api.den.local security: [] tags: - name: System description: Service health and operational routes. - name: Organizations description: Top-level organization creation and context routes. - name: Invitations description: Invitation preview, acceptance, creation, and cancellation routes. - name: API Keys description: Organization API key management routes. - name: SCIM description: Organization SCIM connector management routes. - name: SSO description: Organization single sign-on connector management routes. - name: Members description: Organization member management routes. - name: Roles description: Organization custom role management routes. - name: Teams description: Organization team management routes. - name: Templates description: Organization shared template routes. - name: LLM Providers description: Organization LLM provider catalog, configuration, and access routes. - name: Workers description: Worker lifecycle, billing, and runtime routes. - name: Worker Runtime description: Worker runtime inspection and upgrade routes. - name: Worker Activity description: Worker heartbeat and activity reporting routes. - name: Telemetry description: Telemetry event ingestion and adoption analytics. - name: Admin description: Administrative reporting routes. - name: Users description: Current user and membership routes. - name: Bootstrap description: Agent-first provisional workspace setup routes. paths: /v1/capabilities/google-workspace/gmail-drafts: post: tags: - Capability Sources summary: Create a Gmail draft or threaded reply draft without attachments description: >- Creates a plain-text Gmail draft in the calling member own mailbox. For workspace attachments, use the openwork-cloud-uploads gmail_create_draft_with_attachments action so file bytes stay outside model context. Set threadId for replies and forwards. Always share the returned draftUrl. operationId: postV1CapabilitiesGoogleWorkspaceGmailDrafts requestBody: required: true content: application/json: schema: type: object properties: to: type: string minLength: 3 maxLength: 320 description: Recipient email address. cc: description: Optional comma-separated Cc email addresses. type: string minLength: 3 maxLength: 1000 bcc: description: Optional comma-separated Bcc email addresses. type: string minLength: 3 maxLength: 1000 subject: type: string minLength: 1 maxLength: 500 description: >- Draft subject line. For replies or forwards, include threadId; subjects starting with Re: or Fwd: are rejected without threadId so the draft stays on the existing conversation. body: type: string minLength: 1 maxLength: 50000 description: >- Plain-text draft body. Write plain prose with no markdown syntax, separate paragraphs with blank lines, and do not hard-wrap prose. For threaded drafts, the server appends the quoted conversation automatically; do not include quoted history. threadId: description: >- Gmail thread id to reply on. Required for replies and forwards; get it from the gmail-messages capability. When set, the draft is attached to that thread as a reply — keep the thread's subject (e.g. 'Re: …'). type: string minLength: 1 maxLength: 512 required: - to - subject - body additionalProperties: false responses: '200': description: Draft created. content: application/json: schema: $ref: '#/components/schemas/GoogleWorkspaceDraftResponse' '400': description: The draft request was invalid. content: application/json: schema: anyOf: - $ref: '#/components/schemas/InvalidRequestError' - $ref: '#/components/schemas/GoogleWorkspaceMissingThreadIdError' '401': description: The caller must be signed in. content: application/json: schema: $ref: '#/components/schemas/UnauthorizedError' '409': description: >- The calling member has not connected their Google account or is missing permission. content: application/json: schema: $ref: '#/components/schemas/GoogleWorkspaceNeedsConnectionError' '502': description: Google rejected the request. content: application/json: schema: $ref: '#/components/schemas/GoogleWorkspaceUpstreamError' components: schemas: GoogleWorkspaceDraftResponse: type: object properties: ok: type: boolean const: true draftId: type: string messageId: anyOf: - type: string - type: 'null' draftUrl: anyOf: - type: string - type: 'null' description: >- Gmail URL for the ready-to-send draft. Always share draftUrl with the user so they can open the draft in Gmail for review and send. threadUrl: anyOf: - type: string - type: 'null' description: >- Gmail URL for the conversation thread when this draft is a threaded reply. to: type: string subject: type: string threadId: anyOf: - type: string - type: 'null' quotedHistoryIncluded: type: boolean description: >- True when quoted conversation history was included by the server or already present in the request body. attachments: type: array items: type: object properties: filename: type: string mimeType: type: string size: type: integer minimum: 0 maximum: 9007199254740991 required: - filename - mimeType - size required: - ok - draftId - messageId - draftUrl - threadUrl - to - subject - threadId - quotedHistoryIncluded InvalidRequestError: type: object properties: error: type: string const: invalid_request details: type: array items: type: object properties: message: type: string path: type: array items: anyOf: - type: string - type: number required: - message additionalProperties: {} required: - error - details GoogleWorkspaceMissingThreadIdError: type: object properties: error: type: string const: missing_thread_id message: type: string required: - error - message UnauthorizedError: type: object properties: error: type: string const: unauthorized required: - error GoogleWorkspaceNeedsConnectionError: type: object properties: error: type: string const: needs_connection message: type: string required: - error - message GoogleWorkspaceUpstreamError: type: object properties: error: type: string const: google_api_error message: type: string required: - error - message ````