Skip to main content
Fetch Drafts
Requires the entities bundle. A project without the entities bundle returns 403 database/tables-not-available. See Bundles.
Returns a paginated list of draft entities belonging to the authenticated user. Drafts are invisible to all other users and excluded from all other entity list endpoints until published. Authentication required.

Query Parameters

number
default:"1"
Page number (1-indexed). A whole number of at least 1 — 0, a negative number or a non-integer value returns 400 entity/invalid-query.
number
default:"10"
Number of drafts per page. A whole number of at least 1 — 0, a negative number or a non-integer value returns 400 entity/invalid-query. Maximum 100 — larger values are treated as 100.
string
Filter drafts by sourceId. Pass "null" to return drafts with no sourceId.
string
Filter drafts by space ID.
string
Associations to include. Pass it as one comma-separated value (include=user,space) or as repeated params (include=user&include=space). Values:
  • user — the author’s user profile
  • space — the space the entity belongs to
  • files — uploaded file/image attachments
  • grants — the reputation-grant summary for the entity
Values are case-insensitive. Drafts have no comments and aren’t saved, so topComments and saved aren’t accepted here: any other value returns 400 entity/invalid-query.

Response

Returns a paginated response:
Each item is an Entity with isDraft: true. Results are ordered by most recently updated.

Error Responses

Returned when page or limit is below 1 or not a whole number, or include contains a value that isn’t accepted here.
Returned when no user is authenticated.