Admiral Tags API

The tags API from Admiral — 16 operation(s) for tags.

GitHub OpenAPI

Operations 19

GET /accounts/{account_id}/conversion-actions List Conversion Actions #
POST /accounts/{account_id}/conversion-actions Create Conversion Action #
GET /accounts/{account_id}/tag-connections List Connections #
POST /accounts/{account_id}/tag-connections/{connection_id}/activate Activate Connection #
POST /accounts/{account_id}/tag-connections/{connection_id}/hide Hide Connection #
POST /accounts/{account_id}/tag-connections/{connection_id}/unhide Unhide Connection #
POST /accounts/{account_id}/tag-connections/hostinger Connect Hostinger #
GET /accounts/{account_id}/tag-installs List Installs #
POST /accounts/{account_id}/tag-installs Create Install #
GET /accounts/{account_id}/site-fixes/structured-data Structured Data Preview #
POST /accounts/{account_id}/site-fixes/structured-data Structured Data Install #
POST /accounts/{account_id}/tag-connections/github Connect Github #
GET /accounts/{account_id}/tag-installs/{install_id}/pr Install Pr State #
POST /accounts/{account_id}/wordpress/check Check Wordpress #
POST /accounts/{account_id}/wordpress/connect Connect Wordpress #
GET /accounts/{account_id}/wordpress/callback Wordpress Callback #
POST /accounts/{account_id}/tag-connections/{connection_id}/triggers Set Triggers #
POST /accounts/{account_id}/tag-connections/{connection_id}/disconnect Disconnect Connection #
GET /accounts/{account_id}/tag-plugin Download Plugin #

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/meetadmiral-com:meetadmiral-com-tags-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.

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

OpenAPI Specification

meetadmiral-com-tags-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Admiral Tags API
  version: 0.1.0
tags:
- name: Tags
paths:
  /accounts/{account_id}/conversion-actions:
    get:
      tags:
      - Tags
      summary: List Conversion Actions
      description: 'The account''s conversion actions, with the id + label a tag install

        needs — parsed from Google''s own event snippet, so nobody has to know

        what a "conversion label" is, let alone paste one.


        Every action is returned with `installable` and, when it is not, a

        `blocked_reason` saying why. The four UI panels used to filter on

        `conversion_id && conversion_label` themselves, which silently dropped

        every imported, call-only and app conversion — real, enabled conversions

        that simply have no website snippet — and then blamed the sync.


        `synced` separates "we have never pulled this account" from "this

        account genuinely has no conversion actions". They are different

        problems with different answers, and both used to render the same

        sentence.'
      operationId: list_conversion_actions_accounts__account_id__conversion_actions_get
      parameters:
      - name: account_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
          title: Account Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    post:
      tags:
      - Tags
      summary: Create Conversion Action
      description: 'Make one, for the advertiser who has never had one.


        Rides the mutation log with a reverter, like every other change: creating

        a conversion action is a real write into somebody''s Google Ads account,

        and it should be as undoable as pausing a keyword.'
      operationId: create_conversion_action_accounts__account_id__conversion_actions_post
      parameters:
      - name: account_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
          title: Account Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/NewConversionBody'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /accounts/{account_id}/tag-connections:
    get:
      tags:
      - Tags
      summary: List Connections
      operationId: list_connections_accounts__account_id__tag_connections_get
      parameters:
      - name: account_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
          title: Account Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /accounts/{account_id}/tag-connections/{connection_id}/activate:
    post:
      tags:
      - Tags
      summary: Activate Connection
      operationId: activate_connection_accounts__account_id__tag_connections__connection_id__activate_post
      parameters:
      - name: connection_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
          title: Connection Id
      - name: account_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
          title: Account Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ActivateBody'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /accounts/{account_id}/tag-connections/{connection_id}/hide:
    post:
      tags:
      - Tags
      summary: Hide Connection
      description: 'Put a container out of sight — a login often reaches containers that

        aren''t this business''s (an old client''s, an agency''s). Hiding is

        reversible and touches nothing in Tag Manager itself.'
      operationId: hide_connection_accounts__account_id__tag_connections__connection_id__hide_post
      parameters:
      - name: connection_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
          title: Connection Id
      - name: account_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
          title: Account Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /accounts/{account_id}/tag-connections/{connection_id}/unhide:
    post:
      tags:
      - Tags
      summary: Unhide Connection
      operationId: unhide_connection_accounts__account_id__tag_connections__connection_id__unhide_post
      parameters:
      - name: connection_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
          title: Connection Id
      - name: account_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
          title: Account Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /accounts/{account_id}/tag-connections/hostinger:
    post:
      tags:
      - Tags
      summary: Connect Hostinger
      description: 'Connect a site whose files we reach over FTP.


        Called twice: once without `remote_path` to probe, once with it to save.

        Probing stores nothing, so a credential only lands in the database after

        the customer has seen what we found and chosen a page.'
      operationId: connect_hostinger_accounts__account_id__tag_connections_hostinger_post
      parameters:
      - name: account_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
          title: Account Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/HostingerBody'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /accounts/{account_id}/tag-installs:
    get:
      tags:
      - Tags
      summary: List Installs
      operationId: list_installs_accounts__account_id__tag_installs_get
      parameters:
      - name: account_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
          title: Account Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    post:
      tags:
      - Tags
      summary: Create Install
      operationId: create_install_accounts__account_id__tag_installs_post
      parameters:
      - name: account_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
          title: Account Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/InstallBody'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /accounts/{account_id}/site-fixes/structured-data:
    get:
      tags:
      - Tags
      summary: Structured Data Preview
      description: 'What Admiral would add, where it can go, and what is already there.


        Built from what the customer confirmed; `missing` says what to confirm

        first when there is not enough to say anything.'
      operationId: structured_data_preview_accounts__account_id__site_fixes_structured_data_get
      parameters:
      - name: account_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
          title: Account Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
    post:
      tags:
      - Tags
      summary: Structured Data Install
      description: 'Add it, through the mutation log: a receipt, and undo from the Log.'
      operationId: structured_data_install_accounts__account_id__site_fixes_structured_data_post
      parameters:
      - name: account_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
          title: Account Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SiteFixBody'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /accounts/{account_id}/tag-connections/github:
    post:
      tags:
      - Tags
      summary: Connect Github
      description: 'Connect the repository a site deploys from. The token is probed

        before anything is stored — a credential only lands in the database

        once it has proven it can see the repository.'
      operationId: connect_github_accounts__account_id__tag_connections_github_post
      parameters:
      - name: account_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
          title: Account Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GithubBody'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /accounts/{account_id}/tag-installs/{install_id}/pr:
    get:
      tags:
      - Tags
      summary: Install Pr State
      description: 'The one question a parked GitHub install raises: is the pull

        request still open, merged and waiting on a deploy, or closed without

        merging? Answered live from GitHub, per install.'
      operationId: install_pr_state_accounts__account_id__tag_installs__install_id__pr_get
      parameters:
      - name: install_id
        in: path
        required: true
        schema:
          type: string
          title: Install Id
      - name: account_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
          title: Account Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /accounts/{account_id}/wordpress/check:
    post:
      tags:
      - Tags
      summary: Check Wordpress
      description: 'Look at the site the way a stranger would, before asking for anything.


        Every answer here becomes a sentence in the UI, so nothing is a status

        code: "this is a WordPress site", "it already has a tag and here is who

        put it there", "it runs Tag Manager, use that instead".'
      operationId: check_wordpress_accounts__account_id__wordpress_check_post
      parameters:
      - name: account_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
          title: Account Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SiteBody'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /accounts/{account_id}/wordpress/connect:
    post:
      tags:
      - Tags
      summary: Connect Wordpress
      description: Where to send the customer to approve us on their own site.
      operationId: connect_wordpress_accounts__account_id__wordpress_connect_post
      parameters:
      - name: account_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
          title: Account Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/SiteBody'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /accounts/{account_id}/wordpress/callback:
    get:
      tags:
      - Tags
      summary: Wordpress Callback
      description: 'WordPress sends the browser back here with the credential attached.


        Public by necessity — WordPress redirects a browser, it does not call an

        API — so the signed state and the browser-bound nonce cookie are the whole

        of the authorisation. The account id in the path is never trusted on its

        own; it must match the one inside the signature.'
      operationId: wordpress_callback_accounts__account_id__wordpress_callback_get
      parameters:
      - name: account_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
          title: Account Id
      - name: state
        in: query
        required: false
        schema:
          type: string
          default: ''
          title: State
      - name: user_login
        in: query
        required: false
        schema:
          type: string
          default: ''
          title: User Login
      - name: password
        in: query
        required: false
        schema:
          type: string
          default: ''
          title: Password
      - name: site_url
        in: query
        required: false
        schema:
          type: string
          default: ''
          title: Site Url
      - name: success
        in: query
        required: false
        schema:
          type: string
          default: ''
          title: Success
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /accounts/{account_id}/tag-connections/{connection_id}/triggers:
    post:
      tags:
      - Tags
      summary: Set Triggers
      description: 'When should a conversion be reported? Stored on the site, not on one

        install: it is a fact about the website, not about which conversion.'
      operationId: set_triggers_accounts__account_id__tag_connections__connection_id__triggers_post
      parameters:
      - name: connection_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
          title: Connection Id
      - name: account_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
          title: Account Id
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TriggersBody'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /accounts/{account_id}/tag-connections/{connection_id}/disconnect:
    post:
      tags:
      - Tags
      summary: Disconnect Connection
      description: 'Forget the credential for a site.


        The row itself stays: installs point at it, and a receipt that loses the

        site it was for is not a receipt. What goes is the ability to write —

        which is the part the customer is asking us to give up.'
      operationId: disconnect_connection_accounts__account_id__tag_connections__connection_id__disconnect_post
      parameters:
      - name: connection_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
          title: Connection Id
      - name: account_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
          title: Account Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
  /accounts/{account_id}/tag-plugin:
    get:
      tags:
      - Tags
      summary: Download Plugin
      description: 'The plugin file, for the sites we cannot install it on ourselves.


        Base64 in JSON rather than a binary body: the cockpit reaches this through

        a proxy that reads responses as text, and a corrupted zip that only fails

        when a customer tries to upload it is a bad way to find that out.'
      operationId: download_plugin_accounts__account_id__tag_plugin_get
      parameters:
      - name: account_id
        in: path
        required: true
        schema:
          type: string
          format: uuid
          title: Account Id
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    TriggersBody:
      properties:
        thank_you_paths:
          items:
            type: string
          type: array
          title: Thank You Paths
          default: []
        track_tel:
          type: boolean
          title: Track Tel
          default: false
        track_whatsapp:
          type: boolean
          title: Track Whatsapp
          default: false
        track_cf7:
          type: boolean
          title: Track Cf7
          default: false
      type: object
      title: TriggersBody
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ActivateBody:
      properties:
        site_url:
          type: string
          title: Site Url
      type: object
      required:
      - site_url
      title: ActivateBody
    SiteFixBody:
      properties:
        connection_id:
          type: string
          format: uuid
          title: Connection Id
      type: object
      required:
      - connection_id
      title: SiteFixBody
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
            - type: string
            - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
      - loc
      - msg
      - type
      title: ValidationError
    InstallBody:
      properties:
        connection_id:
          type: string
          format: uuid
          title: Connection Id
        conversion_id:
          type: string
          title: Conversion Id
        conversion_label:
          anyOf:
          - type: string
          - type: 'null'
          title: Conversion Label
      type: object
      required:
      - connection_id
      - conversion_id
      title: InstallBody
    SiteBody:
      properties:
        site_url:
          type: string
          title: Site Url
      type: object
      required:
      - site_url
      title: SiteBody
    GithubBody:
      properties:
        repo:
          type: string
          title: Repo
        token:
          type: string
          title: Token
        site_url:
          type: string
          title: Site Url
          default: ''
      type: object
      required:
      - repo
      - token
      title: GithubBody
    NewConversionBody:
      properties:
        name:
          type: string
          title: Name
        category:
          type: string
          title: Category
      type: object
      required:
      - name
      - category
      title: NewConversionBody
    HostingerBody:
      properties:
        site_url:
          type: string
          title: Site Url
          default: ''
        host:
          type: string
          title: Host
          default: ''
        username:
          type: string
          title: Username
          default: ''
        password:
          type: string
          title: Password
          default: ''
        port:
          type: integer
          title: Port
          default: 21
        allow_plaintext:
          type: boolean
          title: Allow Plaintext
          default: false
        remote_path:
          anyOf:
          - type: string
          - type: 'null'
          title: Remote Path
      type: object
      title: HostingerBody
      description: 'Every field has a default and nothing is validated by pydantic.


        That is deliberate: pydantic sets a `missing` error''s `input` to the

        PARENT object, and FastAPI serializes `exc.errors()` into the 422 body —

        so one absent field would hand the customer''s FTP password back out in a

        response that proxies and error trackers routinely capture. We validate

        below instead, and answer with a sentence.'