Metricool Third Party Apps Api Service API

openapi: 3.2.0
info:
  title: Metricool Third Party Apps Api Service API
  description: 'Metricool API


    The base URL for all endpoints is: https://app.metricool.com/api


    All endpoints require authentication.'
  version: 2.0.0
servers:
- url: https://app.metricool.com/api
tags:
- name: Third Party Apps Api Service
paths:
  /v2/settings/third-party-apps:
    get:
      tags:
      - Third Party Apps Api Service
      summary: Returns the third-party applications with OAuth access to the current user's…
      operationId: connectedApplications
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/ConnectedApplicationDto'
  /v2/settings/third-party-apps/{clientId}:
    delete:
      tags:
      - Third Party Apps Api Service
      summary: 'Revokes the application the client belongs to: consent and refresh tokens of…'
      operationId: revokeConnection
      parameters:
      - name: clientId
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: OK
components:
  schemas:
    ConnectedApplicationDto:
      required:
      - clientIds
      - name
      - verified
      type: object
      properties:
        id:
          type: string
          description: Identifier to revoke the application with. One of its client ids. Absent when the application is not connected, which only happens to verified partners.
          example: client_01JK66GEG4CRJBCZWGZBATBJCJ
        name:
          type: string
          description: Display name. The verified partner's name when verified, otherwise the name the client declared on registration, which is self-reported and must not be used to brand it.
          example: Claude
        redirectUri:
          type: string
          description: First redirect URI the client registered. Lets the user identify unverified applications by their origin; a loopback address means a local application. Absent when the client registered none.
          example: https://claude.ai/api/mcp/auth_callback
        verified:
          type: boolean
          description: Whether Metricool vouches for this application ("Reconocida" badge).
        partnerKey:
          type: string
          description: Stable identifier of the verified partner. Absent for unverified applications.
          example: adobe-express
        logoUrl:
          type: string
          description: Logo to show for verified partners. Absent for unverified applications.
          example: /resources/front/img/settings/integrations/icon-adobe.svg
        descriptionKey:
          type: string
          description: i18n key of the verified partner's description. Absent for unverified applications.
          example: settings.integrations.partnerDescriptions.adobeExpress
        connectUrl:
          type: string
          description: Page where the user starts connecting the verified partner. Absent for unverified applications.
          example: https://help.metricool.com/adobe-express-integration-yi4k5
        clientIds:
          type: array
          description: Every OAuth client id grouped under this application. Empty when not connected.
          items:
            type: string
            description: Every OAuth client id grouped under this application. Empty when not connected.
      description: 'Third-party application on the user''s Integrations screen: one with OAuth access to the account, or a verified partner the user has not connected. Groups every OAuth client registered by the same application; revoking it revokes all of them.'