Live Direct Marketing

Live Direct Marketing Tags API

The Tags API from Live Direct Marketing — 8 operation(s) for tags.

GitHub OpenAPI

Operations 10

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 /api/tags List workspace tags · List all tags in the workspace #
Ask an LLM
“What tags exist in my workspace?”
“Can I see every tag I can apply to companies, contacts and leads?”
Tell an agent
List all tags in my workspace.
Show my available tags.
POST /api/tags Create a tag · Create a new tag #
Ask an LLM
“How do I make a new tag for organizing records?”
“Can I give a new tag a color?”
Tell an agent
Create a tag named {name}.
Add a new {color} tag called {name}.
PATCH /api/tags/{id} Rename or recolor a tag · Update an existing tag #
Ask an LLM
“Can I rename a tag I already created?”
“What's the way to change an existing tag's color?”
Tell an agent
Rename tag {id} to {name}.
Change the color of tag {id} to {color}.
DELETE /api/tags/{id} Delete a tag · Delete a tag #
Ask an LLM
“Can I delete a tag from the workspace entirely?”
“How do I get rid of a tag nobody uses?”
Tell an agent destructive · confirm first
Delete tag {id}.
Remove tag {id} from the workspace.
POST /api/tags/companies/{companyId} Tag a company · Attach a tag to a company #
Ask an LLM
“How do I apply a tag to a company?”
“Can I label a company record with an existing tag?”
Tell an agent
Attach tag {tagId} to company {companyId}.
Label company {companyId} with tag {tagId}.
DELETE /api/tags/companies/{companyId}/{tagId} Remove a tag from a company · Detach a tag from a company #
Ask an LLM
“Can I take a tag off a company without deleting the tag?”
“What removes one label from a company record?”
Tell an agent destructive · confirm first
Detach tag {tagId} from company {companyId}.
Untag company {companyId} by removing {tagId}.
POST /api/tags/contacts/{contactId} Tag a contact · Attach a tag to a contact #
Ask an LLM
“Can I add a tag to an individual contact?”
“Is there a way to label a contact with a tag?”
Tell an agent
Attach tag {tagId} to contact {contactId}.
Label contact {contactId} with tag {tagId}.
DELETE /api/tags/contacts/{contactId}/{tagId} Remove a tag from a contact · Detach a tag from a contact #
Ask an LLM
“How do I remove a tag from one contact?”
“Can I untag a contact but keep the tag for others?”
Tell an agent destructive · confirm first
Detach tag {tagId} from contact {contactId}.
Untag contact {contactId} by removing {tagId}.
POST /api/tags/leads/{leadId} Tag a lead · Attach a tag to a lead #
Ask an LLM
“Can I put a tag on a lead in my pipeline?”
“Which call labels a lead with a tag?”
Tell an agent
Attach tag {tagId} to lead {leadId}.
Label lead {leadId} with tag {tagId}.
DELETE /api/tags/leads/{leadId}/{tagId} Remove a tag from a lead · Detach a tag from a lead #
Ask an LLM
“How can I take a tag off a lead?”
“Can I untag a single lead without touching other leads?”
Tell an agent destructive · confirm first
Detach tag {tagId} from lead {leadId}.
Untag lead {leadId} by removing {tagId}.

Documentation

📖
Documentation
https://developers.live-direct-marketing.online/
📖
APIReference
https://developers.live-direct-marketing.online/api-reference
📖
GettingStarted
https://developers.live-direct-marketing.online/quickstart
📖
Authentication
https://developers.live-direct-marketing.online/authentication
📖
Documentation
https://check.live-direct-marketing.online/docs
📖
APIReference
https://check.live-direct-marketing.online/api/docs

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/live-direct-marketing-online/refs/heads/main/openapi/live-direct-marketing-online-tags-api-openapi.yml

Other Resources

🔗
DataModel
https://raw.githubusercontent.com/api-evangelist/live-direct-marketing-online/refs/heads/main/data-model/live-direct-marketing-online-data-model.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/live-direct-marketing-online:live-direct-marketing-online-tags-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

live-direct-marketing-online-tags-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: LDM v3 Tags API
  description: 'Multi-tenant B2B outreach automation platform. Auth: JWT Bearer (15-min) or tenant API key (ldm_*) managed in CRM Settings → API Keys. All tenant-scoped endpoints require the X-Tenant-Id header.'
  version: 1.0.0
  contact: {}
servers:
- url: https://api.live-direct-marketing.online
  description: Production
- url: https://api.dev.live-direct-marketing.online
  description: Development
- url: http://127.0.0.1:3000
  description: Local
tags:
- name: Tags
paths:
  /api/tags:
    get:
      operationId: TagsController_findAll
      parameters:
      - name: X-Tenant-Id
        in: header
        required: false
        schema:
          type: string
          format: uuid
        description: Tenant UUID — required for all tenant-scoped endpoints
      responses:
        '200':
          description: ''
      security:
      - jwt: []
      summary: List all tags in the workspace
      tags:
      - Tags
    post:
      operationId: TagsController_create
      parameters:
      - name: X-Tenant-Id
        in: header
        required: false
        schema:
          type: string
          format: uuid
        description: Tenant UUID — required for all tenant-scoped endpoints
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CreateTagDto'
      responses:
        '201':
          description: ''
      security:
      - jwt: []
      summary: Create a new tag
      tags:
      - Tags
  /api/tags/{id}:
    patch:
      operationId: TagsController_update
      parameters:
      - name: id
        required: true
        in: path
        schema:
          type: string
      - name: X-Tenant-Id
        in: header
        required: false
        schema:
          type: string
          format: uuid
        description: Tenant UUID — required for all tenant-scoped endpoints
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateTagDto'
      responses:
        '200':
          description: ''
      security:
      - jwt: []
      summary: Update an existing tag
      tags:
      - Tags
    delete:
      operationId: TagsController_remove
      parameters:
      - name: id
        required: true
        in: path
        schema:
          type: string
      - name: X-Tenant-Id
        in: header
        required: false
        schema:
          type: string
          format: uuid
        description: Tenant UUID — required for all tenant-scoped endpoints
      responses:
        '200':
          description: ''
      security:
      - jwt: []
      summary: Delete a tag
      tags:
      - Tags
  /api/tags/companies/{companyId}:
    post:
      operationId: TagsController_attachToCompany
      parameters:
      - name: companyId
        required: true
        in: path
        schema:
          type: string
      - name: X-Tenant-Id
        in: header
        required: false
        schema:
          type: string
          format: uuid
        description: Tenant UUID — required for all tenant-scoped endpoints
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AttachTagDto'
      responses:
        '201':
          description: ''
      security:
      - jwt: []
      summary: Attach a tag to a company
      tags:
      - Tags
  /api/tags/companies/{companyId}/{tagId}:
    delete:
      operationId: TagsController_detachFromCompany
      parameters:
      - name: companyId
        required: true
        in: path
        schema:
          type: string
      - name: tagId
        required: true
        in: path
        schema:
          type: string
      - name: X-Tenant-Id
        in: header
        required: false
        schema:
          type: string
          format: uuid
        description: Tenant UUID — required for all tenant-scoped endpoints
      responses:
        '200':
          description: ''
      security:
      - jwt: []
      summary: Detach a tag from a company
      tags:
      - Tags
  /api/tags/contacts/{contactId}:
    post:
      operationId: TagsController_attachToContact
      parameters:
      - name: contactId
        required: true
        in: path
        schema:
          type: string
      - name: X-Tenant-Id
        in: header
        required: false
        schema:
          type: string
          format: uuid
        description: Tenant UUID — required for all tenant-scoped endpoints
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AttachTagDto'
      responses:
        '201':
          description: ''
      security:
      - jwt: []
      summary: Attach a tag to a contact
      tags:
      - Tags
  /api/tags/contacts/{contactId}/{tagId}:
    delete:
      operationId: TagsController_detachFromContact
      parameters:
      - name: contactId
        required: true
        in: path
        schema:
          type: string
      - name: tagId
        required: true
        in: path
        schema:
          type: string
      - name: X-Tenant-Id
        in: header
        required: false
        schema:
          type: string
          format: uuid
        description: Tenant UUID — required for all tenant-scoped endpoints
      responses:
        '200':
          description: ''
      security:
      - jwt: []
      summary: Detach a tag from a contact
      tags:
      - Tags
  /api/tags/leads/{leadId}:
    post:
      operationId: TagsController_attachToLead
      parameters:
      - name: leadId
        required: true
        in: path
        schema:
          type: string
      - name: X-Tenant-Id
        in: header
        required: false
        schema:
          type: string
          format: uuid
        description: Tenant UUID — required for all tenant-scoped endpoints
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AttachTagDto'
      responses:
        '201':
          description: ''
      security:
      - jwt: []
      summary: Attach a tag to a lead
      tags:
      - Tags
  /api/tags/leads/{leadId}/{tagId}:
    delete:
      operationId: TagsController_detachFromLead
      parameters:
      - name: leadId
        required: true
        in: path
        schema:
          type: string
      - name: tagId
        required: true
        in: path
        schema:
          type: string
      - name: X-Tenant-Id
        in: header
        required: false
        schema:
          type: string
          format: uuid
        description: Tenant UUID — required for all tenant-scoped endpoints
      responses:
        '200':
          description: ''
      security:
      - jwt: []
      summary: Detach a tag from a lead
      tags:
      - Tags
components:
  schemas:
    UpdateTagDto:
      type: object
      properties:
        name:
          type: string
          maxLength: 50
        color:
          type: string
    AttachTagDto:
      type: object
      properties:
        tagId:
          type: string
      required:
      - tagId
    CreateTagDto:
      type: object
      properties:
        name:
          type: string
          maxLength: 50
        color:
          type: string
      required:
      - name
  securitySchemes:
    jwt:
      scheme: bearer
      bearerFormat: JWT
      type: http
      description: JWT access token from /auth/login (Bearer <token>)
    tenant-api-key:
      scheme: bearer
      bearerFormat: JWT
      type: http
      description: Tenant API key (Bearer ldm_*) for MCP/A2A clients. Issued via CRM Settings → API Keys.
    rpa-service:
      scheme: bearer
      bearerFormat: JWT
      type: http
      description: Dedicated RPA service key. No tenant API-key or query-key authentication.