# Draft an existing content post

Transition the content state of an existing content post to draft. A post can be set to draft from any any current state. If the post was published or archived, it will no longer be.  Response body is the updated record. Returns `` if the content cannot be transitioned to 'draft' due to validation reasons.


Endpoint: PUT /v2/content/{content_id}/draft
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)