postproxy-dev · Schema
Post
A social media post with per-platform posting results.
Social MediaSoftware-as-a-ServiceMarketingAutomation
Properties
| Name | Type | Description |
|---|---|---|
| id | string | Unique post identifier (id) |
| body | string | Post body/text content |
| status | string | Post-level status |
| source | string | Origin of the post: postproxy (created via app or API) or imported (imported from a connected platform) |
| draft | boolean | Whether the post is a draft |
| scheduled_at | stringnull | ISO 8601 timestamp if scheduled, null otherwise |
| created_at | string | ISO 8601 timestamp of creation |
| queue_id | stringnull | Queue ID if the post belongs to a queue |
| queue_priority | stringnull | Priority level if in a queue |
| media | array | Array of media attachment objects |
| platforms | array | Array of platform-specific posting results. For thread posts, this only describes the parent — each thread item carries its own platforms array. |
| thread | array | Array of thread child posts (only present for thread posts). Each item carries its own platforms array. |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/postproxy-dev/json-schema/postproxy-dev-post-schema.json",
"title": "Post",
"description": "A social media post with per-platform posting results.",
"x-generated": "2026-11-10",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/postproxy-dev-posts-api-openapi.yml#/components/schemas/Post",
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "Unique post identifier (id)"
},
"body": {
"type": "string",
"description": "Post body/text content"
},
"status": {
"type": "string",
"description": "Post-level status",
"enum": [
"draft",
"processing",
"processed",
"scheduled",
"media_processing_failed"
]
},
"source": {
"type": "string",
"description": "Origin of the post: postproxy (created via app or API) or imported (imported from a connected platform)",
"enum": [
"postproxy",
"imported"
]
},
"draft": {
"type": "boolean",
"description": "Whether the post is a draft"
},
"scheduled_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "ISO 8601 timestamp if scheduled, null otherwise"
},
"created_at": {
"type": "string",
"format": "date-time",
"description": "ISO 8601 timestamp of creation"
},
"queue_id": {
"type": [
"string",
"null"
],
"description": "Queue ID if the post belongs to a queue"
},
"queue_priority": {
"type": [
"string",
"null"
],
"description": "Priority level if in a queue",
"enum": [
"high",
"medium",
"low",
null
]
},
"media": {
"type": "array",
"description": "Array of media attachment objects",
"items": {
"$ref": "#/$defs/PostMedia"
}
},
"platforms": {
"type": "array",
"description": "Array of platform-specific posting results. For thread posts, this only describes the parent — each thread item carries its own platforms array.",
"items": {
"$ref": "#/$defs/PostPlatform"
}
},
"thread": {
"type": "array",
"description": "Array of thread child posts (only present for thread posts). Each item carries its own platforms array.",
"items": {
"$ref": "#/$defs/PostThreadChild"
}
}
},
"$defs": {
"PostErrorDetails": {
"type": "object",
"description": "Structured platform error details.",
"properties": {
"platform_error_code": {
"type": [
"string",
"null"
],
"description": "Error code returned by the platform API"
},
"platform_error_subcode": {
"type": [
"string",
"null"
],
"description": "Error subcode returned by the platform API"
},
"platform_error_message": {
"type": [
"string",
"null"
],
"description": "Error message returned by the platform API"
},
"postproxy_note": {
"type": [
"string",
"null"
],
"description": "Additional context from Postproxy about the error"
}
}
},
"PostMedia": {
"type": "object",
"description": "A media attachment on a post.",
"properties": {
"id": {
"type": "string",
"description": "Unique attachment identifier (id)"
},
"status": {
"type": "string",
"description": "Processing status",
"enum": [
"pending",
"processed",
"failed"
]
},
"error_message": {
"type": [
"string",
"null"
],
"description": "Error details if processing failed"
},
"content_type": {
"type": "string",
"description": "MIME type (e.g. image/jpeg, video/mp4)"
},
"source_url": {
"type": [
"string",
"null"
],
"description": "Original source URL if media was provided as a URL"
},
"url": {
"type": [
"string",
"null"
],
"description": "Hosted URL of the processed file (null if not yet processed)"
},
"platforms": {
"type": "array",
"description": "Per-platform formatting/upload errors for this attachment. Only included when at least one platform had an error processing this specific media file; omitted when there are no platform-level errors",
"items": {
"$ref": "#/$defs/PostMediaPlatformError"
}
}
}
},
"PostMediaPlatformError": {
"type": "object",
"description": "A platform-specific error for a media attachment (e.g. format/aspect ratio rejected on Instagram, file size too large on Twitter).",
"properties": {
"platform": {
"type": "string",
"description": "Network identifier (instagram, twitter, etc.)"
},
"status": {
"type": "string",
"description": "Per-platform attachment status"
},
"error": {
"type": "string",
"description": "Error summary for this attachment on this platform"
},
"error_details": {
"oneOf": [
{
"$ref": "#/$defs/PostErrorDetails"
},
{
"type": "null"
}
],
"description": "Structured platform error (omitted when no platform error info is available)"
}
}
},
"PostPlatform": {
"type": "object",
"description": "Platform-specific posting result for a post.",
"properties": {
"platform": {
"type": "string",
"description": "Platform identifier",
"enum": [
"facebook",
"instagram",
"tiktok",
"linkedin",
"youtube",
"twitter",
"threads",
"pinterest"
]
},
"profile_id": {
"type": "string",
"description": "ID of the connected profile this platform entry was posted to"
},
"profile_name": {
"type": "string",
"description": "Display name of the connected profile"
},
"status": {
"type": "string",
"description": "Platform posting status: processing, published, failed, pending_deletion, deleted"
},
"params": {
"type": [
"object",
"null"
],
"description": "Platform-specific parameters used for this post",
"additionalProperties": true
},
"error": {
"type": [
"string",
"null"
],
"description": "Error summary (null on success)"
},
"error_details": {
"oneOf": [
{
"$ref": "#/$defs/PostErrorDetails"
},
{
"type": "null"
}
],
"description": "Structured error details from the platform (null when no platform error info is available)"
},
"attempted_at": {
"type": [
"string",
"null"
],
"format": "date-time",
"description": "ISO 8601 timestamp of posting attempt"
},
"permalink": {
"type": [
"string",
"null"
],
"description": "Direct URL to the published post on the platform. Null if not published or permalink is unavailable"
},
"insights": {
"type": "object",
"description": "Engagement metrics (when available)",
"properties": {
"impressions": {
"type": "integer",
"description": "Number of impressions/views"
},
"on": {
"type": "string",
"format": "date-time",
"description": "ISO 8601 timestamp when insights were captured"
}
}
},
"attachments": {
"type": "array",
"description": "Platform-level files such as the video cover. Only returned by GET /posts/{id}, and omitted when there are none. For imported posts the cover comes from the platform (Instagram Reels, TikTok and LinkedIn videos). Imported TikTok posts have an empty media array, so use the cover as the thumbnail.",
"items": {
"$ref": "#/$defs/PostPlatformAttachment"
}
}
}
},
"PostPlatformAttachment": {
"type": "object",
"description": "A file attached to one platform entry of a post, such as the video cover.",
"properties": {
"id": {
"type": "string",
"description": "Unique attachment identifier"
},
"type": {
"type": "string",
"enum": [
"cover"
],
"description": "Attachment type"
},
"status": {
"type": "string",
"enum": [
"pending",
"processed",
"failed"
],
"description": "Processing status"
},
"content_type": {
"type": [
"string",
"null"
],
"description": "MIME type of the file (e.g. image/jpeg)"
},
"url": {
"type": [
"string",
"null"
],
"description": "Hosted URL of the processed file (null until processed)"
}
}
},
"PostThreadChild": {
"type": "object",
"description": "A thread child post. Carries its own platforms array with the same shape as the parent's, so a half-delivered thread is visible without extra requests.",
"properties": {
"id": {
"type": "string",
"description": "Unique identifier (id) of the child post"
},
"body": {
"type": "string",
"description": "Text content of the child post"
},
"media": {
"type": "array",
"description": "Array of media attachment objects",
"items": {
"$ref": "#/$defs/PostMedia"
}
},
"platforms": {
"type": "array",
"description": "Per-platform delivery results for this thread item (status, permalink, error, error_details)",
"items": {
"$ref": "#/$defs/PostPlatform"
}
}
}
}
}
}
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.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.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/postproxy-dev-post"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"
Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
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.