Publications

Delete a publication

DELETE/v1/publications/{publication_id}

Deletes a not-yet-published publication (draft or scheduled). Already-published content cannot be removed through the API. 404 if it does not exist or is already published.

Required scopewrite:publications

Rate limit60 requests per minute

curl -X DELETE 'https://api.fansquare.so/v1/publications/6136681c-548b-4fca-a86b-8f73b2926652' \
  -H "Authorization: Bearer $API_KEY" \
  -H "Fansquare-Version: Amethyste"

{
  "type": "https://developers.offmy.co/errors/validation_failed",
  "title": "Validation failed",
  "status": 400,
  "instance": "/v1/publications/12345",
  "errors": [
    {
      "keyword": "invalid_string",
      "instancePath": "/publication_id",
      "schemaPath": "#/publication_id/invalid_string",
      "params": {
        "issue": {
          "code": "invalid_string",
          "validation": "uuid",
          "path": [
            "publication_id"
          ],
          "message": "Invalid uuid"
        }
      },
      "message": "Invalid uuid",
      "path": "publication_id"
    }
  ]
}

Parameters

Headers

Fansquare-Versionstringrequired
API version to pin. Accepts the mineral name or the release date of a version.

Path

publication_idstringrequired
Fansquare publication id (the id field of publication items).
format uuid

Response

No content

No response body

curl -X DELETE 'https://api.fansquare.so/v1/publications/6136681c-548b-4fca-a86b-8f73b2926652' \
  -H "Authorization: Bearer $API_KEY" \
  -H "Fansquare-Version: Amethyste"

{
  "type": "https://developers.offmy.co/errors/validation_failed",
  "title": "Validation failed",
  "status": 400,
  "instance": "/v1/publications/12345",
  "errors": [
    {
      "keyword": "invalid_string",
      "instancePath": "/publication_id",
      "schemaPath": "#/publication_id/invalid_string",
      "params": {
        "issue": {
          "code": "invalid_string",
          "validation": "uuid",
          "path": [
            "publication_id"
          ],
          "message": "Invalid uuid"
        }
      },
      "message": "Invalid uuid",
      "path": "publication_id"
    }
  ]
}