Remove an article, leaving a tombstone

DELETE

/v1/articles/{id}

curl --request DELETE \
  --url https://api.orator.space/v1/articles/example \
  --header 'Authorization: Bearer <token>'

• production
• staging

The identifier and the graph edges survive; the article afterwards answers 410 rather than 404, because it existed and citations to it must keep resolving (§23.2).

Authorizations

• bearerAuth

Parameters

Path Parameters

id

required

string

Responses

200

Remove an article, leaving a tombstone

401

Unauthenticated

Media typeapplication/problem+json

RFC 9457 Problem Details (SPEC 45).

object

type

required

One of https://orator.space/errors/{name}

string format: uri

title

required

string

status

required

integer

detail

string

instance

string

request_id

string

retry_after_seconds

integer

Example^generated

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example",
  "request_id": "example",
  "retry_after_seconds": 1
}

403

Forbidden

Media typeapplication/problem+json

RFC 9457 Problem Details (SPEC 45).

object

type

required

One of https://orator.space/errors/{name}

string format: uri

title

required

string

status

required

integer

detail

string

instance

string

request_id

string

retry_after_seconds

integer

Example^generated

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example",
  "request_id": "example",
  "retry_after_seconds": 1
}

404

Not-found

Media typeapplication/problem+json

RFC 9457 Problem Details (SPEC 45).

object

type

required

One of https://orator.space/errors/{name}

string format: uri

title

required

string

status

required

integer

detail

string

instance

string

request_id

string

retry_after_seconds

integer

Example^generated

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example",
  "request_id": "example",
  "retry_after_seconds": 1
}

410

Gone

Media typeapplication/problem+json

RFC 9457 Problem Details (SPEC 45).

object

type

required

One of https://orator.space/errors/{name}

string format: uri

title

required

string

status

required

integer

detail

string

instance

string

request_id

string

retry_after_seconds

integer

Example^generated

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example",
  "request_id": "example",
  "retry_after_seconds": 1
}

429

Rate-limited (retryable)

Media typeapplication/problem+json

RFC 9457 Problem Details (SPEC 45).

object

type

required

One of https://orator.space/errors/{name}

string format: uri

title

required

string

status

required

integer

detail

string

instance

string

request_id

string

retry_after_seconds

integer

Example^generated

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "example",
  "request_id": "example",
  "retry_after_seconds": 1
}