Sign in
article-reviews

Submit an article for review (feedback or publication hand-off).

Changed on
post/api/user/articles/{slug}/review-requests

Request

  • The document declares no server URL.
  • Auth: none declared

Path parameters

slugstring required

Article slug

Request body

collegium_idstring nullable

Review audience: a collegium the author belongs to, or absent for the editorial team. Collegium reviews are feedback-only.

intent'feedback' | 'publication' required

What the author asks of the reviewing side. Stored as the Postgres enum article_review_intent.

messagestring nullable

Optional note posted as the first message in the article's review channel.

Response

Review request created

article_idstring required
collegium_idstring nullable

Review audience; absent for editorial rounds.

collegium_namestring nullable
idstring required
intent'feedback' | 'publication' required

What the author asks of the reviewing side. Stored as the Postgres enum article_review_intent.

resolved_atstring nullable
status'pending' | 'approved' | 'declined' | 'resolved' | 'withdrawn' required

A review request's lifecycle state. Stored as the Postgres enum article_review_request_status.

submitted_atstring required

Changes

  • 1f567b50f90cRevision changes
    • breaking

      request property was restricted to a list of enum values

    • warning

      added the new approved enum value to the response property for the response status

    • warning

      added the new declined enum value to the response property for the response status

    • warning

      added the new feedback enum value to the response property for the response status

    • warning

      added the new pending enum value to the response property for the response status

    • warning

      added the new publication enum value to the response property for the response status

    • warning

      added the new resolved enum value to the response property for the response status

    • warning

      added the new withdrawn enum value to the response property for the response status

    • info

      added the new feedback enum value to the request property

    • info

      added the new publication enum value to the request property

  • a326d816332fRevision changes
    • info

      added the new optional request property

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status