# Mark an existing post as ready for review

Change the state of the post to "review". The post is immediately removed from feeds. Posts that are already in "review" state will not change.


Endpoint: PUT /v2/content/{content_id}/review
Version: v2
Security: oauth2_as_a_user, oauth2_as_a_server

## Path parameters:

  - `content_id` (integer, required)
    ID or UUID of the content post

## Response 200 fields (application/json):

  - `data` (object)

  - `data.id` (integer)
    Unique identifier for this post.
    Example: 456

  - `data.version` (integer)
    The version of the content creation studio used to generate the content.
-  - Legacy Studio
-  - Creator Studio
    Enum: 1, 2

  - `data.uuid` (string)
    Example: "8b358e6b-11d4-4e89-bf7f-ec670e3398ed"

  - `data.content_type` (string)
    The type of content. One of: article, image, link, note, or video. The content_type can determine how the post should be presented.
    Example: "article"

  - `data.cover_image_alt` (string)
    The url of the post on the Firstup platform. This property will only be returned for V2 content which can be viewed but not created via the Firstup API.
    Example: "Image of an elephant"

  - `data.permalink_url` (string)
    The url of the post on the Firstup platform.
    Example: "https://onfirstup.com/acme/acmetimes/sc4#contents/456"

  - `data.title` (string)
    The post title. Can also be considered the headline.
    Example: "Example Article Title"

  - `data.summary` (string)
    Short summary of the post.
    Example: "Example article summary"

  - `data.body` (string)
    The body of the post.
    Example: "Example article body"

  - `data.state` (string)
    The state of the post. One of: archived, draft, processing, processing_error, published, review or scheduled.
    Example: "published"

  - `data.accent_color` (string)
    The color of the post, currently only applicable to notes.
    Example: "#ae2225"

  - `data.featured_label` (string)
    The content's feature label
    Example: "Save Pandora!"

  - `data.featured` (boolean)
    Whether the post is featured.

  - `data.author` (object)

  - `data.author.avatar_url` (string)
    Path to an image representing the author.
    Example: "https://example.com/avatar.png"

  - `data.author.display_name` (string)
    The name to display as the author.
    Example: "Some User"

  - `data.author.user_id` (integer)
    The Firstup user_id of the author.
    Example: 123

  - `data.channels` (array)
    A list of the topics this post is published to.

  - `data.channels.id` (integer)
    Unique identifier for the topic.
    Example: 789

  - `data.channels.name` (string)
    Example: "Example Topic Name"

  - `data.source` (object)

  - `data.source.type` (string)
    Example: "studio"

  - `data.source.post_id` (string)
    The unique identifier of the post on the source system, if it is republished from another platform or application.
    Example: "abc123"

  - `data.source.posted_at` (string)
    The timestamp at which the post was published on the source system, if it is republished from another platform or application.
    Example: "2000-01-01T00:00:00Z"

  - `data.template` (object)

  - `data.template.id` (integer)
    Example: 234

  - `data.visibility` (string)
    An indication of the native availability of the post within the Firstup platform. If 'public', the post has a public_link_url and shares of the post should use that url as the canonical url. If 'private', the post requires user authentication to view.
    Enum: "private", "public", "any"

  - `data.shareable_url` (string)
    The publicly shareable url of the post if its visibility is public. Private visibility posts will have no shareable_url.
    Example: "https://onfirstup.com/acme/acmetimes/sc4#contents/456"

  - `data.language` (string)
    The language. For non-translatable posts, this value will be null.
    Example: "en"

  - `data.is_translatable` (boolean)
    Whether the content is translatable.
    Example: true

  - `data.is_commentable` (boolean)
    Whether the content allows comments.
    Example: true

  - `data.comment_count` (integer)
    The number of comments on the content.
    Example: 5

  - `data.created_at` (string)
    When this content was created in ISO8601 format and UTC timezone.
    Example: "2000-01-01T00:00:00Z"

  - `data.updated_at` (string)
    When this content was last updated in ISO8601 format and UTC timezone.
    Example: "2000-01-01T00:00:00Z"

  - `data.published_at` (string)
    When this content was published in ISO8601 format and UTC timezone.
    Example: "2000-01-01T00:00:00Z"

  - `data.links` (array)

  - `data.links.link_url` (string)
    Example: "https://google.com"

  - `data.images` (array)

  - `data.images.id` (integer)
    The unique identifier of this image record
    Example: 678

  - `data.images.image_url` (string)
    Example: "https://cdn.example.com/acme/acmetimes/images/abc123"

  - `data.images.width` (integer)
    The width of the image in pixels
    Example: 1024

  - `data.images.height` (integer)
    The height of the image in pixels
    Example: 768

  - `data.image_blocks` (array)
    All image blocks of Creator Studio content

  - `data.image_blocks.id` (integer)
    The unique identifier of this image block record
    Example: 678

  - `data.image_blocks.alt_text` (string)
    The alt text of the image
    Example: "Example alt text"

  - `data.videos` (array)

  - `data.videos.id` (integer)
    The unique identifier of this video record

  - `data.videos.uuid` (string)
    The unique uuid identifier of this video record. Used in public urls.
    Example: "205ba32a-7f12-439d-b33d-df1c611c8e9c"

  - `data.videos.caption` (string)
    A caption description of this video.
    Example: "Example video caption"

  - `data.videos.state` (string)
    Enum: "completed", "submitted", "error"

  - `data.videos.duration` (integer)
    Length of the video in seconds
    Example: 30

  - `data.videos.preview_image_url` (string)
    A url to an image that acts as a poster for the video before the video is loaded.

  - `data.videos.embed_html` (string)
    An HTML iframe widget that can be used to embed the video in an article.
    Example: "<iframe href='https://onfirstup.com/acme/acmetimes/sc4#contents/456/videos/abc123'></iframe>\n"

  - `data.videos.link_url` (string)
    A link to the video where it can be played
    Example: "https://onfirstup.com/acme/acmetimes/sc4#contents/456/videos/abc123"

  - `data.videos.created_at` (string)
    Example: "2000-01-01T00:00:00Z"

  - `data.initiatives` (array)
    A list of the initiatives.

  - `data.initiatives.id` (integer)
    Unique identifier for the initiative.
    Example: 2

## Response 401 fields (*/*):

  - `errors` (array)

  - `errors.code` (integer)
    Example: 401

  - `errors.title` (string)
    Example: "Unauthenticated"

  - `errors.detail` (string)
    Example: "Access token was not provided or not recognized."

## Response 403 fields (*/*):

  - `errors` (array)

  - `errors.code` (integer)
    Example: 403

  - `errors.title` (string)
    Example: "Unauthorized"

  - `errors.detail` (string)