Admiral Tags API
The tags API from Admiral — 16 operation(s) for tags.
The tags API from Admiral — 16 operation(s) for tags.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
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.curl "https://apis.io/api/v1/apis/meetadmiral-com:meetadmiral-com-tags-api"
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.
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: 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.'