Posts
Publish and schedule social media posts across 7 platforms. Supports per-platform overrides, media attachments, and timezone-aware scheduling.
Authorization
ApiKeyAuth AuthorizationBearer <token>
API key from your Aether dashboard
In: header
Query Parameters
status?string
Filter by post status
profileId?string
Filter to posts targeting a specific profile
page?integer
perPage?integer
Response Body
application/json
application/json
curl -X GET "https://example.com/posts"{ "success": true, "data": { "items": [ { "id": "post_abc123", "organizationId": "string", "status": "draft", "text": "string", "mediaUrls": [ "http://example.com" ], "mediaKeys": [ "string" ], "profileIds": [ "string" ], "overrides": { "property1": { "text": "string", "mediaUrls": [ "http://example.com" ], "firstComment": "string", "contentType": "feed", "userTags": [ { "username": "string", "x": 0, "y": 0, "mediaIndex": 0 } ], "collaborators": [ "string" ], "thumbOffset": 0, "instagramThumbnail": "http://example.com", "shareToFeed": true, "threadItems": [ { "text": "string", "mediaUrls": [ "http://example.com" ] } ], "topicTag": "string", "carouselCards": [ { "link": "http://example.com", "name": "string", "description": "string" }, { "link": "http://example.com", "name": "string", "description": "string" } ], "carouselLink": "http://example.com", "pageId": "string", "organizationUrn": "string", "documentTitle": "string", "disableLinkPreview": true }, "property2": { "text": "string", "mediaUrls": [ "http://example.com" ], "firstComment": "string", "contentType": "feed", "userTags": [ { "username": "string", "x": 0, "y": 0, "mediaIndex": 0 } ], "collaborators": [ "string" ], "thumbOffset": 0, "instagramThumbnail": "http://example.com", "shareToFeed": true, "threadItems": [ { "text": "string", "mediaUrls": [ "http://example.com" ] } ], "topicTag": "string", "carouselCards": [ { "link": "http://example.com", "name": "string", "description": "string" }, { "link": "http://example.com", "name": "string", "description": "string" } ], "carouselLink": "http://example.com", "pageId": "string", "organizationUrn": "string", "documentTitle": "string", "disableLinkPreview": true } }, "scheduledFor": "2019-08-24T14:15:22Z", "queueId": "string", "scheduledViaQueue": false, "timezone": "string", "firstComment": "string", "publishedAt": "2019-08-24T14:15:22Z", "failedAt": "2019-08-24T14:15:22Z", "failureCode": "ALL_TARGETS_FAILED", "failureMessage": "string", "publishResults": [ { "profileId": "string", "platform": "instagram", "status": "pending", "platformPostId": "string", "error": "string", "publishedAt": "2019-08-24T14:15:22Z", "mayHavePublished": true } ], "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z" } ], "total": 0, "hasMore": true }}{ "success": false, "error": { "code": "PROFILE_NOT_FOUND", "message": "string", "details": {} }}Creates a post and publishes it immediately (if no scheduledFor) or queues it for scheduled delivery. Returns the post object with status publishing (immediate) or scheduled. Subscribe to post.published, post.failed, and per-platform post.platform.* webhooks to track publish progress.
Idempotency: Pass a unique x-request-id header (UUID recommended). After a request completes, retries with the same ID within 5 minutes return HTTP 200 with the original response body and X-Cache: HIT. If a duplicate arrives while the first request is still in flight, the API returns HTTP 409 IDEMPOTENCY_IN_PROGRESS immediately — clients should retry after a short delay.
Content deduplication: Identical content to the same profile IDs within 24 hours returns HTTP 409 with existingPostId in the error details.
Authorization
ApiKeyAuth AuthorizationBearer <token>
API key from your Aether dashboard
In: header
Header Parameters
x-request-id?string
Optional client-generated request identifier for safe retries. Completed requests are replayed within ~5 minutes (HTTP 200, X-Cache HIT). Concurrent duplicates receive HTTP 409 IDEMPOTENCY_IN_PROGRESS.
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/posts" \ -H "Content-Type: application/json" \ -d '{ "text": "Shipping something new today 🚀", "profileIds": [ "prof_abc123", "prof_xyz789" ] }'{ "success": true, "data": { "id": "post_abc123", "organizationId": "string", "status": "draft", "text": "string", "mediaUrls": [ "http://example.com" ], "mediaKeys": [ "string" ], "profileIds": [ "string" ], "overrides": { "property1": { "text": "string", "mediaUrls": [ "http://example.com" ], "firstComment": "string", "contentType": "feed", "userTags": [ { "username": "string", "x": 0, "y": 0, "mediaIndex": 0 } ], "collaborators": [ "string" ], "thumbOffset": 0, "instagramThumbnail": "http://example.com", "shareToFeed": true, "threadItems": [ { "text": "string", "mediaUrls": [ "http://example.com" ] } ], "topicTag": "string", "carouselCards": [ { "link": "http://example.com", "name": "string", "description": "string" }, { "link": "http://example.com", "name": "string", "description": "string" } ], "carouselLink": "http://example.com", "pageId": "string", "organizationUrn": "string", "documentTitle": "string", "disableLinkPreview": true }, "property2": { "text": "string", "mediaUrls": [ "http://example.com" ], "firstComment": "string", "contentType": "feed", "userTags": [ { "username": "string", "x": 0, "y": 0, "mediaIndex": 0 } ], "collaborators": [ "string" ], "thumbOffset": 0, "instagramThumbnail": "http://example.com", "shareToFeed": true, "threadItems": [ { "text": "string", "mediaUrls": [ "http://example.com" ] } ], "topicTag": "string", "carouselCards": [ { "link": "http://example.com", "name": "string", "description": "string" }, { "link": "http://example.com", "name": "string", "description": "string" } ], "carouselLink": "http://example.com", "pageId": "string", "organizationUrn": "string", "documentTitle": "string", "disableLinkPreview": true } }, "scheduledFor": "2019-08-24T14:15:22Z", "queueId": "string", "scheduledViaQueue": false, "timezone": "string", "firstComment": "string", "publishedAt": "2019-08-24T14:15:22Z", "failedAt": "2019-08-24T14:15:22Z", "failureCode": "ALL_TARGETS_FAILED", "failureMessage": "string", "publishResults": [ { "profileId": "string", "platform": "instagram", "status": "pending", "platformPostId": "string", "error": "string", "publishedAt": "2019-08-24T14:15:22Z", "mayHavePublished": true } ], "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z" }}{ "success": true, "data": { "id": "post_abc123", "organizationId": "string", "status": "draft", "text": "string", "mediaUrls": [ "http://example.com" ], "mediaKeys": [ "string" ], "profileIds": [ "string" ], "overrides": { "property1": { "text": "string", "mediaUrls": [ "http://example.com" ], "firstComment": "string", "contentType": "feed", "userTags": [ { "username": "string", "x": 0, "y": 0, "mediaIndex": 0 } ], "collaborators": [ "string" ], "thumbOffset": 0, "instagramThumbnail": "http://example.com", "shareToFeed": true, "threadItems": [ { "text": "string", "mediaUrls": [ "http://example.com" ] } ], "topicTag": "string", "carouselCards": [ { "link": "http://example.com", "name": "string", "description": "string" }, { "link": "http://example.com", "name": "string", "description": "string" } ], "carouselLink": "http://example.com", "pageId": "string", "organizationUrn": "string", "documentTitle": "string", "disableLinkPreview": true }, "property2": { "text": "string", "mediaUrls": [ "http://example.com" ], "firstComment": "string", "contentType": "feed", "userTags": [ { "username": "string", "x": 0, "y": 0, "mediaIndex": 0 } ], "collaborators": [ "string" ], "thumbOffset": 0, "instagramThumbnail": "http://example.com", "shareToFeed": true, "threadItems": [ { "text": "string", "mediaUrls": [ "http://example.com" ] } ], "topicTag": "string", "carouselCards": [ { "link": "http://example.com", "name": "string", "description": "string" }, { "link": "http://example.com", "name": "string", "description": "string" } ], "carouselLink": "http://example.com", "pageId": "string", "organizationUrn": "string", "documentTitle": "string", "disableLinkPreview": true } }, "scheduledFor": "2019-08-24T14:15:22Z", "queueId": "string", "scheduledViaQueue": false, "timezone": "string", "firstComment": "string", "publishedAt": "2019-08-24T14:15:22Z", "failedAt": "2019-08-24T14:15:22Z", "failureCode": "ALL_TARGETS_FAILED", "failureMessage": "string", "publishResults": [ { "profileId": "string", "platform": "instagram", "status": "pending", "platformPostId": "string", "error": "string", "publishedAt": "2019-08-24T14:15:22Z", "mayHavePublished": true } ], "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z" }}{ "success": false, "error": { "code": "PROFILE_NOT_FOUND", "message": "string", "details": {} }}{ "success": false, "error": { "code": "PROFILE_NOT_FOUND", "message": "string", "details": {} }}{ "success": false, "error": { "code": "PROFILE_NOT_FOUND", "message": "string", "details": {} }}Upload a CSV file to schedule many posts at once. CSV columns: text (required), profileIds (comma-separated, required), scheduledFor (ISO 8601, optional), mediaUrls (comma-separated URLs, optional). Returns a summary of created and failed rows.
Supports the same x-request-id idempotency semantics as POST /posts — the entire bulk operation is cached, so retrying a failed network call does not re-process rows.
Authorization
ApiKeyAuth AuthorizationBearer <token>
API key from your Aether dashboard
In: header
Header Parameters
x-request-id?string
Optional idempotency key for the whole bulk request.
Request Body
multipart/form-data
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
curl -X POST "https://example.com/posts/bulk" \ -F csv="string"{ "success": true, "created": 0, "failed": 0, "errors": [ { "row": 0, "message": "string" } ]}{ "success": false, "error": { "code": "PROFILE_NOT_FOUND", "message": "string", "details": {} }}{ "success": false, "error": { "code": "PROFILE_NOT_FOUND", "message": "string", "details": {} }}Authorization
ApiKeyAuth AuthorizationBearer <token>
API key from your Aether dashboard
In: header
Path Parameters
postId*string
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/posts/string"{ "success": true, "data": { "id": "post_abc123", "organizationId": "string", "status": "draft", "text": "string", "mediaUrls": [ "http://example.com" ], "mediaKeys": [ "string" ], "profileIds": [ "string" ], "overrides": { "property1": { "text": "string", "mediaUrls": [ "http://example.com" ], "firstComment": "string", "contentType": "feed", "userTags": [ { "username": "string", "x": 0, "y": 0, "mediaIndex": 0 } ], "collaborators": [ "string" ], "thumbOffset": 0, "instagramThumbnail": "http://example.com", "shareToFeed": true, "threadItems": [ { "text": "string", "mediaUrls": [ "http://example.com" ] } ], "topicTag": "string", "carouselCards": [ { "link": "http://example.com", "name": "string", "description": "string" }, { "link": "http://example.com", "name": "string", "description": "string" } ], "carouselLink": "http://example.com", "pageId": "string", "organizationUrn": "string", "documentTitle": "string", "disableLinkPreview": true }, "property2": { "text": "string", "mediaUrls": [ "http://example.com" ], "firstComment": "string", "contentType": "feed", "userTags": [ { "username": "string", "x": 0, "y": 0, "mediaIndex": 0 } ], "collaborators": [ "string" ], "thumbOffset": 0, "instagramThumbnail": "http://example.com", "shareToFeed": true, "threadItems": [ { "text": "string", "mediaUrls": [ "http://example.com" ] } ], "topicTag": "string", "carouselCards": [ { "link": "http://example.com", "name": "string", "description": "string" }, { "link": "http://example.com", "name": "string", "description": "string" } ], "carouselLink": "http://example.com", "pageId": "string", "organizationUrn": "string", "documentTitle": "string", "disableLinkPreview": true } }, "scheduledFor": "2019-08-24T14:15:22Z", "queueId": "string", "scheduledViaQueue": false, "timezone": "string", "firstComment": "string", "publishedAt": "2019-08-24T14:15:22Z", "failedAt": "2019-08-24T14:15:22Z", "failureCode": "ALL_TARGETS_FAILED", "failureMessage": "string", "publishResults": [ { "profileId": "string", "platform": "instagram", "status": "pending", "platformPostId": "string", "error": "string", "publishedAt": "2019-08-24T14:15:22Z", "mayHavePublished": true } ], "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z" }}{ "success": false, "error": { "code": "PROFILE_NOT_FOUND", "message": "string", "details": {} }}{ "success": false, "error": { "code": "PROFILE_NOT_FOUND", "message": "string", "details": {} }}Only posts with status draft, scheduled, or failed can be updated.
Authorization
ApiKeyAuth AuthorizationBearer <token>
API key from your Aether dashboard
In: header
Path Parameters
postId*string
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Partial update — only provided fields are changed. Only allowed while status is draft or scheduled.
Response Body
application/json
application/json
application/json
application/json
curl -X PATCH "https://example.com/posts/string" \ -H "Content-Type: application/json" \ -d '{}'{ "success": true, "data": { "id": "post_abc123", "organizationId": "string", "status": "draft", "text": "string", "mediaUrls": [ "http://example.com" ], "mediaKeys": [ "string" ], "profileIds": [ "string" ], "overrides": { "property1": { "text": "string", "mediaUrls": [ "http://example.com" ], "firstComment": "string", "contentType": "feed", "userTags": [ { "username": "string", "x": 0, "y": 0, "mediaIndex": 0 } ], "collaborators": [ "string" ], "thumbOffset": 0, "instagramThumbnail": "http://example.com", "shareToFeed": true, "threadItems": [ { "text": "string", "mediaUrls": [ "http://example.com" ] } ], "topicTag": "string", "carouselCards": [ { "link": "http://example.com", "name": "string", "description": "string" }, { "link": "http://example.com", "name": "string", "description": "string" } ], "carouselLink": "http://example.com", "pageId": "string", "organizationUrn": "string", "documentTitle": "string", "disableLinkPreview": true }, "property2": { "text": "string", "mediaUrls": [ "http://example.com" ], "firstComment": "string", "contentType": "feed", "userTags": [ { "username": "string", "x": 0, "y": 0, "mediaIndex": 0 } ], "collaborators": [ "string" ], "thumbOffset": 0, "instagramThumbnail": "http://example.com", "shareToFeed": true, "threadItems": [ { "text": "string", "mediaUrls": [ "http://example.com" ] } ], "topicTag": "string", "carouselCards": [ { "link": "http://example.com", "name": "string", "description": "string" }, { "link": "http://example.com", "name": "string", "description": "string" } ], "carouselLink": "http://example.com", "pageId": "string", "organizationUrn": "string", "documentTitle": "string", "disableLinkPreview": true } }, "scheduledFor": "2019-08-24T14:15:22Z", "queueId": "string", "scheduledViaQueue": false, "timezone": "string", "firstComment": "string", "publishedAt": "2019-08-24T14:15:22Z", "failedAt": "2019-08-24T14:15:22Z", "failureCode": "ALL_TARGETS_FAILED", "failureMessage": "string", "publishResults": [ { "profileId": "string", "platform": "instagram", "status": "pending", "platformPostId": "string", "error": "string", "publishedAt": "2019-08-24T14:15:22Z", "mayHavePublished": true } ], "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z" }}{ "success": false, "error": { "code": "PROFILE_NOT_FOUND", "message": "string", "details": {} }}{ "success": false, "error": { "code": "PROFILE_NOT_FOUND", "message": "string", "details": {} }}{ "success": false, "error": { "code": "PROFILE_NOT_FOUND", "message": "string", "details": {} }}Cancels scheduled posts (sets status to cancelled) or permanently deletes drafts. Published posts cannot be deleted via this endpoint.
Authorization
ApiKeyAuth AuthorizationBearer <token>
API key from your Aether dashboard
In: header
Path Parameters
postId*string
Response Body
application/json
application/json
application/json
application/json
curl -X DELETE "https://example.com/posts/string"{ "success": true, "data": { "id": "post_abc123", "organizationId": "string", "status": "draft", "text": "string", "mediaUrls": [ "http://example.com" ], "mediaKeys": [ "string" ], "profileIds": [ "string" ], "overrides": { "property1": { "text": "string", "mediaUrls": [ "http://example.com" ], "firstComment": "string", "contentType": "feed", "userTags": [ { "username": "string", "x": 0, "y": 0, "mediaIndex": 0 } ], "collaborators": [ "string" ], "thumbOffset": 0, "instagramThumbnail": "http://example.com", "shareToFeed": true, "threadItems": [ { "text": "string", "mediaUrls": [ "http://example.com" ] } ], "topicTag": "string", "carouselCards": [ { "link": "http://example.com", "name": "string", "description": "string" }, { "link": "http://example.com", "name": "string", "description": "string" } ], "carouselLink": "http://example.com", "pageId": "string", "organizationUrn": "string", "documentTitle": "string", "disableLinkPreview": true }, "property2": { "text": "string", "mediaUrls": [ "http://example.com" ], "firstComment": "string", "contentType": "feed", "userTags": [ { "username": "string", "x": 0, "y": 0, "mediaIndex": 0 } ], "collaborators": [ "string" ], "thumbOffset": 0, "instagramThumbnail": "http://example.com", "shareToFeed": true, "threadItems": [ { "text": "string", "mediaUrls": [ "http://example.com" ] } ], "topicTag": "string", "carouselCards": [ { "link": "http://example.com", "name": "string", "description": "string" }, { "link": "http://example.com", "name": "string", "description": "string" } ], "carouselLink": "http://example.com", "pageId": "string", "organizationUrn": "string", "documentTitle": "string", "disableLinkPreview": true } }, "scheduledFor": "2019-08-24T14:15:22Z", "queueId": "string", "scheduledViaQueue": false, "timezone": "string", "firstComment": "string", "publishedAt": "2019-08-24T14:15:22Z", "failedAt": "2019-08-24T14:15:22Z", "failureCode": "ALL_TARGETS_FAILED", "failureMessage": "string", "publishResults": [ { "profileId": "string", "platform": "instagram", "status": "pending", "platformPostId": "string", "error": "string", "publishedAt": "2019-08-24T14:15:22Z", "mayHavePublished": true } ], "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z" }}{ "success": false, "error": { "code": "PROFILE_NOT_FOUND", "message": "string", "details": {} }}{ "success": false, "error": { "code": "PROFILE_NOT_FOUND", "message": "string", "details": {} }}{ "success": false, "error": { "code": "PROFILE_NOT_FOUND", "message": "string", "details": {} }}Publishes a draft, scheduled, or failed post immediately. For scheduled posts, clears the schedule and publishes now. Optional profileIds limits which targets are published in this attempt.
Authorization
ApiKeyAuth AuthorizationBearer <token>
API key from your Aether dashboard
In: header
Path Parameters
postId*string
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/posts/string/publish" \ -H "Content-Type: application/json" \ -d '{}'{ "success": true, "data": { "id": "post_abc123", "organizationId": "string", "status": "draft", "text": "string", "mediaUrls": [ "http://example.com" ], "mediaKeys": [ "string" ], "profileIds": [ "string" ], "overrides": { "property1": { "text": "string", "mediaUrls": [ "http://example.com" ], "firstComment": "string", "contentType": "feed", "userTags": [ { "username": "string", "x": 0, "y": 0, "mediaIndex": 0 } ], "collaborators": [ "string" ], "thumbOffset": 0, "instagramThumbnail": "http://example.com", "shareToFeed": true, "threadItems": [ { "text": "string", "mediaUrls": [ "http://example.com" ] } ], "topicTag": "string", "carouselCards": [ { "link": "http://example.com", "name": "string", "description": "string" }, { "link": "http://example.com", "name": "string", "description": "string" } ], "carouselLink": "http://example.com", "pageId": "string", "organizationUrn": "string", "documentTitle": "string", "disableLinkPreview": true }, "property2": { "text": "string", "mediaUrls": [ "http://example.com" ], "firstComment": "string", "contentType": "feed", "userTags": [ { "username": "string", "x": 0, "y": 0, "mediaIndex": 0 } ], "collaborators": [ "string" ], "thumbOffset": 0, "instagramThumbnail": "http://example.com", "shareToFeed": true, "threadItems": [ { "text": "string", "mediaUrls": [ "http://example.com" ] } ], "topicTag": "string", "carouselCards": [ { "link": "http://example.com", "name": "string", "description": "string" }, { "link": "http://example.com", "name": "string", "description": "string" } ], "carouselLink": "http://example.com", "pageId": "string", "organizationUrn": "string", "documentTitle": "string", "disableLinkPreview": true } }, "scheduledFor": "2019-08-24T14:15:22Z", "queueId": "string", "scheduledViaQueue": false, "timezone": "string", "firstComment": "string", "publishedAt": "2019-08-24T14:15:22Z", "failedAt": "2019-08-24T14:15:22Z", "failureCode": "ALL_TARGETS_FAILED", "failureMessage": "string", "publishResults": [ { "profileId": "string", "platform": "instagram", "status": "pending", "platformPostId": "string", "error": "string", "publishedAt": "2019-08-24T14:15:22Z", "mayHavePublished": true } ], "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z" }}{ "success": false, "error": { "code": "PROFILE_NOT_FOUND", "message": "string", "details": {} }}{ "success": false, "error": { "code": "PROFILE_NOT_FOUND", "message": "string", "details": {} }}{ "success": false, "error": { "code": "PROFILE_NOT_FOUND", "message": "string", "details": {} }}{ "success": false, "error": { "code": "PROFILE_NOT_FOUND", "message": "string", "details": {} }}Retries publishing for a fully failed post (all targets) or only the failed profiles on a post with PARTIAL_FAILURE. Optional body applies content updates before retry.
Authorization
ApiKeyAuth AuthorizationBearer <token>
API key from your Aether dashboard
In: header
Path Parameters
postId*string
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Optional content updates applied atomically before retrying failed targets.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/posts/string/retry" \ -H "Content-Type: application/json" \ -d '{}'{ "success": true, "data": { "id": "post_abc123", "organizationId": "string", "status": "draft", "text": "string", "mediaUrls": [ "http://example.com" ], "mediaKeys": [ "string" ], "profileIds": [ "string" ], "overrides": { "property1": { "text": "string", "mediaUrls": [ "http://example.com" ], "firstComment": "string", "contentType": "feed", "userTags": [ { "username": "string", "x": 0, "y": 0, "mediaIndex": 0 } ], "collaborators": [ "string" ], "thumbOffset": 0, "instagramThumbnail": "http://example.com", "shareToFeed": true, "threadItems": [ { "text": "string", "mediaUrls": [ "http://example.com" ] } ], "topicTag": "string", "carouselCards": [ { "link": "http://example.com", "name": "string", "description": "string" }, { "link": "http://example.com", "name": "string", "description": "string" } ], "carouselLink": "http://example.com", "pageId": "string", "organizationUrn": "string", "documentTitle": "string", "disableLinkPreview": true }, "property2": { "text": "string", "mediaUrls": [ "http://example.com" ], "firstComment": "string", "contentType": "feed", "userTags": [ { "username": "string", "x": 0, "y": 0, "mediaIndex": 0 } ], "collaborators": [ "string" ], "thumbOffset": 0, "instagramThumbnail": "http://example.com", "shareToFeed": true, "threadItems": [ { "text": "string", "mediaUrls": [ "http://example.com" ] } ], "topicTag": "string", "carouselCards": [ { "link": "http://example.com", "name": "string", "description": "string" }, { "link": "http://example.com", "name": "string", "description": "string" } ], "carouselLink": "http://example.com", "pageId": "string", "organizationUrn": "string", "documentTitle": "string", "disableLinkPreview": true } }, "scheduledFor": "2019-08-24T14:15:22Z", "queueId": "string", "scheduledViaQueue": false, "timezone": "string", "firstComment": "string", "publishedAt": "2019-08-24T14:15:22Z", "failedAt": "2019-08-24T14:15:22Z", "failureCode": "ALL_TARGETS_FAILED", "failureMessage": "string", "publishResults": [ { "profileId": "string", "platform": "instagram", "status": "pending", "platformPostId": "string", "error": "string", "publishedAt": "2019-08-24T14:15:22Z", "mayHavePublished": true } ], "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z" }}{ "success": false, "error": { "code": "PROFILE_NOT_FOUND", "message": "string", "details": {} }}{ "success": false, "error": { "code": "PROFILE_NOT_FOUND", "message": "string", "details": {} }}{ "success": false, "error": { "code": "PROFILE_NOT_FOUND", "message": "string", "details": {} }}{ "success": false, "error": { "code": "PROFILE_NOT_FOUND", "message": "string", "details": {} }}Checks recent Facebook page posts for failed targets that may have published despite a Meta API error. Updates publishResults when a matching post is found.
Authorization
ApiKeyAuth AuthorizationBearer <token>
API key from your Aether dashboard
In: header
Path Parameters
postId*string
Response Body
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/posts/string/reconcile"{ "success": true, "data": { "post": { "id": "post_abc123", "organizationId": "string", "status": "draft", "text": "string", "mediaUrls": [ "http://example.com" ], "mediaKeys": [ "string" ], "profileIds": [ "string" ], "overrides": { "property1": { "text": "string", "mediaUrls": [ "http://example.com" ], "firstComment": "string", "contentType": "feed", "userTags": [ { "username": "string", "x": 0, "y": 0, "mediaIndex": 0 } ], "collaborators": [ "string" ], "thumbOffset": 0, "instagramThumbnail": "http://example.com", "shareToFeed": true, "threadItems": [ { "text": "string", "mediaUrls": [ "http://example.com" ] } ], "topicTag": "string", "carouselCards": [ { "link": "http://example.com", "name": "string", "description": "string" }, { "link": "http://example.com", "name": "string", "description": "string" } ], "carouselLink": "http://example.com", "pageId": "string", "organizationUrn": "string", "documentTitle": "string", "disableLinkPreview": true }, "property2": { "text": "string", "mediaUrls": [ "http://example.com" ], "firstComment": "string", "contentType": "feed", "userTags": [ { "username": "string", "x": 0, "y": 0, "mediaIndex": 0 } ], "collaborators": [ "string" ], "thumbOffset": 0, "instagramThumbnail": "http://example.com", "shareToFeed": true, "threadItems": [ { "text": "string", "mediaUrls": [ "http://example.com" ] } ], "topicTag": "string", "carouselCards": [ { "link": "http://example.com", "name": "string", "description": "string" }, { "link": "http://example.com", "name": "string", "description": "string" } ], "carouselLink": "http://example.com", "pageId": "string", "organizationUrn": "string", "documentTitle": "string", "disableLinkPreview": true } }, "scheduledFor": "2019-08-24T14:15:22Z", "queueId": "string", "scheduledViaQueue": false, "timezone": "string", "firstComment": "string", "publishedAt": "2019-08-24T14:15:22Z", "failedAt": "2019-08-24T14:15:22Z", "failureCode": "ALL_TARGETS_FAILED", "failureMessage": "string", "publishResults": [ { "profileId": "string", "platform": "instagram", "status": "pending", "platformPostId": "string", "error": "string", "publishedAt": "2019-08-24T14:15:22Z", "mayHavePublished": true } ], "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z" }, "reconciledProfileIds": [ "string" ] }}{ "success": false, "error": { "code": "PROFILE_NOT_FOUND", "message": "string", "details": {} }}{ "success": false, "error": { "code": "PROFILE_NOT_FOUND", "message": "string", "details": {} }}{ "success": false, "error": { "code": "PROFILE_NOT_FOUND", "message": "string", "details": {} }}Manually mark a failed profile target as published when the post is already live on the platform (e.g. after a Meta false-negative error).
Authorization
ApiKeyAuth AuthorizationBearer <token>
API key from your Aether dashboard
In: header
Path Parameters
postId*string
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/posts/string/acknowledge-publish" \ -H "Content-Type: application/json" \ -d '{ "profileId": "string", "platformPostId": "string" }'{ "success": true, "data": { "id": "post_abc123", "organizationId": "string", "status": "draft", "text": "string", "mediaUrls": [ "http://example.com" ], "mediaKeys": [ "string" ], "profileIds": [ "string" ], "overrides": { "property1": { "text": "string", "mediaUrls": [ "http://example.com" ], "firstComment": "string", "contentType": "feed", "userTags": [ { "username": "string", "x": 0, "y": 0, "mediaIndex": 0 } ], "collaborators": [ "string" ], "thumbOffset": 0, "instagramThumbnail": "http://example.com", "shareToFeed": true, "threadItems": [ { "text": "string", "mediaUrls": [ "http://example.com" ] } ], "topicTag": "string", "carouselCards": [ { "link": "http://example.com", "name": "string", "description": "string" }, { "link": "http://example.com", "name": "string", "description": "string" } ], "carouselLink": "http://example.com", "pageId": "string", "organizationUrn": "string", "documentTitle": "string", "disableLinkPreview": true }, "property2": { "text": "string", "mediaUrls": [ "http://example.com" ], "firstComment": "string", "contentType": "feed", "userTags": [ { "username": "string", "x": 0, "y": 0, "mediaIndex": 0 } ], "collaborators": [ "string" ], "thumbOffset": 0, "instagramThumbnail": "http://example.com", "shareToFeed": true, "threadItems": [ { "text": "string", "mediaUrls": [ "http://example.com" ] } ], "topicTag": "string", "carouselCards": [ { "link": "http://example.com", "name": "string", "description": "string" }, { "link": "http://example.com", "name": "string", "description": "string" } ], "carouselLink": "http://example.com", "pageId": "string", "organizationUrn": "string", "documentTitle": "string", "disableLinkPreview": true } }, "scheduledFor": "2019-08-24T14:15:22Z", "queueId": "string", "scheduledViaQueue": false, "timezone": "string", "firstComment": "string", "publishedAt": "2019-08-24T14:15:22Z", "failedAt": "2019-08-24T14:15:22Z", "failureCode": "ALL_TARGETS_FAILED", "failureMessage": "string", "publishResults": [ { "profileId": "string", "platform": "instagram", "status": "pending", "platformPostId": "string", "error": "string", "publishedAt": "2019-08-24T14:15:22Z", "mayHavePublished": true } ], "createdAt": "2019-08-24T14:15:22Z", "updatedAt": "2019-08-24T14:15:22Z" }}{ "success": false, "error": { "code": "PROFILE_NOT_FOUND", "message": "string", "details": {} }}{ "success": false, "error": { "code": "PROFILE_NOT_FOUND", "message": "string", "details": {} }}{ "success": false, "error": { "code": "PROFILE_NOT_FOUND", "message": "string", "details": {} }}{ "success": false, "error": { "code": "PROFILE_NOT_FOUND", "message": "string", "details": {} }}