projects

Create a project

Send application/json for a text-only project, or multipart/form-data to include images (hero + up to two extra). The project is owned by the key holder.

post/api/v1/projects

Request

  • Base URL: https://goshipyard.app
  • URL: https://goshipyard.app/api/v1/projects
  • Auth: HTTP bearer

Request body

titlestring required

Project name.

pitchstring required

One-line elevator pitch.

urlstring uri required

Public http(s) link to the project.

repo_urlstring uri

Optional source repo.

category'devtools' | 'ai' | 'games' | 'productivity' | 'design' | 'social' | 'data' | 'creative' | 'other'
bodystring

Optional long-form markdown.

slugstring

Optional URL slug; derived from the title (auto-suffixed) when omitted. Conflicts return 409.

Response

Created.

idstring required
slugstring required
owner_handlestring required
titlestring required
pitchstring required
bodystring required

Long-form markdown.

urlstring uri required
repo_urlstring required
category'devtools' | 'ai' | 'games' | 'productivity' | 'design' | 'social' | 'data' | 'creative' | 'other' required
upvotesinteger required
reviewsinteger required
featuredboolean required
votedboolean

Whether the caller has upvoted this project. Present on single-project reads (GET /projects/{id}) and the upvote endpoints; omitted from list responses.

created_atstring date-time required
html_urlstring uri required

Human-facing project page.

Changes

No recorded changes to this operation across all 1 revision of this API.