Trello

trello Plugins API

Operations for managing Power-Up plugins, including listing, updating, and creating plugin marketplace listings.

Documentation GitHub OpenAPI

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 /plugins/{id} Get a Power-Up · Get a Plugin #

Ask an LLM

“How do I look up my Power-Up's details by its id?”

“What information is stored about a Power-Up plugin?”

Tell an agent

Show Power-Up {id}.

Fetch the plugin record for Power-Up {id}.

PUT /plugins/{id} Update a Power-Up · Update a Plugin #

Ask an LLM

“How do I update my Power-Up's information?”

“Can I change a Power-Up's details after publishing it?”

Tell an agent

Update Power-Up {id}.

Save changes to my Power-Up {id} information.

POST /plugins/{id}/listings Create a marketplace listing for a Power-Up · Create a Listing for a Plugin #

Ask an LLM

“How do I publish a marketplace listing for my Power-Up?”

“What text goes into a Power-Up listing's overview and description?”

Tell an agent

Create a marketplace listing for Power-Up {id} named {name}.

Publish listing {name} for plugin {id} with overview {overview}.

GET /plugins/{id}/ Get a Power-Up (trailing-slash endpoint) · Get a Plugin #

Ask an LLM

“Is there a trailing-slash plugins path variant for fetching a plugin?”

“Which endpoint returns a plugin when called with a trailing slash?”

Tell an agent

Get plugin {id} via the trailing-slash endpoint.

Call /plugins/{id}/ to read that plugin.

PUT /plugins/{id}/ Update a Power-Up (trailing-slash endpoint) · Update a Plugin #

Ask an LLM

“Is there a trailing-slash plugins path variant for updating a plugin?”

“Which update call takes the plugin path with a trailing slash?”

Tell an agent

Update plugin {id} via the trailing-slash endpoint.

Send a PUT to /plugins/{id}/ with my changes.

POST /plugins/{idPlugin}/listings Add a localized listing for a Power-Up · Create a Listing for Plugin #

Ask an LLM

“How do I add a listing for my Power-Up in another language?”

“Can I create a separate listing per locale?”

Tell an agent

Add a {locale} listing for Power-Up {idPlugin}.

Create a listing in locale {locale} for {idPlugin} with description {description}.

GET /plugins/{id}/compliance/memberPrivacy Check a Power-Up's member privacy compliance · Get Plugin's Member privacy compliance #

Ask an LLM

“Which members has my Power-Up been asked to erase personal data for?”

“How do I check member privacy compliance for a Power-Up?”

Tell an agent

Get member privacy compliance data for Power-Up {id}.

Check privacy obligations pending for plugin {id}.

PUT /plugins/{idPlugin}/listings/{idListing} Update a Power-Up's listing · Updating Plugin's Listing #

Ask an LLM

“How do I edit an existing marketplace listing for my Power-Up?”

“Can I change a listing's overview after it's published?”

Tell an agent

Update listing {idListing} of Power-Up {idPlugin} with overview {overview}.

Rename listing {idListing} on plugin {idPlugin} to {name}.

Documentation

📖

Documentation

https://developer.atlassian.com/cloud/trello/rest/

Specifications

⚙

OpenAPI

https://raw.githubusercontent.com/api-evangelist/trello/refs/heads/main/openapi/trello-plugins-api-openapi.yml

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/trello:trello-plugins-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

openapi: 3.2.0
info:
  title: Trello Plugins API
  version: '1.0'
  description: 'Operations tagged Plugins across 2 of this provider''s published API definitions: trello-rest-api-openapi.yml, trello-rest-api-swagger-v3.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://api.trello.com/1
  description: Trello API v1 Production Server
tags:
- name: Plugins
  description: Operations for managing Power-Up plugins, including listing, updating, and creating plugin marketplace listings.
paths:
  /plugins/{id}:
    get:
      operationId: getPlugin
      summary: Get a Plugin
      description: Retrieves a Power-Up plugin by its identifier.
      tags:
      - Plugins
      parameters:
      - $ref: '#/components/parameters/idParam'
      responses:
        '200':
          description: Successfully retrieved the plugin.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Plugin'
        '401':
          description: Unauthorized.
        '404':
          description: Plugin not found.
      security:
      - apiKey: []
        apiToken: []
    put:
      operationId: updatePlugin
      summary: Update a Plugin
      description: Updates a Power-Up plugin's information.
      tags:
      - Plugins
      parameters:
      - $ref: '#/components/parameters/idParam'
      responses:
        '200':
          description: Successfully updated the plugin.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Plugin'
        '401':
          description: Unauthorized.
        '404':
          description: Plugin not found.
      security:
      - apiKey: []
        apiToken: []
    servers:
    - url: https://api.trello.com/1
      description: Trello API v1 Production Server
  /plugins/{id}/listings:
    post:
      operationId: createPluginListing
      summary: Create a Listing for a Plugin
      description: Creates a new marketplace listing for a Power-Up plugin.
      tags:
      - Plugins
      parameters:
      - $ref: '#/components/parameters/idParam'
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                description:
                  type: string
                  description: The description for the listing.
                locale:
                  type: string
                  description: The locale for the listing.
                overview:
                  type: string
                  description: The overview text for the listing.
                name:
                  type: string
                  description: The name for the listing.
      responses:
        '200':
          description: Successfully created the listing.
        '401':
          description: Unauthorized.
        '404':
          description: Plugin not found.
      security:
      - apiKey: []
        apiToken: []
    servers:
    - url: https://api.trello.com/1
      description: Trello API v1 Production Server
  /plugins/{id}/:
    get:
      tags:
      - Plugins
      summary: Get a Plugin
      description: Get plugins
      operationId: get-plugins-id
      security:
      - OAuth2:
        - read:organization:trello
      parameters:
      - name: id
        in: path
        description: The ID or name of the organization
        required: true
        schema:
          $ref: '#/components/schemas/TrelloID'
      deprecated: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Plugin_2'
    put:
      tags:
      - Plugins
      summary: Update a Plugin
      operationId: put-plugins-id
      security:
      - OAuth2:
        - read:organization:trello
        - write:organization:trello
      parameters:
      - name: id
        in: path
        description: The ID or name of the organization
        required: true
        schema:
          $ref: '#/components/schemas/TrelloID'
      deprecated: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Plugin_2'
    servers:
    - url: https://api.trello.com/1
  /plugins/{idPlugin}/listings:
    post:
      tags:
      - Plugins
      summary: Create a Listing for Plugin
      description: Create a new listing for a given locale for your Power-Up
      operationId: post-plugins-idplugin-listing
      security:
      - OAuth2:
        - write:organization:trello
      parameters:
      - name: idPlugin
        in: path
        description: The ID of the Power-Up for which you are creating a new listing.
        required: true
        schema:
          $ref: '#/components/schemas/TrelloID'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                description:
                  type: string
                  description: The description to show for the given locale
                locale:
                  type: string
                  description: The locale that this listing should be displayed for.
                overview:
                  type: string
                  description: The overview to show for the given locale.
                name:
                  type: string
                  description: The name to use for the given locale.
      deprecated: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PluginListing'
    servers:
    - url: https://api.trello.com/1
  /plugins/{id}/compliance/memberPrivacy:
    get:
      tags:
      - Plugins
      summary: Get Plugin's Member privacy compliance
      description: ''
      operationId: get-plugins-id-compliance-memberprivacy
      security:
      - OAuth2: []
      parameters:
      - name: id
        in: path
        description: The ID of the Power-Up
        required: true
        schema:
          $ref: '#/components/schemas/TrelloID'
      deprecated: false
      responses:
        '200':
          description: Success
    servers:
    - url: https://api.trello.com/1
  /plugins/{idPlugin}/listings/{idListing}:
    put:
      tags:
      - Plugins
      summary: Updating Plugin's Listing
      description: Update an existing listing for your Power-Up
      operationId: put-plugins-idplugin-listings-idlisting
      security:
      - OAuth2:
        - write:organization:trello
      parameters:
      - name: idPlugin
        in: path
        description: The ID of the Power-Up whose listing is being updated.
        required: true
        schema:
          $ref: '#/components/schemas/TrelloID'
      - name: idListing
        in: path
        description: The ID of the existing listing for the Power-Up that is being updated.
        required: true
        schema:
          $ref: '#/components/schemas/TrelloID'
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                description:
                  type: string
                  description: The description to show for the given locale
                locale:
                  type: string
                  description: The locale that this listing should be displayed for.
                overview:
                  type: string
                  description: The overview to show for the given locale.
                name:
                  type: string
                  description: The name to use for the given locale.
      deprecated: false
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PluginListing'
    servers:
    - url: https://api.trello.com/1
components:
  parameters:
    idParam:
      name: id
      in: path
      required: true
      description: The ID of the resource.
      schema:
        type: string
  schemas:
    Plugin:
      type: object
      description: Represents a Power-Up plugin that extends Trello functionality.
      properties:
        id:
          type: string
          description: The unique identifier for the plugin.
        name:
          type: string
          description: The name of the plugin.
        public:
          type: boolean
          description: Whether the plugin is publicly available.
        url:
          type: string
          format: uri
          description: The URL for the plugin.
        capabilities:
          type: array
          description: The capabilities provided by the plugin.
          items:
            type: string
        idOrganizationOwner:
          type: string
          description: The ID of the organization that owns the plugin.
    TrelloID:
      type: string
      pattern: ^[0-9a-fA-F]{24}$
      example: 5abbe4b7ddc1b351ef961414
    PluginListing:
      type: object
      properties:
        id:
          $ref: '#/components/schemas/TrelloID'
          example: 5a7cd2f8f99c517f58da1579
        name:
          type: string
          example: Attachment Section Example
        locale:
          type: string
          example: en-US
        description:
          type: string
          example: The [Glitch](https://glitch.com) Power-Up allows you to...
        overview:
          type: string
          example: ''
    Plugin_2:
      type: object
      properties:
        id:
          $ref: '#/components/schemas/TrelloID'
  securitySchemes:
    apiKey:
      type: apiKey
      in: query
      name: key
      description: Your Trello API key, obtained from the Power-Ups admin page at https://trello.com/power-ups/admin.
    apiToken:
      type: apiKey
      in: query
      name: token
      description: A user token that grants access to Trello resources. Obtained by authorizing via the /1/authorize route or OAuth 1.0.
    APIKey:
      type: apiKey
      in: query
      name: key
    APIToken:
      in: query
      name: token
      type: apiKey
    OAuth2:
      type: oauth2
      flows:
        authorizationCode:
          authorizationUrl: https://auth.atlassian.com/authorize
          tokenUrl: https://auth.atlassian.com/authorize/oauth/token
          scopes:
            read:board:trello: Read cards, lists, and comments in boards.
            write:board:trello: Create and update cards, lists, and comments in boards.
            write:board:membership:trello: Add, remove, or modify memberships on boards.
            read:organization:trello: Read workspaces.
            write:organization:trello: Update workspaces.
            write:organization:membership:trello: Add, remove, or modify memberships on workspaces.
            read:member:trello: Read email address, public name, public avatar, and memberships of boards, workspaces, and enterprises.
            write:member:trello: Upload custom emojis and stickers, star boards, and save searches.
            read:enterprise:trello: Read enterprises.
            write:enterprise:trello: Update and manage enterprises.
externalDocs:
  description: Trello REST API Documentation
  url: https://developer.atlassian.com/cloud/trello/rest/
x-refined-from:
- trello-rest-api-openapi.yml
- trello-rest-api-swagger-v3.json