> ## Documentation Index
> Fetch the complete documentation index at: https://docs.letterdrop.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Remove target accounts

> Remove companies by id, domain or company page URL. Accounts synced from a CRM are skipped (they would come back on the next sync); remove them in the CRM. Contacts already found at a removed company are kept.



## OpenAPI

````yaml /openapi.json delete /target-accounts
openapi: 3.1.0
info:
  title: Letterdrop Competitor Signals API
  version: 2.0.0
  license:
    name: Proprietary
    url: https://letterdrop.com/terms
  description: >-
    Read your workspace's Competitor Signals data: the accounts showing
    competitor signals, the contacts and signals behind each, their CRM context,
    your outreach, and the dashboard metrics.


    It also manages your target accounts and returns the people who recently
    changed jobs into them (Target accounts), and reads the workspace's buyer
    filters and tracked competitors.


    The API speaks the same language as the New Competitor Deal webhook (payload
    version v2): a field has the same name and the same values in both, so
    whatever you build on one reads the other.


    **Versioning.** The major version is in the path (/api/v2). Within v2
    changes are additive only (new optional fields, filters, endpoints), so
    ignore fields you do not recognise. The v1 Competitor Signals endpoints keep
    working unchanged.


    **Rate limits.** Per workspace: 10 requests/second and 600/minute, plus 20
    uncached computations/minute (analytics count as 4). Cached reads
    (meta.cache = hit), including every later page of a list you already
    started, use no computation budget. Every response carries RateLimit-Limit /
    RateLimit-Remaining / RateLimit-Reset; a 429 carries Retry-After.


    **Freshness.** Results are cached for a few minutes (analytics and filter
    options a little longer); meta.data_as_of says when the data was computed.
    Signals are collected daily, so polling faster than every few minutes
    returns the same data.
servers:
  - url: https://api.letterdrop.com/api/v2
security: []
tags:
  - name: Accounts
    description: Companies with competitor signals, and what we know about each.
  - name: Contacts
    description: The people behind the signals.
  - name: Analytics
    description: The dashboard metrics, one endpoint each.
  - name: Filters
    description: Every key of every object, and how to select and filter on it.
  - name: Target accounts
    description: >-
      The companies you sell to, and the people who just joined them. Writes
      need the mcp.write scope (any API key has it).
  - name: Buyer filters
    description: The companies and people you sell to.
  - name: Tracked competitors
    description: >-
      The competitors you track, and the exec and company pages monitored for
      each.
paths:
  /target-accounts:
    delete:
      tags:
        - Target accounts
      summary: Remove target accounts
      description: >-
        Remove companies by id, domain or company page URL. Accounts synced from
        a CRM are skipped (they would come back on the next sync); remove them
        in the CRM. Contacts already found at a removed company are kept.
      operationId: removeTargetAccounts
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                ids:
                  description: Target account ids, as returned by this API.
                  maxItems: 1000
                  type: array
                  items:
                    type: string
                    minLength: 1
                    maxLength: 64
                company_domains:
                  description: Company domains.
                  maxItems: 1000
                  type: array
                  items:
                    type: string
                    minLength: 1
                    maxLength: 255
                company_linkedin_urls:
                  description: Company page URLs.
                  maxItems: 1000
                  type: array
                  items:
                    type: string
                    minLength: 1
                    maxLength: 500
                    description: >-
                      The company's page URL on the professional network
                      (…/company/<name>).
              additionalProperties: false
            example:
              company_domains:
                - globex.com
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                  - meta
                properties:
                  data:
                    $ref: '#/components/schemas/TargetAccountsRemoved'
                  meta:
                    $ref: '#/components/schemas/Meta'
              example:
                data:
                  removed: 1
                  removed_ids:
                    - 6a1f0c2e9b1d4c0012ab34ce
                  skipped: []
                meta:
                  api_version: '2'
                  data_as_of: '2026-11-02T09:36:28.016Z'
                  cache: 'off'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '403':
          $ref: '#/components/responses/Forbidden'
        '422':
          $ref: '#/components/responses/Unprocessable'
        '429':
          $ref: '#/components/responses/TooManyRequests'
        '500':
          $ref: '#/components/responses/ServerError'
      security:
        - WorkspaceKey: []
        - BearerAuth:
            - mcp.write
components:
  schemas:
    TargetAccountsRemoved:
      type: object
      description: Result of removing target accounts.
      properties:
        removed:
          type: integer
          description: Accounts removed.
        removed_ids:
          type: array
          items:
            type: string
        skipped:
          type: array
          description: Matching accounts that were kept, and why (CRM-synced accounts).
          items:
            type: object
            properties:
              id:
                type: string
              reason:
                type: string
    Meta:
      type: object
      required:
        - api_version
        - data_as_of
        - cache
      properties:
        api_version:
          type: string
          const: '2'
        data_as_of:
          type: string
          format: date-time
          description: >-
            When the data in this response was computed. Responses are cached
            for a few minutes; this tells you how fresh they are.
        cache:
          type: string
          enum:
            - hit
            - miss
            - shared
            - 'off'
          description: >-
            hit = served from cache; miss = computed for this request; shared =
            joined a computation already running for the same query.
    Error:
      type: object
      required:
        - error
      properties:
        error:
          type: object
          required:
            - code
            - message
          properties:
            code:
              type: string
              enum:
                - invalid_request
                - invalid_json
                - invalid_cursor
                - cursor_expired
                - unauthorized
                - forbidden
                - account_not_found
                - not_found
                - rate_limited
                - internal_error
            message:
              type: string
            details:
              type: array
              items:
                type: object
                properties:
                  path:
                    type: string
                  message:
                    type: string
              description: 'For invalid_request: one entry per parameter that failed.'
  responses:
    Unauthorized:
      description: Missing or invalid credential.
      x-status: 401
      x-codes:
        - unauthorized
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Forbidden:
      description: >-
        The credential lacks the scope the operation needs (mcp.read to read,
        mcp.write to write).
      x-status: 403
      x-codes:
        - forbidden
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    Unprocessable:
      description: A parameter failed validation; details lists each one.
      x-status: 422
      x-codes:
        - invalid_request
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
    TooManyRequests:
      description: Rate limited; wait Retry-After seconds.
      x-status: 429
      x-codes:
        - rate_limited
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
      headers:
        Retry-After:
          schema:
            type: integer
          description: Seconds to wait.
    ServerError:
      description: Our fault; retry, and contact support if it persists.
      x-status: 500
      x-codes:
        - internal_error
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/Error'
  securitySchemes:
    WorkspaceKey:
      type: apiKey
      in: header
      name: api-key
    BearerAuth:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.