Create Batch Remove Tags Job

POST

/v1/tags/batch-remove-tags-jobs

Schedule an asynchronous job that removes the tags in data.attributes.tags from a set of companies. Every tag is removed from every selected company. The companies are supplied either as an explicit items array (up to 100 items per request), or as an advanced_search selection that is resolved into companies (up to 100,000) when the job runs. To add tags, use POST /v1/tags/batch-add-tags-jobs — adding and removing are separate jobs.

Returns 202 Accepted with a job handle. Poll GET /v1/tags/batch-remove-tags-jobs/{job_id} to observe progress and the outcome summary.

Credit Note: Removing tags does not consume credits.

INFO

Requires the companies:write OAuth2 scope.

Request

Authorization

API Key

Add parameter in header

X-Api-Key

Example:

X-Api-Key: ********************

Query Params

Body Params application/jsonRequired

Examples

Untag every company matching an advanced searchRemove tags from a set of companies

{
    "data": {
        "attributes": {
            "advanced_search": {
                "filters": {
                    "items": [
                        {
                            "field": "country_code",
                            "operator": "in",
                            "type": "filter",
                            "value": [
                                "DE"
                            ]
                        }
                    ],
                    "operator": "and",
                    "type": "group"
                },
                "page": {
                    "size": 1000
                }
            },
            "tags": [
                {
                    "id": "3f7a1b9c0e5d2648",
                    "type": "tag"
                }
            ]
        },
        "type": "batch_remove_tags_job"
    }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

cURL

Untag every company matching an advanced searchRemove tags from a set of companies

curl --location 'https://api.leadfeeder.com/v1/tags/batch-remove-tags-jobs?account_id=123456' \
--header 'X-Api-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "data": {
        "attributes": {
            "advanced_search": {
                "filters": {
                    "items": [
                        {
                            "field": "country_code",
                            "operator": "in",
                            "type": "filter",
                            "value": [
                                "DE"
                            ]
                        }
                    ],
                    "operator": "and",
                    "type": "group"
                },
                "page": {
                    "size": 1000
                }
            },
            "tags": [
                {
                    "id": "3f7a1b9c0e5d2648",
                    "type": "tag"
                }
            ]
        },
        "type": "batch_remove_tags_job"
    }
}'

Responses

🟢202Accepted

application/json

Batch remove-tags job accepted and enqueued

Bodyapplication/json

Example

{
    "data": {
        "attributes": {
            "completed_at": null,
            "configuration": {
                "items": [
                    {
                        "id": "159001425",
                        "type": "company"
                    },
                    {
                        "id": "159001426",
                        "type": "company"
                    }
                ],
                "tags": [
                    {
                        "id": "3f7a1b9c0e5d2648",
                        "type": "tag"
                    }
                ]
            },
            "created_at": "2026-05-13T12:00:00Z",
            "status": "running"
        },
        "id": "job_550e8400-e29b-41d4-a716-446655440000",
        "type": "batch_remove_tags_job"
    },
    "meta": {
        "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
    }
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠422Parameter Error

🟠429

🔴500Server Error

🔴504Gateway Timeout

Modified at 2026-09-17 07:46:23

Delete Tag

Get Batch Remove Tags Job