{"info":{"_postman_id":"ed550539-2edd-4718-a206-80e5f9598079","name":"AppStruct Social — Read-only API starter","description":"<html><head></head><body><h1 id=\"appstruct-social-read-only-rest-starter\">AppStruct Social — read-only REST starter</h1>\n<p>Inspect connected channels, list draft posts, read one selected post and optionally read available analytics. These are REST GET requests. They do not exercise MCP transport or create, edit, schedule, publish, upload or delete anything.</p>\n<h2 id=\"before-the-first-workspace-read\">Before the first workspace read</h2>\n<ol>\n<li>Import or fork this collection into a <strong>private workspace you control</strong>. The public copy contains no account credentials, workspace IDs, post IDs or saved account responses.</li>\n<li>Sign in to AppStruct Social, select the intended workspace and open <a href=\"https://appstruct.ai/dashboard/social/api/connect\">API connection settings</a>. An AppStruct account with Social access is required.</li>\n<li>Use a short-lived key with <strong>social:read</strong> for channels and posts. The optional analytics folder needs <strong>social:analytics:read</strong> as well. No write or publishing scope is needed for this collection. Read access includes unpublished posts in the selected workspace.</li>\n<li>In your private client environment, set <strong>appstruct_social_api_key</strong> to your own key. Keep it out of public collection variables, shared environment values, URLs, screenshots and examples. We do not ask you to send it to us.</li>\n<li>Use Postman desktop or an appropriate agent for this server-to-server API. Direct browser-Origin requests are rejected by AppStruct. Do not weaken the API's access settings to work around a client error.</li>\n</ol>\n<h2 id=\"read-requests-in-order\">Read requests in order</h2>\n<p>The metadata request is public. A successful metadata response does <strong>not</strong> verify an authenticated workspace read.</p>\n<p>Run List channels, compare its names and platforms with your intended Social workspace, then List drafts. An empty list can be correct; it does not establish that you chose the intended workspace. To read a particular draft, choose its ID from your own response and put it in <strong>post_id</strong> in your private environment. The collection never auto-selects a post or saves returned account data into variables.</p>\n<p>The cursor query is disabled initially. If a response provides next_cursor, copy it into your private environment as <strong>next_cursor</strong>, enable the cursor query and keep the state filter unchanged. A null cursor ends the list. Use requests individually: Read one selected post needs your post_id, and analytics needs its separate scope.</p>\n<h2 id=\"interpret-the-result\">Interpret the result</h2>\n<ul>\n<li>401: check key resolution, expiry, revocation and workspace membership.</li>\n<li>403: inspect required scope and client transport; adding a publishing permission is unnecessary.</li>\n<li>404 on one post: check the selected ID and workspace.</li>\n<li>429: respect Retry-After rather than repeatedly sending the request.</li>\n<li>Null analytics values mean unavailable, not zero. Channel totals do not measure website registrations or revenue.</li>\n</ul>\n<p>Do not publish your real responses or execution history as collection examples. A 200 status and a response-shape check are separate from confirming the expected resource and account.</p>\n<p><a href=\"https://blog.appstruct.ai/blog/social-media-mcp-server?utm_source=postman&amp;utm_medium=referral&amp;utm_campaign=social_mcp_launch_20261114&amp;utm_content=rest_starter_01#try-a-read-only-rest-request-in-postman\">Connection guide and draft-review exercise</a></p>\n<p><a href=\"https://appstruct.ai/social?utm_source=postman&amp;utm_medium=referral&amp;utm_campaign=social_mcp_launch_20261114&amp;utm_content=rest_starter_product\">AppStruct Social</a></p>\n<p>Prepared from AppStruct's public Social OpenAPI document on 17 November 2026. The JSON structure and declared GET paths were checked. No authenticated account-read run is claimed for this starter. AppStruct maintains this collection; Postman does not endorse the service.</p>\n</body></html>","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"AppStruct Social — read-only REST starter","slug":"appstruct-social-read-only-rest-starter"}],"owner":"2939209","collectionId":"ed550539-2edd-4718-a206-80e5f9598079","publishedId":"2sBYHbrbki","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-11-17T17:26:20.000Z"},"item":[{"name":"Public metadata — no key","item":[{"name":"00 — Read the public API specification","event":[{"listen":"test","script":{"type":"text/javascript","exec":["pm.test('HTTP 200', () => pm.response.to.have.status(200));","pm.test('OpenAPI metadata', () => { const data = pm.response.json(); pm.expect(data.openapi).to.match(/^3\\./); pm.expect(data.paths).to.be.an('object'); });"],"id":"b22b824a-3bf1-4e2e-9c77-6b2959a1eb75"}}],"id":"80e25ed7-023f-42bf-b444-cb5ceed35a79","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"auth":{"type":"noauth","isInherited":false},"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://api.appstruct.cloud/v1/social/openapi.json","description":"<p>Public metadata only. No key is sent. A 200 response here does not confirm your workspace connection.</p>\n","urlObject":{"protocol":"https","path":["v1","social","openapi.json"],"host":["api","appstruct","cloud"],"query":[],"variable":[]}},"response":[],"_postman_id":"80e25ed7-023f-42bf-b444-cb5ceed35a79"}],"id":"16197805-7576-4cb4-9eee-a3a925b810f4","_postman_id":"16197805-7576-4cb4-9eee-a3a925b810f4","description":"","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{appstruct_social_api_key}}"}]},"isInherited":true,"source":{"_postman_id":"ed550539-2edd-4718-a206-80e5f9598079","id":"ed550539-2edd-4718-a206-80e5f9598079","name":"AppStruct Social — Read-only API starter","type":"collection"}}},{"name":"Workspace reads — social:read","item":[{"name":"01 — List channels","event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":["const key = pm.variables.get('appstruct_social_api_key');","if (typeof key !== 'string' || key.trim() === '' || key.includes('{{')) {","  throw new Error('Set appstruct_social_api_key in a private environment before sending this request.');","}"],"id":"fdeab940-e374-452e-b4af-2a2eed78af84"}},{"listen":"test","script":{"type":"text/javascript","exec":["pm.test('HTTP 200', () => pm.response.to.have.status(200));","pm.test('Channel list shape', () => { const data = pm.response.json(); pm.expect(data.channels).to.be.an('array'); pm.expect(data).to.have.property('next_cursor'); });"],"id":"04a7c7c0-f5e2-490a-9b6c-b137ea42925d"}}],"id":"463ed475-b91f-4219-892d-fdd3dd20bb03","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://api.appstruct.cloud/v1/social/channels?limit=10","description":"<p>Requires social:read. Compare the returned names, platforms and IDs with the workspace you intended to inspect. Empty channels may be correct.</p>\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{appstruct_social_api_key}}"}]},"isInherited":true,"source":{"_postman_id":"ed550539-2edd-4718-a206-80e5f9598079","id":"ed550539-2edd-4718-a206-80e5f9598079","name":"AppStruct Social — Read-only API starter","type":"collection"}},"urlObject":{"protocol":"https","path":["v1","social","channels"],"host":["api","appstruct","cloud"],"query":[{"key":"limit","value":"10"},{"disabled":true,"key":"cursor","value":"{{next_cursor}}"}],"variable":[]}},"response":[],"_postman_id":"463ed475-b91f-4219-892d-fdd3dd20bb03"},{"name":"02 — List draft posts","event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":["const key = pm.variables.get('appstruct_social_api_key');","if (typeof key !== 'string' || key.trim() === '' || key.includes('{{')) {","  throw new Error('Set appstruct_social_api_key in a private environment before sending this request.');","}"],"id":"0d87990e-b1b8-4e07-bb05-2a4ddfcd4d69"}},{"listen":"test","script":{"type":"text/javascript","exec":["pm.test('HTTP 200', () => pm.response.to.have.status(200));","pm.test('Draft list shape', () => { const data = pm.response.json(); pm.expect(data.posts).to.be.an('array'); pm.expect(data).to.have.property('next_cursor'); });"],"id":"622d1ae3-6bd3-44b4-97be-a6162e05ef1b"}}],"id":"7bff5612-4c7d-4e25-a758-93b5be0a7544","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://api.appstruct.cloud/v1/social/posts?state=draft&limit=10","description":"<p>Requires social:read. This response can include unpublished material. Select a post explicitly; no IDs or response data are saved by scripts. Keep state=draft unchanged when paging.</p>\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{appstruct_social_api_key}}"}]},"isInherited":true,"source":{"_postman_id":"ed550539-2edd-4718-a206-80e5f9598079","id":"ed550539-2edd-4718-a206-80e5f9598079","name":"AppStruct Social — Read-only API starter","type":"collection"}},"urlObject":{"protocol":"https","path":["v1","social","posts"],"host":["api","appstruct","cloud"],"query":[{"key":"state","value":"draft"},{"key":"limit","value":"10"},{"disabled":true,"key":"cursor","value":"{{next_cursor}}"}],"variable":[]}},"response":[],"_postman_id":"7bff5612-4c7d-4e25-a758-93b5be0a7544"},{"name":"03 — Read one selected post","event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":["const key = pm.variables.get('appstruct_social_api_key');","if (typeof key !== 'string' || key.trim() === '' || key.includes('{{')) {","  throw new Error('Set appstruct_social_api_key in a private environment before sending this request.');","}","const id = pm.variables.get('post_id');","if (typeof id !== 'string' || !/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(id)) {","  throw new Error('Select post_id from your own List drafts response and set it in a private environment.');","}"],"id":"224d6121-9069-46dd-bd64-6b6139ae7921"}},{"listen":"test","script":{"type":"text/javascript","exec":["pm.test('HTTP 200', () => pm.response.to.have.status(200));","pm.test('Selected resource and revision header', () => { const data = pm.response.json(); pm.expect(data.id).to.eql(pm.variables.get('post_id')); pm.expect(data.state).to.be.a('string'); pm.expect(pm.response.headers.get('ETag')).to.be.a('string'); });"],"id":"96e4066b-e256-485e-876b-161335bbd2df"}}],"id":"94b62411-a7c2-47c7-9867-ffd87b49de1d","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://api.appstruct.cloud/v1/social/posts/{{post_id}}","description":"<p>Requires social:read and a post_id you chose from your own List drafts response. Read the state, complete content and targets. ETag is returned for revision-aware REST workflows; this starter performs no write.</p>\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{appstruct_social_api_key}}"}]},"isInherited":true,"source":{"_postman_id":"ed550539-2edd-4718-a206-80e5f9598079","id":"ed550539-2edd-4718-a206-80e5f9598079","name":"AppStruct Social — Read-only API starter","type":"collection"}},"urlObject":{"protocol":"https","path":["v1","social","posts","{{post_id}}"],"host":["api","appstruct","cloud"],"query":[],"variable":[]}},"response":[],"_postman_id":"94b62411-a7c2-47c7-9867-ffd87b49de1d"}],"id":"cfb79311-9770-4e14-9e3d-f633f19c5dd8","_postman_id":"cfb79311-9770-4e14-9e3d-f633f19c5dd8","description":"","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{appstruct_social_api_key}}"}]},"isInherited":true,"source":{"_postman_id":"ed550539-2edd-4718-a206-80e5f9598079","id":"ed550539-2edd-4718-a206-80e5f9598079","name":"AppStruct Social — Read-only API starter","type":"collection"}}},{"name":"Optional metrics — social:analytics:read","item":[{"name":"04 — Read available analytics (optional)","event":[{"listen":"prerequest","script":{"type":"text/javascript","exec":["const key = pm.variables.get('appstruct_social_api_key');","if (typeof key !== 'string' || key.trim() === '' || key.includes('{{')) {","  throw new Error('Set appstruct_social_api_key in a private environment before sending this request.');","}"],"id":"272535da-0a97-457e-8fe3-88b86de154c8"}},{"listen":"test","script":{"type":"text/javascript","exec":["pm.test('HTTP 200', () => pm.response.to.have.status(200));","pm.test('Period and totals shape', () => { const data = pm.response.json(); pm.expect(data.from).to.be.a('string'); pm.expect(data.to).to.be.a('string'); pm.expect(data.totals).to.be.an('array'); });"],"id":"264c0c00-3369-4aca-b576-0144e8c1ca2a"}}],"id":"eb1f48a3-d6e2-437d-a5da-15d76eb4a8ca","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"Accept","value":"application/json"}],"url":"https://api.appstruct.cloud/v1/social/analytics?days=7","description":"<p>Requires social:analytics:read. Read the returned from/to period with totals. Null metrics are unavailable, not zero; this does not fetch website sessions, conversions or revenue.</p>\n","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{appstruct_social_api_key}}"}]},"isInherited":true,"source":{"_postman_id":"ed550539-2edd-4718-a206-80e5f9598079","id":"ed550539-2edd-4718-a206-80e5f9598079","name":"AppStruct Social — Read-only API starter","type":"collection"}},"urlObject":{"protocol":"https","path":["v1","social","analytics"],"host":["api","appstruct","cloud"],"query":[{"key":"days","value":"7"}],"variable":[]}},"response":[],"_postman_id":"eb1f48a3-d6e2-437d-a5da-15d76eb4a8ca"}],"id":"abfea628-ef15-4fa4-a07f-71adbc1235ad","_postman_id":"abfea628-ef15-4fa4-a07f-71adbc1235ad","description":"","auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{appstruct_social_api_key}}"}]},"isInherited":true,"source":{"_postman_id":"ed550539-2edd-4718-a206-80e5f9598079","id":"ed550539-2edd-4718-a206-80e5f9598079","name":"AppStruct Social — Read-only API starter","type":"collection"}}}],"auth":{"type":"bearer","bearer":{"basicConfig":[{"key":"token","value":"{{appstruct_social_api_key}}"}]}}}