API REFERENCE

Delete Artist Social

On this page

DELETE/api/artists/{id}/socials/{socialId}

Remove a social profile link from an artist. Use this to correct a wrongly auto-matched social. This unlinks the social from the artist account; it does not delete the underlying social record, which may still be linked to other accounts.

Authentication

See the authentication guide for API key and account access requirements.

Request

cURL

curl --request DELETE \
  --url 'https://api.recoupable.dev/api/artists/YOUR_ID/socials/YOUR_SOCIAL_ID' \
  --header 'x-api-key: YOUR_API_KEY'

Replace the YOUR_ placeholders with your values. Required query parameters are included; optional parameters are listed below.

Parameters

Path parameters

idstringrequired

The unique identifier of the artist account the social is linked to

socialIdstringrequired

The unique identifier (UUID) of the social profile to unlink from the artist

Responses

200Social profile unlinked successfully

application/json

successbooleanrequired

Whether the social profile was unlinked successfully

socialIdstringrequired

UUID of the social profile that was unlinked from the artist

format: uuid

400Bad request - id or socialId is not a valid UUID

application/json

statusstring · enumrequired

Status of the request

Values: "error"

errorstringrequired

Error message describing what went wrong

401Unauthorized - missing or invalid authentication

No response body schema is specified.

403Forbidden - the authenticated account cannot access this artist

application/json

statusstring · enumrequired

Status of the request

Values: "error"

errorstringrequired

Error message describing what went wrong

404Artist not found or the social is not linked to this artist

application/json

statusstring · enumrequired

Status of the request

Values: "error"

errorstringrequired

Error message describing what went wrong

Full specification

Download the OpenAPI file for complete schemas, constraints, and examples.

Download releases.json

View operation source

json

{
  "description": "Remove a social profile link from an artist. Use this to correct a wrongly auto-matched social. This unlinks the social from the artist account; it does not delete the underlying social record, which may still be linked to other accounts.",
  "parameters": [
    {
      "name": "id",
      "in": "path",
      "description": "The unique identifier of the artist account the social is linked to",
      "required": true,
      "schema": {
        "type": "string",
        "format": "uuid"
      }
    },
    {
      "name": "socialId",
      "in": "path",
      "description": "The unique identifier (UUID) of the social profile to unlink from the artist",
      "required": true,
      "schema": {
        "type": "string",
        "format": "uuid"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "Social profile unlinked successfully",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/DeleteArtistSocialResponse"
          }
        }
      }
    },
    "400": {
      "description": "Bad request - id or socialId is not a valid UUID",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/DeleteArtistErrorResponse"
          }
        }
      }
    },
    "401": {
      "description": "Unauthorized - missing or invalid authentication"
    },
    "403": {
      "description": "Forbidden - the authenticated account cannot access this artist",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/DeleteArtistErrorResponse"
          }
        }
      }
    },
    "404": {
      "description": "Artist not found or the social is not linked to this artist",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/DeleteArtistErrorResponse"
          }
        }
      }
    }
  }
}