Adobe Suite

Adobe Suite Notes API

Notes are textual annotations that you can add to certain tag resources, such as data elements, extensions, libraries, properties, rules, and rule components.

Documentation GitHub OpenAPI

Operations 15

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 /notes/{NOTE_ID} Get a single note · Retrieve a note #

Ask an LLM

“How do I read one tags note if I have its ID?”

“What does a specific note say and when was it written?”

Tell an agent

Show me note {note}.

Get the text of note {note}.

GET /properties/{PROPERTY_ID}/notes List the notes on a tags property · List a property's notes #

Ask an LLM

“What notes has my team left on this tags property?”

“Can I search a property's notes for a keyword?”

Tell an agent

List the notes on property {property}.

Find notes on property {property} mentioning {text}.

POST /properties/{PROPERTY_ID}/notes Add a note to a tags property · Create a note for a property #

Ask an LLM

“How do I leave a note on a whole tags property?”

“Can I document a change at the property level with a note?”

Tell an agent

Add a note to property {property}.

Write a note on property {property} about this setup.

GET /data_elements/{DATA_ELEMENT_ID}/notes List the notes on a data element · List a data element's notes #

Ask an LLM

“Are there any notes explaining what this data element captures?”

“Can I filter a data element's notes by when they were created?”

Tell an agent

List the notes on data element {data_element}.

Find notes on data element {data_element} that mention {text}.

POST /data_elements/{DATA_ELEMENT_ID}/notes Add a note to a data element · Create a note for a data element #

Ask an LLM

“How do I annotate a data element with a note?”

“Can I explain a data element's purpose in a note for others?”

Tell an agent

Add a note to data element {data_element}.

Annotate data element {data_element} with a note.

GET /secrets/{SECRET_ID}/notes List the notes on a secret · List a secret's notes #

Ask an LLM

“What notes are attached to this event forwarding secret?”

“Can I look for a secret's notes by text?”

Tell an agent

List the notes on secret {secret}.

Find notes on secret {secret} containing {text}.

POST /secrets/{SECRET_ID}/notes Add a note to a secret · Create a note for a secret #

Ask an LLM

“How do I record a note against a secret, like who owns it?”

“Can I leave a note on a secret without changing the secret itself?”

Tell an agent

Add a note to secret {secret}.

Record a note on secret {secret} about its rotation.

GET /extensions/{EXTENSION_ID}/notes List the notes on an extension · List an extension's notes #

Ask an LLM

“What notes exist for this installed extension?”

“How do I page through comments on an extension?”

Tell an agent

List the notes on extension {extension}.

Show all notes left on extension {extension}.

POST /extensions/{EXTENSION_ID}/notes Add a note to an extension · Create a note for an extension #

Ask an LLM

“How do I leave a note on an installed extension?”

“Can I explain why an extension was configured a certain way in a note?”

Tell an agent

Add a note to extension {extension}.

Explain the configuration of extension {extension} in a new note.

GET /libraries/{LIBRARY_ID}/notes List the notes on a library · List a library's notes #

Ask an LLM

“What release notes were left on this library?”

“Can I search a library's notes for specific text?”

Tell an agent

List the notes on library {library}.

Find notes on library {library} that mention {text}.

POST /libraries/{LIBRARY_ID}/notes Add a note to a library · Create a note for a library #

Ask an LLM

“How do I leave release notes on a library?”

“Can I comment on a library before it gets published?”

Tell an agent

Add a note to library {library}.

Leave release notes on library {library}.

GET /rules/{RULE_ID}/notes List the notes on a rule · List a rule's notes #

Ask an LLM

“What comments have people left on this tag rule?”

“Can I filter a rule's notes by update date?”

Tell an agent

List the notes on rule {rule}.

Find notes on rule {rule} mentioning {text}.

POST /rules/{RULE_ID}/notes Add a note to a rule · Create a note for a rule #

Ask an LLM

“How do I document why a tag rule exists with a note?”

“Can I comment on a rule through the API?”

Tell an agent

Add a note to rule {rule}.

Document the purpose of rule {rule} in a note.

GET /rule_components/{RULE_COMPONENT_ID}/notes List the notes on a rule component · List a rule component's notes #

Ask an LLM

“Which notes were written about a specific event, condition or action inside a rule?”

“Can I search the notes on one rule component by keyword?”

Tell an agent

List the notes on rule component {component}.

Find notes on rule component {component} that contain {text}.

POST /rule_components/{RULE_COMPONENT_ID}/notes Add a note to a rule component · Create a note for a rule component #

Ask an LLM

“How do I annotate a single condition or action within a rule?”

“Can I attach a note to one rule component rather than the whole rule?”

Tell an agent

Add a note to rule component {component}.

Annotate rule component {component} with an explanation.

Adobe Suite Notes API

Operations 15

Documentation

Specifications

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification