posts

For users and admins: the posts routes cover this part of the API. Every route lives under the one public origin, https://venturenetwork.ai, and answers errors as problem types. The interactive version of this page is the live Scalar reference at https://venturenetwork.ai/docs. This page is generated from packages/sdk/openapi.json on every build.

GET /v1/orgs/{slug}/posts

Operation id OrgPostsController_list.

Parameters

Name	In	Required	Type	Notes
limit	query	no	integer
cursor	query	no	string
kind	query	no	any
slug	path	yes	string

Responses

200

Field	Type	Required	Notes
items	array of object	yes
nextCursor	string or null	yes

Problem types

Derived from the source scan (handler, one level of service calls, guards and pipes): membership_pending, membership_suspended, org_not_found, validation_failed.

GET /v1/posts

Operation id PostsController_list.

Parameters

Name	In	Required	Type	Notes
limit	query	no	integer
cursor	query	no	string
author	query	no	string	Only posts a handle wrote.
mine	query	no	boolean	Only posts you wrote.
kind	query	no	any

Responses

200

Field	Type	Required	Notes
items	array of object	yes
nextCursor	string or null	yes

Problem types

Derived from the source scan (handler, one level of service calls, guards and pipes): membership_pending, membership_suspended, validation_failed.

POST /v1/posts

Operation id PostsController_create.

Request body

Field	Type	Required	Notes
kind	string, one of cofounder_wanted, operator_wanted, seeking_investors, idea, hiring, other	yes
title	string	yes	min length 3, max length 140
body	string	yes	max length 4000
tags	array of string	yes	max items 10, default []
expiresAt	string (date-time) or null	yes	default null
publishTo	object	yes	default {"orgSlugs":[],"public":false}
publishTo.orgSlugs	array of string	yes	max items 20, default []
publishTo.public	boolean	yes	default false

Responses

200

Field	Type	Required	Notes
id	string	yes
authorUserId	string	yes
authorHandle	string or null	yes
authorName	string	yes
authorImage	string or null	yes
kind	string, one of cofounder_wanted, operator_wanted, seeking_investors, idea, hiring, other	yes
title	string	yes	min length 3, max length 140
body	string	yes	max length 4000
tags	array of string	yes	max items 10
photo	string or null	yes
status	string, one of open, closed	yes
expired	boolean	yes
expiresAt	string or null	yes
targets	object	yes
targets.orgs	array of object	yes
targets.public	boolean	yes
canEdit	boolean	yes
createdAt	string	yes
updatedAt	string	yes

Problem types

Derived from the source scan (handler, one level of service calls, guards and pipes): membership_pending, membership_suspended, validation_failed.

GET /v1/posts/{id}

Operation id PostsController_read.

Parameters

Name	In	Required	Type	Notes
id	path	yes	string

Responses

200

Field	Type	Required	Notes
id	string	yes
authorUserId	string	yes
authorHandle	string or null	yes
authorName	string	yes
authorImage	string or null	yes
kind	string, one of cofounder_wanted, operator_wanted, seeking_investors, idea, hiring, other	yes
title	string	yes	min length 3, max length 140
body	string	yes	max length 4000
tags	array of string	yes	max items 10
photo	string or null	yes
status	string, one of open, closed	yes
expired	boolean	yes
expiresAt	string or null	yes
targets	object	yes
targets.orgs	array of object	yes
targets.public	boolean	yes
canEdit	boolean	yes
createdAt	string	yes
updatedAt	string	yes

Problem types

Derived from the source scan (handler, one level of service calls, guards and pipes): membership_pending, membership_suspended.

PATCH /v1/posts/{id}

Operation id PostsController_update.

Parameters

Name	In	Required	Type	Notes
id	path	yes	string

Request body

Field	Type	Required	Notes
kind	string, one of cofounder_wanted, operator_wanted, seeking_investors, idea, hiring, other	no
title	string	no	min length 3, max length 140
body	string	no	max length 4000
tags	array of string	no	max items 10
expiresAt	string (date-time) or null	no

Responses

200

Field	Type	Required	Notes
id	string	yes
authorUserId	string	yes
authorHandle	string or null	yes
authorName	string	yes
authorImage	string or null	yes
kind	string, one of cofounder_wanted, operator_wanted, seeking_investors, idea, hiring, other	yes
title	string	yes	min length 3, max length 140
body	string	yes	max length 4000
tags	array of string	yes	max items 10
photo	string or null	yes
status	string, one of open, closed	yes
expired	boolean	yes
expiresAt	string or null	yes
targets	object	yes
targets.orgs	array of object	yes
targets.public	boolean	yes
canEdit	boolean	yes
createdAt	string	yes
updatedAt	string	yes

Problem types

Derived from the source scan (handler, one level of service calls, guards and pipes): membership_pending, membership_suspended, validation_failed.

POST /v1/posts/{id}/close

Operation id PostsController_close.

Parameters

Name	In	Required	Type	Notes
id	path	yes	string

Responses

200

Field	Type	Required	Notes
id	string	yes
authorUserId	string	yes
authorHandle	string or null	yes
authorName	string	yes
authorImage	string or null	yes
kind	string, one of cofounder_wanted, operator_wanted, seeking_investors, idea, hiring, other	yes
title	string	yes	min length 3, max length 140
body	string	yes	max length 4000
tags	array of string	yes	max items 10
photo	string or null	yes
status	string, one of open, closed	yes
expired	boolean	yes
expiresAt	string or null	yes
targets	object	yes
targets.orgs	array of object	yes
targets.public	boolean	yes
canEdit	boolean	yes
createdAt	string	yes
updatedAt	string	yes

Problem types

Derived from the source scan (handler, one level of service calls, guards and pipes): membership_pending, membership_suspended.

PUT /v1/posts/{id}/photo

Operation id PostsController_setPhoto.

Parameters

Name	In	Required	Type	Notes
id	path	yes	string

Responses

200

Field	Type	Required	Notes
id	string	yes
authorUserId	string	yes
authorHandle	string or null	yes
authorName	string	yes
authorImage	string or null	yes
kind	string, one of cofounder_wanted, operator_wanted, seeking_investors, idea, hiring, other	yes
title	string	yes	min length 3, max length 140
body	string	yes	max length 4000
tags	array of string	yes	max items 10
photo	string or null	yes
status	string, one of open, closed	yes
expired	boolean	yes
expiresAt	string or null	yes
targets	object	yes
targets.orgs	array of object	yes
targets.public	boolean	yes
canEdit	boolean	yes
createdAt	string	yes
updatedAt	string	yes

Problem types

Derived from the source scan (handler, one level of service calls, guards and pipes): membership_pending, membership_suspended.

DELETE /v1/posts/{id}/photo

Operation id PostsController_removePhoto.

Parameters

Name	In	Required	Type	Notes
id	path	yes	string

Responses

200

Field	Type	Required	Notes
id	string	yes
authorUserId	string	yes
authorHandle	string or null	yes
authorName	string	yes
authorImage	string or null	yes
kind	string, one of cofounder_wanted, operator_wanted, seeking_investors, idea, hiring, other	yes
title	string	yes	min length 3, max length 140
body	string	yes	max length 4000
tags	array of string	yes	max items 10
photo	string or null	yes
status	string, one of open, closed	yes
expired	boolean	yes
expiresAt	string or null	yes
targets	object	yes
targets.orgs	array of object	yes
targets.public	boolean	yes
canEdit	boolean	yes
createdAt	string	yes
updatedAt	string	yes

Problem types

Derived from the source scan (handler, one level of service calls, guards and pipes): membership_pending, membership_suspended.

PUT /v1/posts/{id}/photo/from-url

Operation id PostsController_setPhotoFromUrl.

Parameters

Name	In	Required	Type	Notes
id	path	yes	string

Request body

Field	Type	Required	Notes
url	string (uri)	yes	max length 2000

Responses

200

Field	Type	Required	Notes
id	string	yes
authorUserId	string	yes
authorHandle	string or null	yes
authorName	string	yes
authorImage	string or null	yes
kind	string, one of cofounder_wanted, operator_wanted, seeking_investors, idea, hiring, other	yes
title	string	yes	min length 3, max length 140
body	string	yes	max length 4000
tags	array of string	yes	max items 10
photo	string or null	yes
status	string, one of open, closed	yes
expired	boolean	yes
expiresAt	string or null	yes
targets	object	yes
targets.orgs	array of object	yes
targets.public	boolean	yes
canEdit	boolean	yes
createdAt	string	yes
updatedAt	string	yes

Problem types

Derived from the source scan (handler, one level of service calls, guards and pipes): membership_pending, membership_suspended, validation_failed.