Confluence

Confluence Content - attachments API

The Content - attachments API from Confluence — 4 operation(s) for content - attachments.

GitHub OpenAPI

Operations 5

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

PUT /wiki/rest/api/content/{id}/child/attachment Upload a file, replacing it if it already exists · Create or update attachment #
Ask an LLM
“How do I upload a file to a page and have it create a new version if one with that name already exists?”
“Can I upsert an attachment as a minor edit so watchers aren't notified?”
Tell an agent
Upload {file} to content {id}, creating a new version if it already exists, with minor edit {minorEdit}.
Upsert attachment {file} on page {id} with comment {comment}, minor edit {minorEdit}.
POST /wiki/rest/api/content/{id}/child/attachment Attach a new file to a page · Create attachment #
Ask an LLM
“How do I add a brand-new attachment to a Confluence page without touching existing ones?”
“Why does my upload need the X-Atlassian-Token nocheck header?”
Tell an agent
Attach new file {file} to content {id}, minor edit {minorEdit}.
Add {file} as a new attachment on page {id} with comment {comment}, minor edit {minorEdit}.
PUT /wiki/rest/api/content/{id}/child/attachment/{attachmentId} Rename or move an attachment · Update attachment properties #
Ask an LLM
“How do I rename an attachment or change its media type without re-uploading it?”
“Can I move an attachment to a different parent page?”
Tell an agent
Rename attachment {attachmentId} on content {id} to {title}, as version {version}.
Move attachment {attachmentId} from content {id} to container {container}, type {type}, body id {attachmentBodyId}, version {version}.
POST /wiki/rest/api/content/{id}/child/attachment/{attachmentId}/data Replace the file contents of an attachment · Update attachment data #
Ask an LLM
“How do I upload a new version of an existing attachment by its ID?”
“Can I replace an attachment's binary data and leave a comment on the change?”
Tell an agent
Replace the data of attachment {attachmentId} on content {id} with {file}, minor edit {minorEdit}.
Upload {file} as the new binary for attachment {attachmentId} on page {id} with comment {comment}, minor edit {minorEdit}.
GET /wiki/rest/api/content/{id}/child/attachment/{attachmentId}/download Download an attachment · Get URI to download attachment #
Ask an LLM
“How do I download a file attached to a Confluence page?”
“Can I download an older version of an attachment?”
Tell an agent
Download attachment {attachmentId} from content {id}.
Get the download link for version {version} of attachment {attachmentId} on page {id}.

Documentation

📖
APIReference
https://developer.atlassian.com/cloud/confluence/rest/v2/intro/
📖
Documentation
https://developer.atlassian.com/cloud/confluence/rest/v2/intro/
📖
Authentication
https://developer.atlassian.com/cloud/confluence/security-overview/
📖
GettingStarted
https://developer.atlassian.com/cloud/confluence/getting-started/
📖
APIReference
https://developer.atlassian.com/cloud/confluence/rest/v1/intro/
📖
Documentation
https://developer.atlassian.com/cloud/confluence/rest/v1/intro/
📖
Authentication
https://developer.atlassian.com/cloud/confluence/basic-auth-for-rest-apis/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/confluence/refs/heads/main/openapi/confluence-content-attachments-api-openapi.yml

Other Resources

🔗
Postman
https://developer.atlassian.com/cloud/confluence/confcloud.2.postman.json
🔗
PostmanCollection
https://raw.githubusercontent.com/api-evangelist/confluence/refs/heads/main/collections/confluence-confcloud-v2.postman_collection.json

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/confluence:confluence-content-attachments-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

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.

GitHub Google LinkedIn

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

OpenAPI Specification

confluence-content-attachments-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Confluence Cloud REST Content - attachments API
  description: This document describes the REST API and resources provided by Confluence.
  termsOfService: https://atlassian.com/terms/
  version: 1.0.0
servers:
- url: //your-domain.atlassian.net
tags:


# --- truncated at 32 KB (73 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/confluence/refs/heads/main/openapi/confluence-content-attachments-api-openapi.yml