getCustomContentById
Get custom content by id
Details
- Method:
GET - Path:
/custom-content/{id} - Operation ID:
getCustomContentById
Parameters
{
"id": {
"description": "The ID of the custom content to be returned. If you don't know the custom content ID, use Get Custom Content by Type and filter the results.",
"required": true,
"location": "path",
"type": "integer",
"format": "int64"
},
"body-format": {
"description": "The content format types to be returned in the `body` field of the response. If available, the representation will be available under a response field of the same name under the `body` field.\n\nNote: If the custom content body type is `storage`, the `storage` and `atlas_doc_format` body formats are able to be returned. If the custom content body type is `raw`, only the `raw` body format is able to be returned.",
"required": false,
"location": "query",
"type": "string",
"enum": [
"raw",
"storage",
"atlas_doc_format",
"view",
"export_view",
"anonymous_export_view"
]
},
"version": {
"description": "Allows you to retrieve a previously published version. Specify the previous version's number to retrieve its details.",
"required": false,
"location": "query",
"type": "integer"
},
"include-labels": {
"description": "Includes labels associated with this custom content in the response.\nThe number of results will be limited to 50 and sorted in the default sort order. \nA `meta` and `_links` property will be present to indicate if more results are available and a link to retrieve the rest of the results.",
"required": false,
"location": "query",
"type": "boolean"
},
"include-properties": {
"description": "Includes content properties associated with this custom content in the response.\nThe number of results will be limited to 50 and sorted in the default sort order. \nA `meta` and `_links` property will be present to indicate if more results are available and a link to retrieve the rest of the results.",
"required": false,
"location": "query",
"type": "boolean"
},
"include-operations": {
"description": "Includes operations associated with this custom content in the response, as defined in the `Operation` object.\nThe number of results will be limited to 50 and sorted in the default sort order. \nA `meta` and `_links` property will be present to indicate if more results are available and a link to retrieve the rest of the results.",
"required": false,
"location": "query",
"type": "boolean"
},
"include-versions": {
"description": "Includes versions associated with this custom content in the response.\nThe number of results will be limited to 50 and sorted in the default sort order. \nA `meta` and `_links` property will be present to indicate if more results are available and a link to retrieve the rest of the results.",
"required": false,
"location": "query",
"type": "boolean"
},
"include-version": {
"description": "Includes the current version associated with this custom content in the response.\nBy default this is included and can be omitted by setting the value to `false`.",
"required": false,
"location": "query",
"type": "boolean"
},
"include-collaborators": {
"description": "Includes collaborators on the custom content.",
"required": false,
"location": "query",
"type": "boolean"
}
}Response Schema
{
"allOf": [
{
"$ref": "#/components/schemas/CustomContentSingle"
},
{
"type": "object",
"properties": {
"_links": {
"type": "object",
"properties": {
"base": {
"type": "string",
"description": "Base url of the Confluence site."
}
}
}
}
}
]
}Usage
from ocp_agent import OCPAgent
agent = OCPAgent()
await agent.register_api('confluence')
# Call this tool
result = await agent.call_tool('getCustomContentById', {
# Add required parameters here
})