Confluence Custom Content API

The Custom Content API from Confluence — 5 operation(s) for custom content.

Operations 8

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

GET /blogposts/{id}/custom-content List custom content of a type in a blog post · Get custom content by type in blog post #
Ask an LLM
“What custom content of a given type is attached to a blog post?”
“Can I list an app's custom content inside one blog post?”
Tell an agent
List custom content of type {type} in blog post {id}.
Show the {type} items stored within blog post {id}.
GET /custom-content List custom content of a type · Get custom content by type #
Ask an LLM
“How do I find all custom content of a given type across the site?”
“Can I filter custom content of one type to specific spaces?”
Tell an agent
List all custom content of type {type}.
Get custom content of type {type} in spaces {spaces}.
POST /custom-content Create custom content · Create custom content #
Ask an LLM
“How do I create a custom content item for my app?”
“Can I attach new custom content to a page instead of a space?”
Tell an agent
Create custom content of type {type} titled {title} in space {spaceId} with body {body}.
Add a {type} custom content item {title} to page {pageId} with body {body}.
GET /custom-content/{id} Get a custom content item · Get custom content by id #
Ask an LLM
“How do I fetch one custom content item by its ID?”
“Can I include labels and properties when reading custom content?”
Tell an agent
Get custom content {id}.
Fetch custom content {id} at version {version}.
PUT /custom-content/{id} Update a custom content item · Update custom content #
Ask an LLM
“How do I edit an existing custom content item?”
“Which version number must I send when updating custom content?”
Tell an agent
Update custom content {id} of type {type} to version {version} with title {title}, status {status} and body {body}.
Change the body of {type} custom content {id} to {body}, saving version {version} titled {title} as {status}.
DELETE /custom-content/{id} Delete a custom content item · Delete custom content #
Ask an LLM
“Does deleting custom content send it to the trash or remove it for good?”
“Can I purge custom content that's already in the trash?”
Tell an agent destructive · confirm first
Delete custom content {id}.
Permanently purge trashed custom content {id}.
GET /pages/{id}/custom-content List custom content of a type in a page · Get custom content by type in page #
Ask an LLM
“What custom content of a given type lives inside a page?”
“Can I list my app's custom content items on one page?”
Tell an agent
List custom content of type {type} in page {id}.
Show the {type} items stored within page {id}.
GET /spaces/{id}/custom-content List custom content of a type in a space · Get custom content by type in space #
Ask an LLM
“Which custom content items of a type belong to a space?”
“Can I page through a space's custom content of one type?”
Tell an agent
List custom content of type {type} in space {id}.
Show the first {limit} {type} items in space {id}.

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-custom-content-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.

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

OpenAPI Specification

confluence-custom-content-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Confluence Cloud REST API v2 Custom Content API
  description: This document describes Confluence's v2 APIs. This is intended to be an iteration on the existing Confluence Cloud REST API with improvements in both endpoint definitions and performance.
  termsOfService: https://developer.atlassian.com/platform/marketplace/atlassian-developer-terms/
  version: 2.0.0
servers:
- url: https://{your-domain}/wiki/api/v2
  variables:
    your-domain:
      default: no-default
      description: Specific domain of the Confluence site being used. Must be provided.
tags:


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