1. Competitors
swonkie.dev
  • Introduction
  • 🆕 MCP Server
  • Changelog
  • Quick Start
  • Social Networks
    • Instagram v2
    • Google My Business
    • YouTube
    • X (Twitter)
    • Threads
    • Instagram
    • LinkedIn
    • TikTok
    • Facebook
  • ✨ Andie
    • Generate an Image
      POST
  • Search
    • Search Profiles
      GET
  • Profiles
    • My Profiles
      GET
    • Competitors
      GET
  • Competitors
    • Add Competitor
      POST
    • Delete Competitor
      DELETE
  • Insights
    • Getting Started
    • My Profile Insights Metrics
      GET
    • My Profile Insights
      GET
    • My Profile Insights Posts
      GET
    • Competitor Insights Metrics
      GET
    • Competitor Insights
      GET
    • Competitor Insights Posts
      GET
  • Posts
    • Getting Started
    • Limits by Social Network
    • List Posts
    • Get a Post
    • Create a Post
    • Update a Post
    • Validate a Post
    • Delete a Post
    • Change Post Stage
  • Labels
    • Getting Started
    • List Labels
    • Create a Label
  • Media
    • Get a Media
    • Create a Media
    • Upload File to Media
    • Confirm Uploaded Media
    • Delete a Media
    • Create a Media from URL
  • Examples
    • Publish
Back to Home
Back to Home
Login
  1. Competitors

Delete Competitor

DELETE
/competitor/{competitorId}
Removes a competitor from your workspace.
Only the workspace association is deleted — the underlying social profile record is not affected and can be re-added as a competitor at any time.
Use the id field from GET /competitors or POST /competitor as the {competitorId} path parameter.

Request

Path Params

Header Params

Responses

🟢200
application/json
Bodyapplication/json

🟠404Competitor not found
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request DELETE 'https://api.swonkie.dev/v2/competitor/d3hQY09Bc0hUUDhQbElKRUhldGN2dz09' \
--header 'X-API-ID: ' \
--header 'X-API-KEY: '
Response Response Example
200 - 200 OK
{
    "success": true
}
Modified at 2026-06-22 10:56:00
Previous
Add Competitor
Next
Insights
Built with