FOforem
articles
users

User's unpublished articles

Changed on

This endpoint allows the client to retrieve a list of unpublished articles on behalf of an authenticated user.

"Articles" are all the posts that users create on DEV that typically show up in the feed. They can be a blog post, a discussion question, a help thread etc. but is referred to as article within the code.

Unpublished articles will be in reverse chronological creation order.

It will return unpublished articles with pagination. By default a page will contain 30 articles.

get/api/articles/me/unpublished

Request

  • Base URL
    https://dev.to
  • Auth
    • API key in header api-key
    • or HTTP bearer

Query parameters

pageinteger

Pagination page

per_pageinteger

Page size (the number of items to return per page). The default maximum value can be overridden by "API_PER_PAGE_MAX" environment variable.

Response

A List of the authenticated user's Articles

type_ofstring required
idinteger required
titlestring required
descriptionstring required
cover_imagestring url nullable required
readable_publish_datestring required
social_imagestring url required
tag_liststring[] required
tagsstring required
slugstring required
pathstring path required
urlstring url required
canonical_urlstring url required
positive_reactions_countinteger required
public_reactions_countinteger required
created_atstring date-time required
edited_atstring date-time nullable required
crossposted_atstring date-time nullable required
published_atstring date-time required
last_comment_atstring date-time required
published_timestampstring date-time required

Crossposting or published date time

reading_time_minutesinteger required

Reading time, in minutes

ai_disclosure_level'not_disclosed' | 'no_ai' | 'some_ai' | 'fully_autonomous'

Level of AI tooling usage disclosure

ai_disclosure_labelstring

Human-readable label of AI disclosure

Changes

  • v132364ddfcc63Revision changes
    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status

  • v17db6ba099285Revision changes
    • breaking

      removed the media type application/json for the response with the status