What is Free Post? Free Post is basically a type of `post`, with `post_type = 22` * free post requires `postable_type` and `postable_id` * current user must has visibility of `postable` to create a free_post for it. * free post does not take a `channel_id` as input * any API targeting on a single post can be used for `free_post` Please use the regular post `create` API to create a free_post * Here we are applying `compact` serializer to the result.
Every API here is available over the APIs.io API and to AI agents over MCP.
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.curl "https://apis.io/api/v1/apis/shyft-compact-posts-api"curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
openapi: 3.2.0
info:
title: Shyft Customer Compact > Posts API
description: Welcome to the Shyft Customer App API.
version: 1.0.0
servers:
- url: http://{{host}}
- url: http://{{local-host}}
- url: http://{{sp3-host}}
- url: http://test-service.myshyft.com
- url: http://localhost:4001
- url: http://localhost:3000
- url: http://{{local-host}}api
- url: https://test-unfurl.myshyft.com
tags:
- name: Compact > Posts
description: 'What is Free Post?
Free Post is basically a type of `post`, with `post_type = 22`
* free post requires `postable_type` and `postable_id`
* current user must has visibility of `postable` to create a free_post for it.
* free post does not take a `channel_id` as input
* any API targeting on a single post can be used for `free_post`
Please use the regular post `create` API to create a free_post
* Here we are applying `compact` serializer to the result.'
paths:
/api/compact/posts/{post_id}/free_posts:
get:
tags:
- Compact > Posts
summary: get a post's free_posts
parameters:
- name: Session-Uukey
in: header
schema:
type: string
example: 1f01adc9-16a9-49e4-8329-2e8cd8245dad
- name: Content-Type
in: header
schema:
type: string
example: application/json
- name: post_id
in: path
schema:
type: string
required: true
responses:
'200':
description: OK
headers:
Server:
schema:
type: string
example: nginx/1.19.3
Date:
schema:
type: string
example: Mon, 04 Jan 2021 18:48:44 GMT
Content-Type:
schema:
type: string
example: application/json; charset=utf-8
Transfer-Encoding:
schema:
type: string
example: chunked
Connection:
schema:
type: string
example: keep-alive
X-Frame-Options:
schema:
type: string
example: SAMEORIGIN
X-XSS-Protection:
schema:
type: string
example: 1; mode=block
X-Content-Type-Options:
schema:
type: string
example: nosniff
X-Download-Options:
schema:
type: string
example: noopen
X-Permitted-Cross-Domain-Policies:
schema:
type: string
example: none
Referrer-Policy:
schema:
type: string
example: strict-origin-when-cross-origin
X-LS-License:
schema:
type: string
example: All Rights Reserved © Coffee Enterprise
X-LS-Application:
schema:
type: string
example: Coffee Mobile
X-Request-Method:
schema:
type: string
example: none
ETag:
schema:
type: string
example: W/"b655633e741807e188a8badd0230e5fb"
Cache-Control:
schema:
type: string
example: max-age=0, private, must-revalidate
Set-Cookie:
schema:
type: string
example: _shyft_api_server_session=ZVJxK2RvN1BCMmY5cE9OV1oxZ3NHREc4ZFZXcXQ0NkxnaHVWWm96K29kc0lDZk53ZjFpaUFtZTJocGNTbDdVV1E2ZlJqV2VLeWxzUFB0bDFGdldaZEE9PS0tbkNxMDhOTnpnMDcrUENBQ2hxeVkzQT09--354de754d06583a23f894b9027c4baf19cb26ea4; path=/; HttpOnly
X-Rack-Dev-Mark-Env:
schema:
type: string
example: BinLocalServer
X-Request-Id:
schema:
type: string
example: 7e9e3e5a-0a7e-45c1-8a0d-7a2c42e68e73
X-Runtime:
schema:
type: number
example: '4.455284'
Vary:
schema:
type: string
example: Origin
content:
application/json:
schema:
type: object
example:
posts:
- _parent_object_id: null
id: 90207
org_id: 1
channel_id: null
title: Free Post
content: This is a sample free posts 2
comments_count: 0
likes_count: 0
views_count: 0
read_count: 0
created_at: '2020-12-28T22:36:19.713Z'
attachment: null
user_group: 0
location: 2622
post_type: 22
pinned: false
pinned_by_id: null
url_meta: null
giphy_meta: null
postable_type: Post
postable_id: 90204
final_allow_delete: true
final_allow_comment: null
final_allow_like: null
final_allow_read: false
owner_id: 11284
read: false
liked: false
commented: false
- _parent_object_id: null
id: 90206
org_id: 1
channel_id: null
title: Free Post
content: This is a sample free posts 2
comments_count: 0
likes_count: 0
views_count: 0
read_count: 0
created_at: '2020-12-28T22:32:13.682Z'
attachment: null
user_group: 0
location: 2622
post_type: 22
pinned: false
pinned_by_id: null
url_meta: null
giphy_meta: null
postable_type: Post
postable_id: 90204
final_allow_delete: true
final_allow_comment: null
final_allow_like: null
final_allow_read: false
owner_id: 11284
read: false
liked: false
commented: false
- _parent_object_id: null
id: 90205
org_id: 1
channel_id: null
title: Free Post
content: This is a sample free posts
comments_count: 0
likes_count: 0
views_count: 0
read_count: 0
created_at: '2020-12-28T22:11:14.450Z'
attachment: null
user_group: 0
location: 2622
post_type: 22
pinned: false
pinned_by_id: null
url_meta: null
giphy_meta: null
postable_type: Post
postable_id: 90204
final_allow_delete: true
final_allow_comment: null
final_allow_like: null
final_allow_read: false
owner_id: 11284
read: false
liked: false
commented: false
meta:
pagination:
current_page: 1
per_page: 500
operationId: getApiCompactPostsByPostIdFreePosts
x-operation-id-source: derived
/api/compact/posts/{post_id}/get_current_applicants:
get:
tags:
- Compact > Posts
summary: get a post's applicants
description: 'NOTE: Only applicable for `shift post` , otherwise raise `403`'
parameters:
- name: Session-Uukey
in: header
schema:
type: string
example: '{{session_uukey}}'
- name: Content-Type
in: header
schema:
type: string
example: application/json
- name: post_id
in: path
schema:
type: string
required: true
responses:
'200':
description: Successful response
content:
application/json: {}
operationId: getApiCompactPostsByPostIdGetCurrentApplicants
x-operation-id-source: derived
/api/compact/applicants/{applicant_id}/free_posts:
get:
tags:
- Compact > Posts
summary: get a applicant's free_posts
parameters:
- name: Session-Uukey
in: header
schema:
type: string
example: '{{session_uukey}}'
- name: Content-Type
in: header
schema:
type: string
example: application/json
- name: applicant_id
in: path
schema:
type: string
required: true
responses:
'200':
description: OK
headers:
Server:
schema:
type: string
example: nginx/1.19.3
Date:
schema:
type: string
example: Tue, 06 Jul 2021 19:56:21 GMT
Content-Type:
schema:
type: string
example: application/json; charset=utf-8
Transfer-Encoding:
schema:
type: string
example: chunked
Connection:
schema:
type: string
example: keep-alive
X-Frame-Options:
schema:
type: string
example: SAMEORIGIN
X-XSS-Protection:
schema:
type: string
example: 1; mode=block
X-Content-Type-Options:
schema:
type: string
example: nosniff
X-Download-Options:
schema:
type: string
example: noopen
X-Permitted-Cross-Domain-Policies:
schema:
type: string
example: none
Referrer-Policy:
schema:
type: string
example: strict-origin-when-cross-origin
X-LS-License:
schema:
type: string
example: All Rights Reserved © Coffee Enterprise
X-LS-Application:
schema:
type: string
example: Coffee Mobile
X-Request-Method:
schema:
type: string
example: none
ETag:
schema:
type: string
example: W/"d961bac53ea237f583f80266c47ab6a2"
Cache-Control:
schema:
type: string
example: max-age=0, private, must-revalidate
Set-Cookie:
schema:
type: string
example: _shyft_api_server_session=bFVuZVZycGExWVVnT25WNmRCeEpOdDJFa1FXVVlwMjdsOWRjQTJaYUxjYVE3RTZQTzYzY3RTUXBHaXltbFIzd1pIR203aERwODZ6Z2V2Qi9qTituQnc9PS0tMnRjTGg4WW5WMjdadDNsKzcxbG5OUT09--a05195ad7177051ff455bcdd7f103819baad657e; path=/; HttpOnly
X-Rack-Dev-Mark-Env:
schema:
type: string
example: BinLocalServer
X-Request-Id:
schema:
type: string
example: e8bb03b9-9a88-46f5-b05a-8da94d52d6a5
X-Runtime:
schema:
type: number
example: '17.731976'
Vary:
schema:
type: string
example: Origin
content:
application/json:
schema:
type: object
example:
posts:
- _parent_object_id: null
id: 90208
org_id: 1
channel_id: null
title: Free Post
content: This is a sample free posts 2
comments_count: 0
likes_count: 0
views_count: 0
read_count: 0
created_at: '2020-12-28T22:49:26.940Z'
attachment: null
user_group: 0
location: 2622
post_type: 22
pinned: false
pinned_by_id: null
url_meta: null
giphy_meta: null
postable_type: Applicant
postable_id: 3227
final_allow_delete: true
final_allow_comment: null
final_allow_like: true
final_allow_read: false
owner_id: 11284
read: false
liked: false
commented: false
- _parent_object_id: null
id: 90209
org_id: 1
channel_id: null
title: Free Post
content: This is a sample free posts 2
comments_count: 0
likes_count: 0
views_count: 0
read_count: 0
created_at: '2020-12-28T22:49:46.083Z'
attachment: null
user_group: 0
location: 2622
post_type: 22
pinned: false
pinned_by_id: null
url_meta: null
giphy_meta: null
postable_type: Applicant
postable_id: 3227
final_allow_delete: true
final_allow_comment: null
final_allow_like: true
final_allow_read: false
owner_id: 11284
read: false
liked: false
commented: false
- _parent_object_id: null
id: 90210
org_id: 1
channel_id: null
title: Free Post
content: This is a sample free posts 2
comments_count: 0
likes_count: 0
views_count: 0
read_count: 0
created_at: '2020-12-28T22:56:02.386Z'
attachment: null
user_group: 0
location: 2622
post_type: 22
pinned: false
pinned_by_id: null
url_meta: null
giphy_meta: null
postable_type: Applicant
postable_id: 3227
final_allow_delete: true
final_allow_comment: null
final_allow_like: true
final_allow_read: false
owner_id: 11284
read: false
liked: false
commented: false
- _parent_object_id: null
id: 90211
org_id: 1
channel_id: null
title: Free Post
content: This is a sample free posts 2
comments_count: 0
likes_count: 0
views_count: 0
read_count: 0
created_at: '2020-12-28T22:56:33.933Z'
attachment: null
user_group: 0
location: 2622
post_type: 22
pinned: false
pinned_by_id: null
url_meta: null
giphy_meta: null
postable_type: Applicant
postable_id: 3227
final_allow_delete: true
final_allow_comment: null
final_allow_like: true
final_allow_read: false
owner_id: 11284
read: false
liked: false
commented: false
- _parent_object_id: null
id: 90212
org_id: 1
channel_id: null
title: Free Post
content: This is a sample free posts 2
comments_count: 0
likes_count: 0
views_count: 0
read_count: 0
created_at: '2020-12-28T22:58:46.439Z'
attachment: null
user_group: 0
location: 2622
post_type: 22
pinned: false
pinned_by_id: null
url_meta: null
giphy_meta: null
postable_type: Applicant
postable_id: 3227
final_allow_delete: true
final_allow_comment: null
final_allow_like: true
final_allow_read: false
owner_id: 11284
read: false
liked: false
commented: false
- _parent_object_id: null
id: 90213
org_id: 1
channel_id: null
title: Free Post
content: This is a sample free posts 2
comments_count: 0
likes_count: 0
views_count: 0
read_count: 0
created_at: '2020-12-28T22:58:52.005Z'
attachment: null
user_group: 0
location: 2622
post_type: 22
pinned: false
pinned_by_id: null
url_meta: null
giphy_meta: null
postable_type: Applicant
postable_id: 3227
final_allow_delete: true
final_allow_comment: null
final_allow_like: true
final_allow_read: false
owner_id: 11284
read: false
liked: false
commented: false
- _parent_object_id: null
id: 90217
org_id: 1
channel_id: null
title: Free Post
content: This is a sample free posts 2
comments_count: 0
likes_count: 0
views_count: 0
read_count: 0
created_at: '2021-01-04T18:56:00.143Z'
attachment: null
user_group: 0
location: 2622
post_type: 22
pinned: false
pinned_by_id: null
url_meta: null
giphy_meta: null
postable_type: Applicant
postable_id: 3227
final_allow_delete: true
final_allow_comment: null
final_allow_like: true
final_allow_read: false
owner_id: 11284
read: false
liked: false
commented: false
meta:
pagination:
current_page: 1
per_page: 500
operationId: getApiCompactApplicantsByApplicantIdFreePosts
x-operation-id-source: derived
/api/compact/posts/{post_id}/like_owner_ids:
get:
tags:
- Compact > Posts
summary: get a post's like user ids
parameters:
- name: Session-Uukey
in: header
schema:
type: string
example: '{{session_uukey}}'
- name: Content-Type
in: header
schema:
type: string
example: application/json
- name: post_id
in: path
schema:
type: string
required: true
responses:
'200':
description: OK
headers:
Server:
schema:
type: string
example: nginx/1.19.3
Date:
schema:
type: string
example: Tue, 23 Feb 2021 00:00:31 GMT
Content-Type:
schema:
type: string
example: application/json; charset=utf-8
Transfer-Encoding:
schema:
type: string
example: chunked
Connection:
schema:
type: string
example: keep-alive
X-Frame-Options:
schema:
type: string
example: SAMEORIGIN
X-XSS-Protection:
schema:
type: string
example: 1; mode=block
X-Content-Type-Options:
schema:
type: string
example: nosniff
X-Download-Options:
schema:
type: string
example: noopen
X-Permitted-Cross-Domain-Policies:
schema:
type: string
example: none
Referrer-Policy:
schema:
type: string
example: strict-origin-when-cross-origin
X-LS-License:
schema:
type: string
example: All Rights Reserved © Coffee Enterprise
X-LS-Application:
schema:
type: string
example: Coffee Mobile
X-Request-Method:
schema:
type: string
example: none
ETag:
schema:
type: string
example: W/"8b7c1eaa1f5075f74aa267e37733ca50"
Cache-Control:
schema:
type: string
example: max-age=0, private, must-revalidate
Set-Cookie:
schema:
type: string
example: _shyft_api_server_session=d0xBRkgwOWhZaUxTeEJodFZYemZLeVh0Q3pKWjZMYy83QjArMW1WSzR3NVVJc0dXYTlNWm1RaU5Wd3pQUU14UWtsOVFDeElFUnJESktSZ1lxNmY3dmc9PS0tSVc1VEU1MGNFY1g3UG9tcU9oZmlWUT09--ead651306fd1e7c1ae26e38b95c739de346e69d4; path=/; HttpOnly
X-Rack-Dev-Mark-Env:
schema:
type: string
example: BinLocalServer
X-Request-Id:
schema:
type: string
example: 2ccee61b-52a6-47b6-bcca-ea869d961ba7
X-Runtime:
schema:
type: number
example: '22.151550'
Vary:
schema:
type: string
example: Origin
content:
application/json:
schema:
type: object
example:
ids:
- 1
operationId: getApiCompactPostsByPostIdLikeOwnerIds
x-operation-id-source: derived
/api/compact/posts/{post_id}/receipt_user_ids:
get:
tags:
- Compact > Posts
summary: get a post's read user ids
parameters:
- name: Session-Uukey
in: header
schema:
type: string
example: '{{session_uukey}}'
- name: Content-Type
in: header
schema:
type: string
example: application/json
- name: post_id
in: path
schema:
type: string
required: true
responses:
'200':
description: OK
headers:
Server:
schema:
type: string
example: nginx/1.19.3
Date:
schema:
type: string
example: Tue, 23 Feb 2021 00:00:42 GMT
Content-Type:
schema:
type: string
example: application/json; charset=utf-8
Transfer-Encoding:
schema:
type: string
example: chunked
Connection:
schema:
type: string
example: keep-alive
X-Frame-Options:
schema:
type: string
example: SAMEORIGIN
X-XSS-Protection:
schema:
type: string
example: 1; mode=block
X-Content-Type-Options:
schema:
type: string
example: nosniff
X-Download-Options:
schema:
type: string
example: noopen
X-Permitted-Cross-Domain-Policies:
schema:
type: string
example: none
Referrer-Policy:
schema:
type: string
example: strict-origin-when-cross-origin
X-LS-License:
schema:
type: string
example: All Rights Reserved © Coffee Enterprise
X-LS-Application:
schema:
type: string
example: Coffee Mobile
X-Request-Method:
schema:
type: string
example: none
ETag:
schema:
type: string
example: W/"8f05bafd61f29998ca102b333f853628"
Cache-Control:
schema:
type: string
example: max-age=0, private, must-revalidate
Set-Cookie:
schema:
type: string
example: _shyft_api_server_session=RFBidm1QVXZyMzNzL1A5a09XdStuSWVTKytwN0E0MVFKSFFCMVY5dm5KaFdCY3hyeS8wMCtENWJzUnNaSFFoUVV4M1dpVEtlZzZSSjFEbWVCVTU3dmc9PS0tbTdlZTFTTFRPeExZQXlnbHJaOXZRQT09--3d440073bd9899ef563ccddcc27627f0ebf9d5f4; path=/; HttpOnly
X-Rack-Dev-Mark-Env:
schema:
type: string
example: BinLocalServer
X-Request-Id:
schema:
type: string
example: d57f09cd-fa28-4a2b-92f4-0ac4b7e3c99d
X-Runtime:
schema:
type: number
example: '0.466136'
Vary:
schema:
type: string
example: Origin
content:
application/json:
schema:
type: object
example:
ids: []
operationId: getApiCompactPostsByPostIdReceiptUserIds
x-operation-id-source: derived
components:
securitySchemes:
bearerAuth:
type: http
scheme: bearer
noauthAuth:
type: http
scheme: noauth