platforms/devplace/rest_projects_gists_news.md
DevPlace REST: Projects, Gists and News
Project, gist and news endpoints: browsing and detail reads, create/edit/delete, private and read-only flags, zip export and fork jobs with their polling endpoints, and the news listing and article reads.
List projects. Returns an HTML page.
Minimal role: Public
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
tab | query | enum | no | Sort selector. Allowed: recent, popular, released. |
search | query | string | no | Search project title, description, and author username. |
project_type | query | enum | no | Filter by type. Allowed: game, gameasset, software, mobileapp, website. |
before | query | string | no | Pagination cursor. |
Sample response
{
"projects": [
{
"uid": "UID",
"slug": "slug",
"user_uid": "UID",
"title": "Title",
"description": "text",
"project_type": "string",
"status": "published",
"platforms": null,
"stars": 0,
"is_private": false,
"read_only": false,
"release_date": "string",
"demo_date": "string",
"created_at": "2026-01-01T00:00:00+00:00",
"updated_at": "2026-01-01T00:00:00+00:00",
"author_name": "string",
"my_vote": 0,
"recent_comments": [
{
"comment": {
"uid": "UID",
"user_uid": "UID",
"content": "text",
"parent_uid": "UID",
"target_type": "string",
"target_uid": "UID",
"created_at": "2026-01-01T00:00:00+00:00"
},
"author": {
"uid": "UID",
"username": "username",
"avatar_seed": "string",
"bio": "text",
"location": "string",
"git_link": "string",
"website": "string",
"level": 0,
"xp": 0,
"xp_progress_pct": 0,
"xp_next_level": 0,
"stars": 0,
"created_at": "2026-01-01T00:00:00+00:00",
"last_seen": "string"
},
"time_ago": "2 hours ago",
"votes": {
"up": 0,
"down": 0
},
"my_vote": 0,
"children": [],
"attachments": [
{
"uid": "UID",
"filename": "string",
"url": "/path",
"size": 0,
"is_image": false,
"is_video": false,
"mime_type": "string",
"created_at": "2026-01-01T00:00:00+00:00",
"can_modify": false
}
],
"reactions": {
"counts": {},
"mine": []
}
}
]
}
],
"current_tab": "string",
"search": "string",
"project_type": "string",
"total_count": 0,
"next_cursor": "2026-01-01T00:00:00+00:00",
"total_members": 0,
"top_authors": [
{
"uid": "UID",
"username": "username",
"avatar_seed": "string",
"bio": "text",
"location": "string",
"git_link": "string",
"website": "string",
"level": 0,
"xp": 0,
"xp_progress_pct": 0,
"xp_next_level": 0,
"stars": 0,
"created_at": "2026-01-01T00:00:00+00:00",
"last_seen": "string"
}
]
}GET /projects/{project_slug} - View a project
Render a project with comments. Returns an HTML page.
Minimal role: Public
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
project_slug | path | string | yes | Slug or UID of the project. |
Sample response
{
"maturity": "string",
"project": {
"uid": "UID",
"slug": "slug",
"user_uid": "UID",
"title": "Title",
"description": "text",
"project_type": "string",
"status": "published",
"platforms": null,
"stars": 0,
"is_private": false,
"read_only": false,
"release_date": "string",
"demo_date": "string",
"created_at": "2026-01-01T00:00:00+00:00",
"updated_at": "2026-01-01T00:00:00+00:00"
},
"author": {
"uid": "UID",
"username": "username",
"avatar_seed": "string",
"bio": "text",
"location": "string",
"git_link": "string",
"website": "string",
"level": 0,
"xp": 0,
"xp_progress_pct": 0,
"xp_next_level": 0,
"stars": 0,
"created_at": "2026-01-01T00:00:00+00:00",
"last_seen": "string"
},
"is_owner": false,
"star_count": 0,
"my_vote": 0,
"time_ago": "2 hours ago",
"comments": [
{
"comment": {
"uid": "UID",
"user_uid": "UID",
"content": "text",
"parent_uid": "UID",
"target_type": "string",
"target_uid": "UID",
"created_at": "2026-01-01T00:00:00+00:00"
},
"author": {
"uid": "UID",
"username": "username",
"avatar_seed": "string",
"bio": "text",
"location": "string",
"git_link": "string",
"website": "string",
"level": 0,
"xp": 0,
"xp_progress_pct": 0,
"xp_next_level": 0,
"stars": 0,
"created_at": "2026-01-01T00:00:00+00:00",
"last_seen": "string"
},
"time_ago": "2 hours ago",
"votes": {
"up": 0,
"down": 0
},
"my_vote": 0,
"children": [],
"attachments": [
{
"uid": "UID",
"filename": "string",
"url": "/path",
"size": 0,
"is_image": false,
"is_video": false,
"mime_type": "string",
"created_at": "2026-01-01T00:00:00+00:00",
"can_modify": false
}
],
"reactions": {
"counts": {},
"mine": []
}
}
],
"attachments": [
{
"uid": "UID",
"filename": "string",
"url": "/path",
"size": 0,
"is_image": false,
"is_video": false,
"mime_type": "string",
"created_at": "2026-01-01T00:00:00+00:00",
"can_modify": false
}
],
"reactions": {
"counts": {},
"mine": []
},
"bookmarked": false,
"platforms": null,
"is_private": false,
"read_only": false,
"viewer_can_containers": false,
"viewer_can_workspace": false,
"workspace_editor_url": "/path",
"workspace_editor_mode": "string",
"workspace_editor_width": 0,
"workspace_editor_height": 0,
"forked_from": {},
"fork_count": 0,
"file_count": 0,
"devlog_posts": [
{
"post": {
"uid": "UID",
"slug": "slug",
"user_uid": "UID",
"title": "Title",
"content": "text",
"topic": "random",
"stars": 0,
"image": "string",
"project_uid": "UID",
"created_at": "2026-01-01T00:00:00+00:00",
"updated_at": "2026-01-01T00:00:00+00:00"
},
"maturity": "string",
"author": {
"uid": "UID",
"username": "username",
"avatar_seed": "string",
"bio": "text",
"location": "string",
"git_link": "string",
"website": "string",
"level": 0,
"xp": 0,
"xp_progress_pct": 0,
"xp_next_level": 0,
"stars": 0,
"created_at": "2026-01-01T00:00:00+00:00",
"last_seen": "string"
},
"time_ago": "2 hours ago",
"my_vote": 0,
"comment_count": 0,
"attachments": [
{
"uid": "UID",
"filename": "string",
"url": "/path",
"size": 0,
"is_image": false,
"is_video": false,
"mime_type": "string",
"created_at": "2026-01-01T00:00:00+00:00",
"can_modify": false
}
],
"recent_comments": [
{
"comment": {
"uid": "UID",
"user_uid": "UID",
"content": "text",
"parent_uid": "UID",
"target_type": "string",
"target_uid": "UID",
"created_at": "2026-01-01T00:00:00+00:00"
},
"author": {
"uid": "UID",
"username": "username",
"avatar_seed": "string",
"bio": "text",
"location": "string",
"git_link": "string",
"website": "string",
"level": 0,
"xp": 0,
"xp_progress_pct": 0,
"xp_next_level": 0,
"stars": 0,
"created_at": "2026-01-01T00:00:00+00:00",
"last_seen": "string"
},
"time_ago": "2 hours ago",
"votes": {
"up": 0,
"down": 0
},
"my_vote": 0,
"children": [],
"attachments": [
{
"uid": "UID",
"filename": "string",
"url": "/path",
"size": 0,
"is_image": false,
"is_video": false,
"mime_type": "string",
"created_at": "2026-01-01T00:00:00+00:00",
"can_modify": false
}
],
"reactions": {
"counts": {},
"mine": []
}
}
],
"reactions": {
"counts": {},
"mine": []
},
"bookmarked": false,
"poll": {
"uid": "UID",
"question": "string",
"options": [
{
"uid": "UID",
"label": "string",
"count": 0,
"votes": 0,
"pct": 0
}
],
"total": 0,
"my_choice": "string",
"voted": "string"
},
"project_link": {
"uid": "UID",
"name": "string",
"slug": "slug",
"url": "/path"
}
}
],
"devlog_next_cursor": "2026-01-01T00:00:00+00:00"
}POST /projects/create - Create a project
Publish a project. Redirects to the new project.
Minimal role: Member
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
title | form | string | yes | Title, 1-200 characters. |
description | form | textarea | yes | Description, 1-5000 characters. |
project_type | form | enum | no | Project type. Allowed: game, gameasset, software, mobileapp, website. |
status | form | string | no | Free-form status label. |
platforms | form | string | no | Comma-separated platforms. |
release_date | form | string | no | Optional release date in DD/MM/YYYY format. |
demo_date | form | string | no | Optional demo date in DD/MM/YYYY format. |
Sample response
{
"ok": true,
"redirect": "/projects/PROJECT_SLUG",
"data": {
"uid": "PROJECT_UID",
"slug": "PROJECT_SLUG",
"url": "/projects/PROJECT_SLUG"
}
}POST /projects/edit/{project_slug} - Edit a project
Update an owned project. Redirects to the project.
Minimal role: Member
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
project_slug | path | string | yes | Project slug or uid. |
title | form | string | yes | Title, 1-200 characters. |
description | form | textarea | yes | Description, 1-5000 characters. |
project_type | form | enum | no | Project type. Allowed: game, gameasset, software, mobileapp, website. |
status | form | string | no | Free-form status label. |
platforms | form | string | no | Comma-separated platforms. |
release_date | form | string | no | Optional release date in DD/MM/YYYY format. |
demo_date | form | string | no | Optional demo date in DD/MM/YYYY format. |
POST /projects/delete/{project_slug} - Delete a project
Delete a project you own; administrators may delete any user's project. Soft-deleted with all of its files (hidden everywhere but restorable from admin trash).
Minimal role: Member
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
project_slug | path | string | yes | Slug or UID of the project. |
Sample response
{
"ok": true,
"redirect": "/projects",
"data": null
}POST /projects/{project_slug}/private - Set project visibility
Mark a project you own private or public. Send value=1 for private, value=0 for public. A project you hide as a member stays visible to administrators; a project you hide as an administrator is visible only to you, not to other administrators (this also hides its files and any attached containers).
Minimal role: Member
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
project_slug | path | string | yes | Slug or UID of the project. |
value | form | boolean | yes | 1 to make the project private, 0 to make it public. |
POST /projects/{project_slug}/readonly - Set project read-only
Mark a project you own read-only so all of its files become immutable (no writes, edits, moves, deletes, or uploads succeed), or writable again. Send value=1 for read-only, value=0 for writable.
Minimal role: Member
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
project_slug | path | string | yes | Slug or UID of the project. |
value | form | boolean | yes | 1 to make the project read-only, 0 to make it writable. |
POST /projects/{project_slug}/zip - Queue a project zip
Start a background job that archives the whole project. Returns the job uid and status URL to poll.
Minimal role: Public
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
project_slug | path | string | yes | Slug or UID of the project. |
Sample response
{
"uid": "ZIP_JOB_UID",
"status_url": "/zips/ZIP_JOB_UID"
}GET /zips/{uid} - Zip job status
Poll a zip job. While pending or running download_url is null; once done it points at the archive.
Minimal role: Public
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
uid | path | string | yes | Zip job uid returned when the job was queued. |
Sample response
{
"uid": "ZIP_JOB_UID",
"kind": "zip",
"status": "done",
"preferred_name": "my-project",
"download_url": "/zips/ZIP_JOB_UID/download",
"error": null,
"bytes_in": 20480,
"bytes_out": 8192,
"item_count": 12,
"file_count": 10,
"dir_count": 2,
"created_at": "2026-06-09T10:00:00+00:00",
"completed_at": "2026-06-09T10:00:03+00:00"
}GET /zips/{uid}/download - Download a zip archive
Stream the finished archive as application/zip. Each access extends the retention window.
Minimal role: Public
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
uid | path | string | yes | Zip job uid of a finished job. |
POST /projects/{project_slug}/fork - Queue a project fork
Start a background job that copies the whole project into a new project owned by you. Returns the job uid and status URL to poll.
Minimal role: Member
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
project_slug | path | string | yes | Slug or UID of the project to fork. |
title | form | string | yes | Title for the new forked project. |
Sample response
{
"uid": "FORK_JOB_UID",
"status_url": "/forks/FORK_JOB_UID"
}GET /forks/{uid} - Fork job status
Poll a fork job. While pending or running project_url is null; once done it points at the new project.
Minimal role: Public
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
uid | path | string | yes | Fork job uid returned when the job was queued. |
Sample response
{
"uid": "FORK_JOB_UID",
"kind": "fork",
"status": "done",
"preferred_name": "My Fork",
"project_uid": "NEW_PROJECT_UID",
"project_url": "/projects/new-project-slug",
"source_project_uid": "SOURCE_PROJECT_UID",
"error": null,
"item_count": 12,
"created_at": "2026-06-09T10:00:00+00:00",
"completed_at": "2026-06-09T10:00:05+00:00"
}GET /gists - Browse gists
List code gists. Returns an HTML page.
Minimal role: Public
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
language | query | enum | no | Filter by language. Allowed: python, javascript, typescript, html, css, c, cpp, java, go, rust, sql, bash, json, markdown, plaintext. |
user_uid | query | string | no | Filter by author UID. |
search | query | string | no | Search gist title, description, and author username. |
before | query | string | no | Pagination cursor. |
Sample response
{
"gists": [
{
"gist": {
"uid": "UID",
"slug": "slug",
"user_uid": "UID",
"title": "Title",
"description": "text",
"source_code": "string",
"language": "python",
"stars": 0,
"created_at": "2026-01-01T00:00:00+00:00",
"updated_at": "2026-01-01T00:00:00+00:00"
},
"maturity": "string",
"author": {
"uid": "UID",
"username": "username",
"avatar_seed": "string",
"bio": "text",
"location": "string",
"git_link": "string",
"website": "string",
"level": 0,
"xp": 0,
"xp_progress_pct": 0,
"xp_next_level": 0,
"stars": 0,
"created_at": "2026-01-01T00:00:00+00:00",
"last_seen": "string"
},
"time_ago": "2 hours ago",
"my_vote": 0,
"comment_count": 0,
"recent_comments": [
{
"comment": {
"uid": "UID",
"user_uid": "UID",
"content": "text",
"parent_uid": "UID",
"target_type": "string",
"target_uid": "UID",
"created_at": "2026-01-01T00:00:00+00:00"
},
"author": {
"uid": "UID",
"username": "username",
"avatar_seed": "string",
"bio": "text",
"location": "string",
"git_link": "string",
"website": "string",
"level": 0,
"xp": 0,
"xp_progress_pct": 0,
"xp_next_level": 0,
"stars": 0,
"created_at": "2026-01-01T00:00:00+00:00",
"last_seen": "string"
},
"time_ago": "2 hours ago",
"votes": {
"up": 0,
"down": 0
},
"my_vote": 0,
"children": [],
"attachments": [
{
"uid": "UID",
"filename": "string",
"url": "/path",
"size": 0,
"is_image": false,
"is_video": false,
"mime_type": "string",
"created_at": "2026-01-01T00:00:00+00:00",
"can_modify": false
}
],
"reactions": {
"counts": {},
"mine": []
}
}
]
}
],
"total_count": 0,
"next_cursor": "2026-01-01T00:00:00+00:00",
"current_language": "python",
"search": "string",
"languages": [
[
"python"
]
],
"gist_language_codes": [
"python"
]
}GET /gists/{gist_slug} - View a gist
Render a gist with comments. Returns an HTML page.
Minimal role: Public
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
gist_slug | path | string | yes | Slug or UID of the gist. |
Sample response
{
"maturity": "string",
"gist": {
"uid": "UID",
"slug": "slug",
"user_uid": "UID",
"title": "Title",
"description": "text",
"source_code": "string",
"language": "python",
"stars": 0,
"created_at": "2026-01-01T00:00:00+00:00",
"updated_at": "2026-01-01T00:00:00+00:00"
},
"author": {
"uid": "UID",
"username": "username",
"avatar_seed": "string",
"bio": "text",
"location": "string",
"git_link": "string",
"website": "string",
"level": 0,
"xp": 0,
"xp_progress_pct": 0,
"xp_next_level": 0,
"stars": 0,
"created_at": "2026-01-01T00:00:00+00:00",
"last_seen": "string"
},
"is_owner": false,
"star_count": 0,
"my_vote": 0,
"time_ago": "2 hours ago",
"comments": [
{
"comment": {
"uid": "UID",
"user_uid": "UID",
"content": "text",
"parent_uid": "UID",
"target_type": "string",
"target_uid": "UID",
"created_at": "2026-01-01T00:00:00+00:00"
},
"author": {
"uid": "UID",
"username": "username",
"avatar_seed": "string",
"bio": "text",
"location": "string",
"git_link": "string",
"website": "string",
"level": 0,
"xp": 0,
"xp_progress_pct": 0,
"xp_next_level": 0,
"stars": 0,
"created_at": "2026-01-01T00:00:00+00:00",
"last_seen": "string"
},
"time_ago": "2 hours ago",
"votes": {
"up": 0,
"down": 0
},
"my_vote": 0,
"children": [],
"attachments": [
{
"uid": "UID",
"filename": "string",
"url": "/path",
"size": 0,
"is_image": false,
"is_video": false,
"mime_type": "string",
"created_at": "2026-01-01T00:00:00+00:00",
"can_modify": false
}
],
"reactions": {
"counts": {},
"mine": []
}
}
],
"attachments": [
{
"uid": "UID",
"filename": "string",
"url": "/path",
"size": 0,
"is_image": false,
"is_video": false,
"mime_type": "string",
"created_at": "2026-01-01T00:00:00+00:00",
"can_modify": false
}
],
"reactions": {
"counts": {},
"mine": []
},
"bookmarked": false
}POST /gists/create - Create a gist
Publish a code snippet. Redirects to the new gist.
Minimal role: Member
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
title | form | string | yes | Title, 1-200 characters. |
source_code | form | textarea | yes | Source, 1-400000 characters. |
language | form | enum | no | Syntax language. Allowed: python, javascript, typescript, html, css, c, cpp, java, go, rust, sql, bash, json, markdown, plaintext. |
description | form | string | no | Optional description. |
Sample response
{
"ok": true,
"redirect": "/gists/GIST_SLUG",
"data": {
"uid": "GIST_UID",
"slug": "GIST_SLUG",
"url": "/gists/GIST_SLUG"
}
}POST /gists/edit/{gist_slug} - Edit a gist
Update a gist you own.
Minimal role: Member
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
gist_slug | path | string | yes | Slug or UID of the gist. |
title | form | string | yes | Title, 1-200 characters. |
source_code | form | textarea | yes | Source, 1-400000 characters. |
language | form | enum | no | Syntax language. Allowed: python, javascript, typescript, html, css, c, cpp, java, go, rust, sql, bash, json, markdown, plaintext. |
description | form | string | no | Optional description. |
Sample response
{
"ok": true,
"redirect": "/gists/GIST_SLUG",
"data": {
"uid": "GIST_UID",
"slug": "GIST_SLUG",
"url": "/gists/GIST_SLUG"
}
}POST /gists/delete/{gist_slug} - Delete a gist
Delete a gist you own; administrators may delete any user's gist. Soft-deleted (hidden everywhere but restorable from admin trash).
Minimal role: Member
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
gist_slug | path | string | yes | Slug or UID of the gist. |
Sample response
{
"ok": true,
"redirect": "/gists",
"data": null
}GET /news - Browse news
Curated developer news. Returns an HTML page.
Minimal role: Public
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
before | query | string | no | Pagination cursor (synced_at). |
Sample response
{
"articles": [
{
"article": {
"uid": "UID",
"slug": "slug",
"title": "Title",
"description": "text",
"content": "text",
"url": "/path",
"source_name": "string",
"author": "string",
"grade": 0,
"ai_grade": 0,
"status": "published",
"image_url": "/path",
"featured": 0,
"has_unique_image": 0,
"article_published": "string",
"created_at": "2026-01-01T00:00:00+00:00",
"synced_at": "2026-01-01T00:00:00+00:00"
},
"time_ago": "2 hours ago",
"image_url": "/path",
"grade": 0,
"featured": 0,
"recent_comments": [
{
"comment": {
"uid": "UID",
"user_uid": "UID",
"content": "text",
"parent_uid": "UID",
"target_type": "string",
"target_uid": "UID",
"created_at": "2026-01-01T00:00:00+00:00"
},
"author": {
"uid": "UID",
"username": "username",
"avatar_seed": "string",
"bio": "text",
"location": "string",
"git_link": "string",
"website": "string",
"level": 0,
"xp": 0,
"xp_progress_pct": 0,
"xp_next_level": 0,
"stars": 0,
"created_at": "2026-01-01T00:00:00+00:00",
"last_seen": "string"
},
"time_ago": "2 hours ago",
"votes": {
"up": 0,
"down": 0
},
"my_vote": 0,
"children": [],
"attachments": [
{
"uid": "UID",
"filename": "string",
"url": "/path",
"size": 0,
"is_image": false,
"is_video": false,
"mime_type": "string",
"created_at": "2026-01-01T00:00:00+00:00",
"can_modify": false
}
],
"reactions": {
"counts": {},
"mine": []
}
}
]
}
],
"next_cursor": "2026-01-01T00:00:00+00:00"
}GET /news/{news_slug} - View a news article
Render a news article with comments. Returns an HTML page.
Minimal role: Public
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
news_slug | path | string | yes | Slug or UID of the article. |
Sample response
{
"maturity": "string",
"article": {
"uid": "UID",
"slug": "slug",
"title": "Title",
"description": "text",
"content": "text",
"url": "/path",
"source_name": "string",
"author": "string",
"grade": 0,
"ai_grade": 0,
"status": "published",
"image_url": "/path",
"featured": 0,
"has_unique_image": 0,
"article_published": "string",
"created_at": "2026-01-01T00:00:00+00:00",
"synced_at": "2026-01-01T00:00:00+00:00"
},
"canonical_slug": "slug",
"image_url": "/path",
"grade": 0,
"time_ago": "2 hours ago",
"comments": [
{
"comment": {
"uid": "UID",
"user_uid": "UID",
"content": "text",
"parent_uid": "UID",
"target_type": "string",
"target_uid": "UID",
"created_at": "2026-01-01T00:00:00+00:00"
},
"author": {
"uid": "UID",
"username": "username",
"avatar_seed": "string",
"bio": "text",
"location": "string",
"git_link": "string",
"website": "string",
"level": 0,
"xp": 0,
"xp_progress_pct": 0,
"xp_next_level": 0,
"stars": 0,
"created_at": "2026-01-01T00:00:00+00:00",
"last_seen": "string"
},
"time_ago": "2 hours ago",
"votes": {
"up": 0,
"down": 0
},
"my_vote": 0,
"children": [],
"attachments": [
{
"uid": "UID",
"filename": "string",
"url": "/path",
"size": 0,
"is_image": false,
"is_video": false,
"mime_type": "string",
"created_at": "2026-01-01T00:00:00+00:00",
"can_modify": false
}
],
"reactions": {
"counts": {},
"mine": []
}
}
],
"bookmarked": false
}