Jasper Attachments API
The Attachments API from Jasper — 1 operation(s) for attachments.
The Attachments API from Jasper — 1 operation(s) for attachments.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/jasper-da-com:jasper-da-com-attachments-api"
curl "https://apis.io/api/v1/apis?limit=25"
Discovery needs no key. Ratings and market analysis are Pro.
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: 3.2.0
info:
title: Jasper Attachments API
description: Jasper API
version: '1.0'
contact: {}
servers:
- url: https://api.jasper.ai
tags:
- name: Attachments
description: ''
paths:
/v1/attachments:
post:
description: 'Create a temporary attachment for use as ad-hoc context on a content generation request. Submit as `multipart/form-data`. The `type` form field discriminates the payload carried on `value`: for FILE, send the file bytes as the `value` multipart part; for TEXT and URL, send the payload as the `value` form field.
Reference the returned `id` in the `attachmentIds` field on a subsequent `POST /v1/tasks/{id}/run` (or `POST /v1/tasks/{id}/run/stream`), `POST /v1/command`, or `POST /v1/templates/{templateId}/run` call. It is not supported by other endpoints.
Temporary attachments are intended for short-lived context (the same attachment can be referenced across retries of the same run) and should not be relied on for durable storage. Use the Knowledge API (`POST /v1/knowledge`) for content that should persist in your workspace.'
operationId: createAttachment
parameters: []
requestBody:
required: true
content:
multipart/form-data:
schema:
$ref: '#/components/schemas/CreateAttachmentDto'
responses:
'201':
description: Attachment created successfully.
content:
application/json:
schema:
$ref: '#/components/schemas/CreateAttachmentResponseDto'
'400':
description: Bad request. Missing required fields or unsupported file type.
content:
application/json:
schema:
$ref: '#/components/schemas/Attachment400Error'
'500':
description: Internal server error. Unable to create attachment.
content:
application/json:
schema:
$ref: '#/components/schemas/Attachment500Error'
security:
- X-API-Key: []
- oauth2:
- user
summary: Create a temporary attachment
tags:
- Attachments
components:
schemas:
CreateAttachmentDto:
type: object
properties:
type:
type: string
enum:
- FILE
- TEXT
- URL
description: 'The kind of attachment being created. In every case the payload is carried on the `value` multipart part: FILE sends binary file bytes, TEXT sends a raw text string, URL sends a URL string.'
example: FILE
value:
oneOf:
- title: binary
type: string
format: binary
- title: string
type: string
description: 'The attachment payload. Its shape depends on `type`: for FILE, the binary file bytes (multipart file part; pick `binary` in the docs UI); for TEXT, a raw text string (form field; pick `string`); for URL, a URL string (form field; pick `string`).'
example: Q3 retention numbers improved 12% YoY across enterprise segments.
required:
- type
- value
Attachment500Error:
type: object
properties:
statusCode:
type: number
example: 500
message:
type: string
example: Couldn't create attachment
error:
type: string
example: Internal Server Error
required:
- statusCode
- message
- error
CreateAttachmentResource:
type: object
properties:
id:
type: string
description: The temporary attachment ID. Reference this value in `attachmentIds` on a subsequent task run, command, or template run call.
example: tmp_2ee766eaa4ef48e59da1d9602bfecf2d
type:
type: string
enum:
- FILE
- TEXT
- URL
description: The attachment type, echoing back the request `type`.
example: FILE
required:
- id
- type
CreateAttachmentResponseDto:
type: object
properties:
requestId:
type: string
example: 8393f82b3f6a4f6e8a405777b9305254
resource:
type: string
example: knowledge
data:
$ref: '#/components/schemas/CreateAttachmentResource'
required:
- requestId
- resource
- data
Attachment400Error:
type: object
properties:
statusCode:
type: number
example: 400
message:
type: string
example: 'Unsupported file type "exe". Supported extensions: pdf, docx, txt, md, png, …'
error:
type: string
example: Bad Request
required:
- statusCode
- message
- error
securitySchemes:
X-API-Key:
type: apiKey
in: header
name: X-API-Key
description: Workspace authentication using API key tokens in the X-API-Key header.
oauth2:
type: oauth2
flows:
authorizationCode:
authorizationUrl: https://api.jasper.ai/oauth2/authorize
tokenUrl: https://api.jasper.ai/oauth2/token
refreshUrl: https://api.jasper.ai/oauth2/token
scopes:
user:read: Read user information
user: Read and write user information
description: User-level authentication using OAuth bearer tokens in the Authorization header.
x-provenance:
method: searched
source: https://developers.jasper.ai/reference
harvested: '2026-10-23'
tool: harvest-readme-openapi.py
note: Assembled verbatim from the OpenAPI definition ReadMe embeds in each operation page of the provider's developer portal; paths and components merged by API title, nothing authored.
assembled_from:
- https://developers.jasper.ai/reference/cleanup.md
- https://developers.jasper.ai/reference/command-2.md
- https://developers.jasper.ai/reference/completetemplate-1.md
- https://developers.jasper.ai/reference/createanalysis.md
- https://developers.jasper.ai/reference/createattachment.md
- https://developers.jasper.ai/reference/createcontextsource.md
- https://developers.jasper.ai/reference/createdocument.md
- https://developers.jasper.ai/reference/createproduct.md
- https://developers.jasper.ai/reference/createproject.md
- https://developers.jasper.ai/reference/createtone.md
- https://developers.jasper.ai/reference/decompose-1.md
- https://developers.jasper.ai/reference/deleteanalysis.md
- https://developers.jasper.ai/reference/deletedocumentbyid.md
- https://developers.jasper.ai/reference/deleteknowledgedocument.md
- https://developers.jasper.ai/reference/deleteproduct.md
- https://developers.jasper.ai/reference/deleteproject.md
- https://developers.jasper.ai/reference/deletetone.md
- https://developers.jasper.ai/reference/getallaudiences.md
- https://developers.jasper.ai/reference/getalldocuments.md
- https://developers.jasper.ai/reference/getallproducts.md
- https://developers.jasper.ai/reference/getalltemplates-1.md
- https://developers.jasper.ai/reference/getalltones.md
- https://developers.jasper.ai/reference/getallusers.md
- https://developers.jasper.ai/reference/getanalysis.md
- https://developers.jasper.ai/reference/getaudiencebyid.md
- https://developers.jasper.ai/reference/getcontextsourcebyid.md
- https://developers.jasper.ai/reference/getdocumentbyid.md
- https://developers.jasper.ai/reference/getknowledgedocument.md
- https://developers.jasper.ai/reference/getknowledgedocuments.md
- https://developers.jasper.ai/reference/getproductattributes.md
- https://developers.jasper.ai/reference/getproductbyid.md
- https://developers.jasper.ai/reference/getprojectbyid.md
- https://developers.jasper.ai/reference/getprojects.md
- https://developers.jasper.ai/reference/getrun.md
- https://developers.jasper.ai/reference/getrunclaims.md
- https://developers.jasper.ai/reference/getrunrecommendations.md
- https://developers.jasper.ai/reference/getstyle.md
- https://developers.jasper.ai/reference/getstylebyid.md
- https://developers.jasper.ai/reference/gettaskbyid.md
- https://developers.jasper.ai/reference/gettemplate-1.md
- https://developers.jasper.ai/reference/gettone.md
- https://developers.jasper.ai/reference/gettrends.md
- https://developers.jasper.ai/reference/getuser.md
- https://developers.jasper.ai/reference/listanalyses.md
- https://developers.jasper.ai/reference/listanalysissummaries.md
- https://developers.jasper.ai/reference/listruns.md
- https://developers.jasper.ai/reference/listtasks.md
- https://developers.jasper.ai/reference/packshotcompositing.md
- https://developers.jasper.ai/reference/removebackground.md
- https://developers.jasper.ai/reference/removetext.md
- https://developers.jasper.ai/reference/renderimagetemplate.md
- https://developers.jasper.ai/reference/replacebackground.md
- https://developers.jasper.ai/reference/runtask.md
- https://developers.jasper.ai/reference/runtaskstream.md
- https://developers.jasper.ai/reference/searchknowledge.md
- https://developers.jasper.ai/reference/uncrop.md
- https://developers.jasper.ai/reference/updateanalysis.md
- https://developers.jasper.ai/reference/updatedocument.md
- https://developers.jasper.ai/reference/updateknowledgedocument.md
- https://developers.jasper.ai/reference/updateproduct.md
- https://developers.jasper.ai/reference/updateproject.md
- https://developers.jasper.ai/reference/updatetone.md
- https://developers.jasper.ai/reference/uploadknowledgedocument.md
- https://developers.jasper.ai/reference/upscale.md
- https://developers.jasper.ai/reference/usage-1.md
merge:
pages: 65
deduped: 240
conflicts_kept_first: 0