{"components":{"schemas":{"Result":{"additionalProperties":true,"properties":{"next_actions":{"items":{"type":"string"},"type":"array"},"status":{"type":"string"},"subject_id":{"format":"uuid","type":"string"},"summary":{"type":"string"},"warnings":{"items":{"type":"string"},"type":"array"}},"type":"object"}},"securitySchemes":{"bearerAuth":{"description":"A revocable PostMySocials workspace credential issued either to Agent Access or a registered integration client","scheme":"bearer","type":"http"}}},"info":{"description":"Create media-backed social drafts and schedule them through PostMySocials's tenant, policy, approval, and audit boundaries. Mutation requests may include an Idempotency-Key header so unattended agents can retry safely.","title":"PostMySocials Agent API","version":"1.0.0"},"openapi":"3.1.0","paths":{"/social-accounts":{"get":{"description":"Required credential scopes: accounts:read.","operationId":"listSocialAccounts","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"List connected social accounts","tags":["Accounts"]}},"/posting-queues":{"get":{"description":"Required credential scopes: schedules:read.","operationId":"listPostingQueues","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"List saved recurring posting queues","tags":["Posting queues"]},"post":{"description":"Required credential scopes: schedules:write.","operationId":"createPostingQueue","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}},{"description":"Unique key for safely retrying this mutation with the same body","in":"header","name":"Idempotency-Key","required":false,"schema":{"maxLength":200,"minLength":1,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"active":{"default":true,"type":"boolean"},"excluded_dates":{"items":{"format":"date","type":"string"},"type":"array"},"name":{"maxLength":80,"minLength":1,"type":"string"},"slots":{"items":{"additionalProperties":false,"properties":{"local_time":{"description":"Local wall-clock time such as 18:00","type":"string"},"provider":{"type":"string"},"social_account_id":{"format":"uuid","type":"string"},"weekday":{"description":"ISO weekday where Monday=1 and Sunday=7","maximum":7,"minimum":1,"type":"integer"}},"required":["provider","weekday","local_time"],"type":"object"},"maxItems":100,"minItems":1,"type":"array"},"timezone":{"description":"IANA timezone","type":"string"}},"required":["name","timezone","slots"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"Create a recurring posting queue","tags":["Posting queues"]}},"/approvals/{id}/request-changes":{"post":{"description":"Required credential scopes: approvals:comment.","operationId":"requestApprovalChanges","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}},{"description":"Unique key for safely retrying this mutation with the same body","in":"header","name":"Idempotency-Key","required":false,"schema":{"maxLength":200,"minLength":1,"type":"string"}},{"description":"Approval UUID","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"reason":{"maxLength":4000,"minLength":1,"type":"string"}},"required":["reason"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"Request content changes while keeping publishing blocked","tags":["Approvals"]}},"/distributions/{id}":{"get":{"description":"Required credential scopes: schedules:read.","operationId":"getDistribution","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}},{"description":"Distribution UUID","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"Get all deliveries in a distribution","tags":["Distributions"]}},"/publishing/issues":{"get":{"description":"Required credential scopes: schedules:read.","operationId":"listPublishingIssues","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"List failed and uncertain deliveries","tags":["Publishing"]}},"/content":{"get":{"description":"Required credential scopes: content:read.","operationId":"listContent","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"List draft content","tags":["Content"]}},"/distributions":{"post":{"description":"Required credential scopes: schedules:write.","operationId":"createDistribution","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}},{"description":"Unique key for safely retrying this mutation with the same body","in":"header","name":"Idempotency-Key","required":false,"schema":{"maxLength":200,"minLength":1,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"destinations":{"items":{"additionalProperties":false,"properties":{"post_variant_id":{"description":"Optional provider variant UUID. The saved variant for this post/provider is selected automatically when omitted.","format":"uuid","type":"string"},"provider":{"type":"string"},"provider_settings":{"additionalProperties":true,"type":"object"},"scheduled_at":{"description":"Optional destination-specific datetime override","type":"string"},"social_account_id":{"format":"uuid","type":"string"},"timezone":{"description":"Optional destination-specific IANA timezone override","type":"string"}},"required":["provider"],"type":"object"},"maxItems":25,"minItems":1,"type":"array"},"post_id":{"format":"uuid","type":"string"},"scheduled_at":{"description":"Default RFC3339 or local ISO8601 datetime for all destinations","type":"string"},"timezone":{"description":"Default IANA timezone","type":"string"}},"required":["post_id","scheduled_at","destinations"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"Schedule one draft to multiple destinations","tags":["Distributions"]}},"/brand-rules/validate":{"post":{"description":"Required credential scopes: policy:read.","operationId":"validateBrandRules","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"alt_text":{"type":"string"},"campaign_key":{"description":"Optional Post campaign classification used for scoped brand rules","maxLength":120,"type":"string"},"content_category":{"description":"Optional Post content category used for scoped brand rules","maxLength":80,"type":"string"},"link_urls":{"items":{"format":"uri","type":"string"},"type":"array"},"media_types":{"items":{"enum":["image","video","document","subtitle"],"type":"string"},"type":"array"},"provider":{"type":"string"},"social_account_id":{"format":"uuid","type":"string"},"text":{"type":"string"}},"required":["provider"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"Validate proposed content against structured brand rules","tags":["Brand"]}},"/drafts/{id}/media":{"post":{"description":"Required credential scopes: media:write, drafts:write.","operationId":"attachMediaToDraft","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}},{"description":"Unique key for safely retrying this mutation with the same body","in":"header","name":"Idempotency-Key","required":false,"schema":{"maxLength":200,"minLength":1,"type":"string"}},{"description":"Draft UUID","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"media_id":{"format":"uuid","type":"string"},"position":{"default":0,"minimum":0,"type":"integer"}},"required":["media_id"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"Attach ready media to a draft","tags":["Media"]}},"/reliability":{"get":{"description":"Required credential scopes: reliability:read.","operationId":"getReliabilityHealth","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"Get the safe workspace publishing-health summary and concrete next actions","tags":["Workspace"]}},"/approvals/{id}/approve":{"post":{"description":"Required credential scopes: approvals:decide.","operationId":"approveSchedule","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}},{"description":"Unique key for safely retrying this mutation with the same body","in":"header","name":"Idempotency-Key","required":false,"schema":{"maxLength":200,"minLength":1,"type":"string"}},{"description":"Approval UUID","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"reason":{"type":"string"}},"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"Approve a pending schedule","tags":["Schedules"]}},"/distributions/validate-now":{"post":{"description":"Required credential scopes: schedules:write.","operationId":"validateDistributionNow","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"destinations":{"items":{"additionalProperties":false,"properties":{"post_variant_id":{"description":"Optional provider variant UUID. The saved variant for this post/provider is selected automatically when omitted.","format":"uuid","type":"string"},"provider":{"type":"string"},"provider_settings":{"additionalProperties":true,"type":"object"},"social_account_id":{"format":"uuid","type":"string"}},"required":["provider"],"type":"object"},"maxItems":25,"minItems":1,"type":"array"},"post_id":{"format":"uuid","type":"string"}},"required":["post_id","destinations"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"Preflight an immediate multi-target publish without creating deliveries","tags":["Distributions"]}},"/publishing/{id}/retry":{"post":{"description":"Required credential scopes: publishing:retry.","operationId":"retryPublishing","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}},{"description":"Unique key for safely retrying this mutation with the same body","in":"header","name":"Idempotency-Key","required":false,"schema":{"maxLength":200,"minLength":1,"type":"string"}},{"description":"Delivery UUID","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"Retry a delivery known to be safe to retry","tags":["Publishing"]}},"/provenance/posts/{id}":{"get":{"description":"Required credential scopes: audit:read, content:read.","operationId":"getPostProvenance","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}},{"description":"Post UUID","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"Get content provenance and asset lineage","tags":["Provenance"]}},"/publishing/{id}":{"get":{"description":"Required credential scopes: schedules:read.","operationId":"getPublishingResult","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}},{"description":"Delivery UUID","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"Get one delivery and its latest publishing attempt, including remote result identifiers","tags":["Publishing"]}},"/performance/trends":{"get":{"description":"Required credential scopes: performance:read.","operationId":"getPerformanceTrends","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}},{"description":"engagements, impressions, views, comments, shares, likes, reactions, saves, outbound_clicks, or watch_minutes","in":"query","name":"metric","required":false,"schema":{"type":"string"}},{"description":"provider or account","in":"query","name":"group_by","required":false,"schema":{"type":"string"}},{"description":"Optional provider filter","in":"query","name":"provider","required":false,"schema":{"type":"string"}},{"description":"Optional connected account UUID filter","in":"query","name":"social_account_id","required":false,"schema":{"type":"string"}},{"description":"Optional captured-on start date YYYY-MM-DD","in":"query","name":"from","required":false,"schema":{"type":"string"}},{"description":"Optional captured-on end date YYYY-MM-DD","in":"query","name":"to","required":false,"schema":{"type":"string"}},{"description":"Exact analytics-label matches. Use deep-object query syntax such as labels[campaign]=pf2f&labels[hook]=invite; all supplied labels must match.","explode":true,"in":"query","name":"labels","required":false,"schema":{"additionalProperties":{"maxLength":256,"type":"string"},"maxProperties":10,"type":"object"},"style":"deepObject"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"Read historical observed performance totals grouped by provider or account","tags":["Performance"]}},"/distributions/publish-now":{"post":{"description":"Required credential scopes: schedules:write.","operationId":"publishDistributionNow","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}},{"description":"Unique key for safely retrying this mutation with the same body","in":"header","name":"Idempotency-Key","required":false,"schema":{"maxLength":200,"minLength":1,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"destinations":{"items":{"additionalProperties":false,"properties":{"post_variant_id":{"description":"Optional provider variant UUID. The saved variant for this post/provider is selected automatically when omitted.","format":"uuid","type":"string"},"provider":{"type":"string"},"provider_settings":{"additionalProperties":true,"type":"object"},"social_account_id":{"format":"uuid","type":"string"}},"required":["provider"],"type":"object"},"maxItems":25,"minItems":1,"type":"array"},"post_id":{"format":"uuid","type":"string"}},"required":["post_id","destinations"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"Publish one draft to multiple destinations immediately","tags":["Distributions"]}},"/bulk/{id}":{"get":{"description":"Required credential scopes: media:read.","operationId":"getBulkBatch","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}},{"description":"Bulk batch UUID","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"Get one durable bulk batch including item recovery state","tags":["Bulk planning"]}},"/bulk/{id}/resume":{"post":{"description":"Required credential scopes: media:read, drafts:write.","operationId":"resumeBulkBatch","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}},{"description":"Unique key for safely retrying this mutation with the same body","in":"header","name":"Idempotency-Key","required":false,"schema":{"maxLength":200,"minLength":1,"type":"string"}},{"description":"Bulk batch UUID","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"Resume only pending or prepared items in an interrupted batch","tags":["Bulk planning"]}},"/approvals":{"get":{"description":"Required credential scopes: approvals:read.","operationId":"listApprovals","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"List open approvals and review comments","tags":["Approvals"]}},"/integrations/token":{"post":{"operationId":"exchangeIntegrationAuthorizationCode","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"client_credential":{"type":"string","writeOnly":true},"client_id":{"type":"string"},"code":{"type":"string","writeOnly":true},"grant_type":{"enum":["authorization_code"],"type":"string"},"redirect_uri":{"format":"uri","type":"string"}},"required":["client_id","client_credential","code","redirect_uri"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Workspace-scoped integration credential issued"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Invalid, expired, or consumed authorization code"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Registered integration client authentication failed"}},"security":[],"summary":"Exchange a single-use SMB OS authorization code for a workspace credential","tags":["Integrations"]}},"/schedules/validate":{"post":{"description":"Required credential scopes: schedules:write.","operationId":"validateSchedule","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"post_id":{"format":"uuid","type":"string"},"post_variant_id":{"format":"uuid","type":"string"},"provider":{"type":"string"},"provider_settings":{"additionalProperties":true,"type":"object"},"scheduled_at":{"description":"RFC3339 or local ISO8601 datetime","type":"string"},"social_account_id":{"format":"uuid","type":"string"},"timezone":{"description":"IANA timezone","type":"string"}},"required":["post_id","provider","scheduled_at"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"Validate a schedule without creating it","tags":["Schedules"]}},"/bulk/{id}/retry":{"post":{"description":"Required credential scopes: media:read, drafts:write.","operationId":"retryBulkBatch","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}},{"description":"Unique key for safely retrying this mutation with the same body","in":"header","name":"Idempotency-Key","required":false,"schema":{"maxLength":200,"minLength":1,"type":"string"}},{"description":"Bulk batch UUID","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"Retry only failed batch items while reusing existing prepared posts","tags":["Bulk planning"]}},"/drafts":{"post":{"description":"Required credential scopes: drafts:write.","operationId":"createDraft","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}},{"description":"Unique key for safely retrying this mutation with the same body","in":"header","name":"Idempotency-Key","required":false,"schema":{"maxLength":200,"minLength":1,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"body":{"type":"string"},"campaign_key":{"description":"Optional machine-readable campaign key.","maxLength":120,"type":"string"},"content_category":{"description":"Optional machine-readable content category.","maxLength":80,"type":"string"},"provenance":{"additionalProperties":false,"properties":{"derived_from_media_id":{"format":"uuid","type":"string"},"model":{"maxLength":500,"type":"string"},"model_provider":{"maxLength":500,"type":"string"},"source_external_id":{"maxLength":500,"type":"string"},"source_type":{"enum":["created","upload","imported","generated"],"type":"string"},"source_url":{"format":"uri","type":"string"},"tool_name":{"maxLength":500,"type":"string"},"tool_version":{"maxLength":500,"type":"string"}},"type":"object"},"related_resources":{"description":"Opaque cross-module references owned by the caller. PostMySocials stores and returns them without resolving another module's schema.","items":{"additionalProperties":false,"properties":{"module":{"maxLength":80,"minLength":1,"type":"string"},"relationship":{"maxLength":80,"type":"string"},"resource_ref":{"maxLength":500,"minLength":1,"type":"string"},"resource_type":{"maxLength":120,"minLength":1,"type":"string"}},"required":["module","resource_type","resource_ref"],"type":"object"},"maxItems":25,"type":"array"},"title":{"type":"string"}},"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"Create a draft","tags":["Content"]}},"/posting-queues/{id}/schedule-next":{"post":{"description":"Required credential scopes: schedules:write.","operationId":"scheduleNextPostingQueue","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}},{"description":"Unique key for safely retrying this mutation with the same body","in":"header","name":"Idempotency-Key","required":false,"schema":{"maxLength":200,"minLength":1,"type":"string"}},{"description":"Posting queue UUID","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"destinations":{"items":{"additionalProperties":false,"properties":{"post_variant_id":{"format":"uuid","type":"string"},"provider":{"type":"string"},"provider_settings":{"additionalProperties":true,"type":"object"},"social_account_id":{"format":"uuid","type":"string"}},"required":["provider"],"type":"object"},"maxItems":25,"minItems":1,"type":"array"},"from":{"description":"Optional RFC3339 instant to preview from; defaults to now","type":"string"},"post_id":{"format":"uuid","type":"string"}},"required":["post_id","destinations"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"Schedule a post into each destination's next available recurring slot","tags":["Posting queues"]}},"/schedules":{"get":{"description":"Required credential scopes: schedules:read.","operationId":"listSchedules","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"List scheduled deliveries","tags":["Schedules"]},"post":{"description":"Required credential scopes: schedules:write.","operationId":"createSchedule","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}},{"description":"Unique key for safely retrying this mutation with the same body","in":"header","name":"Idempotency-Key","required":false,"schema":{"maxLength":200,"minLength":1,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"post_id":{"format":"uuid","type":"string"},"post_variant_id":{"format":"uuid","type":"string"},"provider":{"type":"string"},"provider_settings":{"additionalProperties":true,"type":"object"},"scheduled_at":{"description":"RFC3339 or local ISO8601 datetime","type":"string"},"social_account_id":{"format":"uuid","type":"string"},"timezone":{"description":"IANA timezone","type":"string"}},"required":["post_id","provider","scheduled_at"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"Schedule a draft for one provider","tags":["Schedules"]}},"/posting-queues/{id}/preview":{"post":{"description":"Required credential scopes: schedules:read.","operationId":"previewPostingQueue","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}},{"description":"Posting queue UUID","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"destinations":{"items":{"additionalProperties":false,"properties":{"post_variant_id":{"format":"uuid","type":"string"},"provider":{"type":"string"},"provider_settings":{"additionalProperties":true,"type":"object"},"social_account_id":{"format":"uuid","type":"string"}},"required":["provider"],"type":"object"},"maxItems":25,"minItems":1,"type":"array"},"from":{"description":"Optional RFC3339 instant to preview from; defaults to now","type":"string"},"limit":{"maximum":20,"minimum":1,"type":"integer"}},"required":["destinations"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"Preview the next unoccupied recurring slots for selected destinations","tags":["Posting queues"]}},"/media":{"get":{"description":"Required credential scopes: media:read.","operationId":"listMedia","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"List workspace media","tags":["Media"]}},"/bulk/preflight":{"post":{"description":"Required credential scopes: media:read.","operationId":"preflightBulkPlan","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"destinations":{"items":{"additionalProperties":false,"properties":{"provider":{"type":"string"},"provider_settings":{"additionalProperties":true,"type":"object"},"social_account_id":{"format":"uuid","type":"string"}},"required":["provider"],"type":"object"},"maxItems":25,"minItems":1,"type":"array"},"items":{"items":{"additionalProperties":false,"properties":{"body":{"type":"string"},"media_id":{"format":"uuid","type":"string"},"title":{"type":"string"},"variants":{"items":{"additionalProperties":false,"properties":{"caption":{"type":"string"},"provider":{"type":"string"},"settings":{"additionalProperties":true,"type":"object"}},"required":["provider"],"type":"object"},"maxItems":25,"type":"array"}},"required":["media_id"],"type":"object"},"maxItems":25,"minItems":1,"type":"array"},"posting_queue_id":{"format":"uuid","type":"string"},"scheduled_at":{"description":"Exact-time scheduling alternative to posting_queue_id","type":"string"},"timezone":{"description":"IANA timezone for exact-time scheduling","type":"string"}},"required":["items"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"Preflight a batch of uploaded media before creating drafts or schedules","tags":["Bulk planning"]}},"/bulk":{"get":{"description":"Required credential scopes: media:read.","operationId":"listBulkBatches","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}},{"description":"Maximum batches to return","in":"query","name":"limit","required":false,"schema":{"maximum":100,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"List durable bulk-planning batches and recovery state","tags":["Bulk planning"]},"post":{"description":"Required credential scopes: media:read, drafts:write.","operationId":"createBulkPlan","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}},{"description":"Unique key for safely retrying this mutation with the same body","in":"header","name":"Idempotency-Key","required":false,"schema":{"maxLength":200,"minLength":1,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"destinations":{"items":{"additionalProperties":false,"properties":{"provider":{"type":"string"},"provider_settings":{"additionalProperties":true,"type":"object"},"social_account_id":{"format":"uuid","type":"string"}},"required":["provider"],"type":"object"},"maxItems":25,"minItems":1,"type":"array"},"items":{"items":{"additionalProperties":false,"properties":{"body":{"type":"string"},"media_id":{"format":"uuid","type":"string"},"title":{"type":"string"},"variants":{"items":{"additionalProperties":false,"properties":{"caption":{"type":"string"},"provider":{"type":"string"},"settings":{"additionalProperties":true,"type":"object"}},"required":["provider"],"type":"object"},"maxItems":25,"type":"array"}},"required":["media_id"],"type":"object"},"maxItems":25,"minItems":1,"type":"array"},"posting_queue_id":{"format":"uuid","type":"string"},"scheduled_at":{"description":"Exact-time scheduling alternative to posting_queue_id","type":"string"},"timezone":{"description":"IANA timezone for exact-time scheduling","type":"string"}},"required":["items"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"Create one durable batch, one draft per media item, and optionally schedule the batch","tags":["Bulk planning"]}},"/approvals/{id}/reject":{"post":{"description":"Required credential scopes: approvals:decide.","operationId":"rejectSchedule","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}},{"description":"Unique key for safely retrying this mutation with the same body","in":"header","name":"Idempotency-Key","required":false,"schema":{"maxLength":200,"minLength":1,"type":"string"}},{"description":"Approval UUID","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"reason":{"type":"string"}},"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"Reject a pending schedule","tags":["Schedules"]}},"/webhooks":{"get":{"description":"Required credential scopes: webhooks:read.","operationId":"listWebhookHealth","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"List outbound webhook subscriptions and recent delivery health","tags":["Webhooks"]}},"/content/{id}":{"get":{"description":"Required credential scopes: content:read.","operationId":"getContent","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}},{"description":"Draft UUID","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"Get one draft","tags":["Content"]}},"/posting-queues/{id}":{"delete":{"description":"Required credential scopes: schedules:write.","operationId":"deletePostingQueue","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}},{"description":"Unique key for safely retrying this mutation with the same body","in":"header","name":"Idempotency-Key","required":false,"schema":{"maxLength":200,"minLength":1,"type":"string"}},{"description":"Posting queue UUID","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"Delete a recurring posting queue without changing existing deliveries","tags":["Posting queues"]},"get":{"description":"Required credential scopes: schedules:read.","operationId":"getPostingQueue","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}},{"description":"Posting queue UUID","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"Get a recurring posting queue","tags":["Posting queues"]},"patch":{"description":"Required credential scopes: schedules:write.","operationId":"updatePostingQueue","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}},{"description":"Unique key for safely retrying this mutation with the same body","in":"header","name":"Idempotency-Key","required":false,"schema":{"maxLength":200,"minLength":1,"type":"string"}},{"description":"Posting queue UUID","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"active":{"default":true,"type":"boolean"},"excluded_dates":{"items":{"format":"date","type":"string"},"type":"array"},"name":{"maxLength":80,"minLength":1,"type":"string"},"slots":{"items":{"additionalProperties":false,"properties":{"local_time":{"description":"Local wall-clock time such as 18:00","type":"string"},"provider":{"type":"string"},"social_account_id":{"format":"uuid","type":"string"},"weekday":{"description":"ISO weekday where Monday=1 and Sunday=7","maximum":7,"minimum":1,"type":"integer"}},"required":["provider","weekday","local_time"],"type":"object"},"maxItems":100,"minItems":1,"type":"array"},"timezone":{"description":"IANA timezone","type":"string"}},"required":[],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"Update a recurring posting queue","tags":["Posting queues"]}},"/platforms/{provider}/capabilities":{"get":{"description":"Required credential scopes: accounts:read.","operationId":"getPlatformCapabilities","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}},{"description":"Social provider name","in":"path","name":"provider","required":true,"schema":{"type":"string"}},{"description":"Connected account UUID","in":"query","name":"social_account_id","required":false,"schema":{"type":"string"}},{"description":"image or video","in":"query","name":"media_type","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"Get current platform capabilities","tags":["Accounts"]}},"/publishing/{id}/resolve":{"post":{"description":"Required credential scopes: publishing:resolve.","operationId":"resolvePublishingOutcome","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}},{"description":"Unique key for safely retrying this mutation with the same body","in":"header","name":"Idempotency-Key","required":false,"schema":{"maxLength":200,"minLength":1,"type":"string"}},{"description":"Delivery UUID","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"note":{"type":"string"},"remote_id":{"type":"string"},"remote_url":{"format":"uri","type":"string"},"resolution":{"enum":["published","not_published"],"type":"string"}},"required":["resolution"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"Resolve an uncertain publishing outcome","tags":["Publishing"]}},"/bulk/{id}/cancel":{"post":{"description":"Required credential scopes: media:read, drafts:write.","operationId":"cancelBulkBatch","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}},{"description":"Unique key for safely retrying this mutation with the same body","in":"header","name":"Idempotency-Key","required":false,"schema":{"maxLength":200,"minLength":1,"type":"string"}},{"description":"Bulk batch UUID","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"Cancel remaining incomplete batch work without undoing successful items","tags":["Bulk planning"]}},"/drafts/{id}/variants/{provider}":{"put":{"description":"Required credential scopes: drafts:write.","operationId":"setDraftVariant","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}},{"description":"Unique key for safely retrying this mutation with the same body","in":"header","name":"Idempotency-Key","required":false,"schema":{"maxLength":200,"minLength":1,"type":"string"}},{"description":"Draft UUID","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Provider name","in":"path","name":"provider","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"caption":{"type":"string"},"provenance":{"additionalProperties":false,"properties":{"derived_from_media_id":{"format":"uuid","type":"string"},"model":{"maxLength":500,"type":"string"},"model_provider":{"maxLength":500,"type":"string"},"source_external_id":{"maxLength":500,"type":"string"},"source_type":{"enum":["created","upload","imported","generated"],"type":"string"},"source_url":{"format":"uri","type":"string"},"tool_name":{"maxLength":500,"type":"string"},"tool_version":{"maxLength":500,"type":"string"}},"type":"object"},"settings":{"additionalProperties":true,"type":"object"}},"required":["caption"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"Create or replace provider-specific copy","tags":["Content"]}},"/schedules/{id}":{"delete":{"description":"Required credential scopes: schedules:write.","operationId":"cancelDelivery","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}},{"description":"Unique key for safely retrying this mutation with the same body","in":"header","name":"Idempotency-Key","required":false,"schema":{"maxLength":200,"minLength":1,"type":"string"}},{"description":"Delivery UUID","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"Cancel a scheduled delivery","tags":["Schedules"]},"patch":{"description":"Required credential scopes: schedules:write.","operationId":"rescheduleDelivery","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}},{"description":"Unique key for safely retrying this mutation with the same body","in":"header","name":"Idempotency-Key","required":false,"schema":{"maxLength":200,"minLength":1,"type":"string"}},{"description":"Delivery UUID","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"scheduled_at":{"description":"RFC3339 or local ISO8601 datetime","type":"string"},"timezone":{"description":"IANA timezone","type":"string"}},"required":["scheduled_at"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"Move a scheduled delivery","tags":["Schedules"]}},"/approvals/{id}/comments":{"post":{"description":"Required credential scopes: approvals:comment.","operationId":"commentApproval","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}},{"description":"Unique key for safely retrying this mutation with the same body","in":"header","name":"Idempotency-Key","required":false,"schema":{"maxLength":200,"minLength":1,"type":"string"}},{"description":"Approval UUID","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"body":{"maxLength":4000,"minLength":1,"type":"string"}},"required":["body"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"Add a review comment without changing the decision","tags":["Approvals"]}},"/module-context":{"get":{"description":"No additional scope is required.","operationId":"getModuleContext","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"Get SMB OS orchestration readiness and native handoff context","tags":["Workspace"]}},"/distributions/validate":{"post":{"description":"Required credential scopes: schedules:write.","operationId":"validateDistribution","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"destinations":{"items":{"additionalProperties":false,"properties":{"post_variant_id":{"description":"Optional provider variant UUID. The saved variant for this post/provider is selected automatically when omitted.","format":"uuid","type":"string"},"provider":{"type":"string"},"provider_settings":{"additionalProperties":true,"type":"object"},"scheduled_at":{"description":"Optional destination-specific datetime override","type":"string"},"social_account_id":{"format":"uuid","type":"string"},"timezone":{"description":"Optional destination-specific IANA timezone override","type":"string"}},"required":["provider"],"type":"object"},"maxItems":25,"minItems":1,"type":"array"},"post_id":{"format":"uuid","type":"string"},"scheduled_at":{"description":"Default RFC3339 or local ISO8601 datetime for all destinations","type":"string"},"timezone":{"description":"Default IANA timezone","type":"string"}},"required":["post_id","scheduled_at","destinations"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"Preflight a multi-target distribution without creating deliveries","tags":["Distributions"]}},"/drafts/{id}":{"patch":{"description":"Required credential scopes: drafts:write.","operationId":"updateDraft","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}},{"description":"Unique key for safely retrying this mutation with the same body","in":"header","name":"Idempotency-Key","required":false,"schema":{"maxLength":200,"minLength":1,"type":"string"}},{"description":"Draft UUID","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"minProperties":1,"properties":{"body":{"type":"string"},"campaign_key":{"description":"Optional machine-readable campaign key.","maxLength":120,"type":"string"},"content_category":{"description":"Optional machine-readable content category.","maxLength":80,"type":"string"},"provenance":{"additionalProperties":false,"properties":{"derived_from_media_id":{"format":"uuid","type":"string"},"model":{"maxLength":500,"type":"string"},"model_provider":{"maxLength":500,"type":"string"},"source_external_id":{"maxLength":500,"type":"string"},"source_type":{"enum":["created","upload","imported","generated"],"type":"string"},"source_url":{"format":"uri","type":"string"},"tool_name":{"maxLength":500,"type":"string"},"tool_version":{"maxLength":500,"type":"string"}},"type":"object"},"related_resources":{"description":"Opaque cross-module references owned by the caller. PostMySocials stores and returns them without resolving another module's schema.","items":{"additionalProperties":false,"properties":{"module":{"maxLength":80,"minLength":1,"type":"string"},"relationship":{"maxLength":80,"type":"string"},"resource_ref":{"maxLength":500,"minLength":1,"type":"string"},"resource_type":{"maxLength":120,"minLength":1,"type":"string"}},"required":["module","resource_type","resource_ref"],"type":"object"},"maxItems":25,"type":"array"},"title":{"type":"string"}},"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"Update a draft","tags":["Content"]}},"/performance/posts/{id}":{"get":{"description":"Required credential scopes: performance:read.","operationId":"getPostPerformance","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}},{"description":"Post UUID","in":"path","name":"id","required":true,"schema":{"type":"string"}},{"description":"Optional provider filter","in":"query","name":"provider","required":false,"schema":{"type":"string"}},{"description":"Optional connected account UUID filter","in":"query","name":"social_account_id","required":false,"schema":{"type":"string"}},{"description":"Optional captured-on start date YYYY-MM-DD","in":"query","name":"from","required":false,"schema":{"type":"string"}},{"description":"Optional captured-on end date YYYY-MM-DD","in":"query","name":"to","required":false,"schema":{"type":"string"}},{"description":"Exact analytics-label matches. Use deep-object query syntax such as labels[campaign]=pf2f&labels[hook]=invite; all supplied labels must match.","explode":true,"in":"query","name":"labels","required":false,"schema":{"additionalProperties":{"maxLength":256,"type":"string"},"maxProperties":10,"type":"object"},"style":"deepObject"}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"Get normalized cross-network performance for one logical post","tags":["Performance"]}},"/context":{"get":{"description":"No additional scope is required.","operationId":"getWorkspaceContext","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"Get workspace context","tags":["Workspace"]}},"/performance/top":{"get":{"description":"Required credential scopes: performance:read.","operationId":"listTopPostPerformance","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}},{"description":"engagements, impressions, views, comments, shares, likes, reactions, saves, outbound_clicks, or watch_minutes","in":"query","name":"metric","required":false,"schema":{"type":"string"}},{"description":"Optional provider filter","in":"query","name":"provider","required":false,"schema":{"type":"string"}},{"description":"Optional connected account UUID filter","in":"query","name":"social_account_id","required":false,"schema":{"type":"string"}},{"description":"Optional captured-on start date YYYY-MM-DD","in":"query","name":"from","required":false,"schema":{"type":"string"}},{"description":"Optional captured-on end date YYYY-MM-DD","in":"query","name":"to","required":false,"schema":{"type":"string"}},{"description":"Exact analytics-label matches. Use deep-object query syntax such as labels[campaign]=pf2f&labels[hook]=invite; all supplied labels must match.","explode":true,"in":"query","name":"labels","required":false,"schema":{"additionalProperties":{"maxLength":256,"type":"string"},"maxProperties":10,"type":"object"},"style":"deepObject"},{"description":"Maximum logical posts to return","in":"query","name":"limit","required":false,"schema":{"maximum":100,"minimum":1,"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"Rank logical posts by normalized additive performance","tags":["Performance"]}},"/agent-policy/simulate":{"post":{"description":"Required credential scopes: policy:read.","operationId":"simulateAgentPolicy","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"ai_disclosure":{"description":"Whether the proposed content carries an AI-generated/modified disclosure","type":"boolean"},"campaign_key":{"description":"Optional Post campaign classification used by Agent Policy","maxLength":120,"type":"string"},"commercial_content":{"description":"Whether the proposed content is commercial/paid partnership content","type":"boolean"},"content_category":{"description":"Optional Post content category used by Agent Policy","maxLength":80,"type":"string"},"link_urls":{"items":{"format":"uri","type":"string"},"type":"array"},"media_types":{"items":{"enum":["image","video","document","subtitle"],"type":"string"},"type":"array"},"posting_queue_id":{"format":"uuid","type":"string"},"provider":{"type":"string"},"schedule_increment":{"minimum":1,"type":"integer"},"scheduled_at":{"description":"RFC3339 or local ISO8601 time to evaluate","type":"string"},"social_account_id":{"format":"uuid","type":"string"},"text":{"type":"string"},"timezone":{"description":"IANA timezone","type":"string"}},"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"Simulate the effective agent policy without creating anything","tags":["Policy"]}},"/media/{id}/ready":{"post":{"description":"Required credential scopes: media:write.","operationId":"markMediaReady","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}},{"description":"Unique key for safely retrying this mutation with the same body","in":"header","name":"Idempotency-Key","required":false,"schema":{"maxLength":200,"minLength":1,"type":"string"}},{"description":"Media UUID","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"Verify an uploaded object; large videos may continue verification in the background","tags":["Media"]}},"/integrations/revoke":{"post":{"operationId":"revokeIntegrationCredential","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"client_credential":{"type":"string","writeOnly":true},"client_id":{"type":"string"},"token":{"type":"string","writeOnly":true}},"required":["client_id","client_credential","token"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Integration credential revoked"},"400":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Invalid revocation request"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Registered integration client authentication failed"}},"security":[],"summary":"Revoke an SMB OS workspace integration credential","tags":["Integrations"]}},"/variants/{id}/media":{"post":{"description":"Required credential scopes: media:write, drafts:write.","operationId":"attachMediaToVariant","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}},{"description":"Unique key for safely retrying this mutation with the same body","in":"header","name":"Idempotency-Key","required":false,"schema":{"maxLength":200,"minLength":1,"type":"string"}},{"description":"Post variant UUID","in":"path","name":"id","required":true,"schema":{"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"media_id":{"format":"uuid","type":"string"},"position":{"default":0,"minimum":0,"type":"integer"},"role":{"default":"primary","enum":["primary","thumbnail","caption"],"type":"string"}},"required":["media_id"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"Attach ready media to a provider variant","tags":["Media"]}},"/media/uploads":{"post":{"description":"Required credential scopes: media:write.","operationId":"createMediaUpload","parameters":[{"description":"Optional workspace ID, slug, or exact name. User-bound credentials may target any workspace the authorizing user can access; effective scopes are limited by that user's role in the target workspace. Omit this header to use the credential's internal fallback workspace.","in":"header","name":"X-PostMySocials-Workspace","required":false,"schema":{"type":"string"}},{"description":"Optional caller correlation ID. PostMySocials validates and echoes it; otherwise a correlation ID is generated.","in":"header","name":"X-Correlation-Id","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS origin module. Accepted as audit/workflow metadata only for integration credentials.","in":"header","name":"X-SMB-OS-Origin-Module","required":false,"schema":{"type":"string"}},{"description":"Optional trusted SMB OS workflow ID. It never grants authorization.","in":"header","name":"X-SMB-OS-Workflow-Id","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor type: human, agent, or external. Valid only for integration credentials.","in":"header","name":"X-SMB-OS-Delegated-Actor-Type","required":false,"schema":{"type":"string"}},{"description":"Optional delegated actor ID paired with X-SMB-OS-Delegated-Actor-Type.","in":"header","name":"X-SMB-OS-Delegated-Actor-Id","required":false,"schema":{"type":"string"}},{"description":"Unique key for safely retrying this mutation with the same body","in":"header","name":"Idempotency-Key","required":false,"schema":{"maxLength":200,"minLength":1,"type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"byte_size":{"minimum":1,"type":"integer"},"checksum_sha256":{"pattern":"^[0-9a-fA-F]{64}$","type":"string"},"content_type":{"enum":["video/mp4","video/quicktime","video/webm","image/jpeg","image/png","image/webp","image/gif","application/pdf","text/vtt"],"type":"string"},"filename":{"type":"string"},"provenance":{"additionalProperties":false,"properties":{"derived_from_media_id":{"format":"uuid","type":"string"},"model":{"maxLength":500,"type":"string"},"model_provider":{"maxLength":500,"type":"string"},"source_external_id":{"maxLength":500,"type":"string"},"source_type":{"enum":["created","upload","imported","generated"],"type":"string"},"source_url":{"format":"uri","type":"string"},"tool_name":{"maxLength":500,"type":"string"},"tool_version":{"maxLength":500,"type":"string"}},"type":"object"}},"required":["filename","content_type","byte_size","checksum_sha256"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Operation result"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Resource created"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Missing or invalid credential"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Credential lacks the required scope"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Rejected request"},"429":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Result"}}},"description":"Mutation rate limit reached"}},"summary":"Create a direct media upload","tags":["Media"]}}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://postmysocials.com/api/v1"}],"tags":[{"description":"Workspace identity and agent context.","name":"Workspace"},{"description":"Registered module installation, token exchange, and revocation.","name":"Integrations"},{"description":"Agent policy simulation and effective guardrails.","name":"Policy"},{"description":"Structured workspace/provider/account brand-rule validation.","name":"Brand"},{"description":"Content origin, revision, approval, and asset lineage.","name":"Provenance"},{"description":"Connected social accounts and capabilities.","name":"Accounts"},{"description":"Logical posts and provider-specific variants.","name":"Content"},{"description":"Direct media upload and attachment workflows.","name":"Media"},{"description":"High-volume media-to-post planning.","name":"Bulk planning"},{"description":"One logical post scheduled to many destinations.","name":"Distributions"},{"description":"Recurring cadence queues and next-slot scheduling.","name":"Posting queues"},{"description":"Individual delivery scheduling and rescheduling.","name":"Schedules"},{"description":"Review, comments, requested changes and decisions.","name":"Approvals"},{"description":"Normalized cross-network performance analytics.","name":"Performance"},{"description":"Read-only outbound webhook health for agents.","name":"Webhooks"},{"description":"Publishing failure recovery and reconciliation.","name":"Publishing"}]}