Live Direct Marketing

Live Direct Marketing API Keys (tenant-scoped) API

The API Keys (tenant-scoped) API from Live Direct Marketing — 6 operation(s) for api keys (tenant-scoped).

GitHub OpenAPI
Business capability
Developer Identity & Credential Management BC-4270.40

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 /api/api-keys List tenant API keys · List tenant API keys (raw key value hidden) #
Ask an LLM
“What API keys exist for my workspace?”
“Does the key list show the secret values?”
Tell an agent
List my tenant API keys.
Show every API key on this account.
POST /api/api-keys Create a tenant API key · Create a new tenant API key. #
Ask an LLM
“How do I create an API key for an AI agent?”
“Can a new key act as me so it can compose and reply to email?”
Tell an agent
Create a new tenant API key.
Make an API key bound to my user so it can act as me.
GET /api/api-keys/whoami Check which key I'm using · Check that the current Bearer credentials (API key or JWT) are valid, and learn… #
Ask an LLM
“Are my current credentials valid, and which tenant are they connected to?”
“How can an agent confirm its API key works before making calls?”
Tell an agent
Check who I am with the current API key.
Verify my bearer credentials and show where they connect.
GET /api/api-keys/{id}/reveal Reveal an API key's secret value · Reveal the raw value of an existing API key. #
Ask an LLM
“Can I see the raw value of an API key I created earlier?”
“Why can't one API key reveal another key's secret?”
Tell an agent
Reveal the secret of API key {id}.
Show me the raw value of key {id}.
GET /api/api-keys/scopes/structured Get the API key scope catalog · Structured scope catalog for the API Keys UI wizard. #
Ask an LLM
“Which scopes can I grant to an API key, and which are dangerous?”
“Are there preset scope bundles like read-only or AI agent?”
Tell an agent
Show the structured scope catalog for API keys.
List the scope presets and grouped scope definitions.
PATCH /api/api-keys/{id} Toggle act-as-me on an API key · Upgrade an existing API key in-place: set/unset Act-as-me. #
Ask an LLM
“Can I upgrade an existing key to act as me without changing its value?”
“Will clients using a key break if I turn on act-as-me?”
Tell an agent
Turn on act-as-me for API key {id}.
Unset act-as-me on key {id} in place.
DELETE /api/api-keys/{id} Permanently delete an API key · Permanently delete a tenant API key #
Ask an LLM
“How do I permanently delete an API key?”
“What's the difference between deleting a key and revoking it?”
Tell an agent destructive · confirm first
Permanently delete API key {id}.
Erase key {id} for good.
DELETE /api/api-keys/{id}/revoke Revoke an API key · Revoke (deactivate) a tenant API key without deleting it #
Ask an LLM
“Can I deactivate an API key but keep its record?”
“How do I stop a leaked key from working without deleting it?”
Tell an agent destructive · confirm first
Revoke API key {id}.
Deactivate key {id} but keep it on file.

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-api-keys-tenant-scoped-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-api-keys-tenant-scoped-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-api-keys-tenant-scoped-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: LDM v3 API Keys (tenant-scoped) 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: API Keys (tenant-scoped)
paths:
  /api/api-keys:
    get:
      operationId: ApiKeysController_list
      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 tenant API keys (raw key value hidden)
      tags:
      - API Keys (tenant-scoped)
    post:
      operationId: ApiKeysController_create
      parameters:
      - name: X-Tenant-Id
        in: header
        required: false
        schema:
          type: string
          format: uuid
        description: Tenant UUID — required for all tenant-scoped endpoints
      responses:
        '201':
          description: ''
      security:
      - jwt: []
      summary: Create a new tenant API key.
      tags:
      - API Keys (tenant-scoped)
  /api/api-keys/whoami:
    get:
      operationId: ApiKeysController_whoami
      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: Check that the current Bearer credentials (API key or JWT) are valid, and learn…
      tags:
      - API Keys (tenant-scoped)
  /api/api-keys/{id}/reveal:
    get:
      operationId: ApiKeysController_reveal
      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: Reveal the raw value of an existing API key.
      tags:
      - API Keys (tenant-scoped)
  /api/api-keys/scopes/structured:
    get:
      operationId: ApiKeysController_structuredScopes
      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: Structured scope catalog for the API Keys UI wizard.
      tags:
      - API Keys (tenant-scoped)
      x-required-scope:
      - keys:read
  /api/api-keys/{id}:
    patch:
      operationId: ApiKeysController_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
      responses:
        '200':
          description: ''
      security:
      - jwt: []
      summary: 'Upgrade an existing API key in-place: set/unset Act-as-me.'
      tags:
      - API Keys (tenant-scoped)
    delete:
      operationId: ApiKeysController_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: Permanently delete a tenant API key
      tags:
      - API Keys (tenant-scoped)
  /api/api-keys/{id}/revoke:
    delete:
      operationId: ApiKeysController_revoke
      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: Revoke (deactivate) a tenant API key without deleting it
      tags:
      - API Keys (tenant-scoped)
components:
  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.