{"name":"social","stage":"ga","description":"Package social is posting to every social account you own, now or on a schedule.","operations":[{"operationId":"get_social_accounts","method":"GET","href":"/v1/social/accounts","summary":"Returns the org's connected accounts — each one's id, network, handle, status and timestamps, most-recently-updated first."},{"operationId":"post_social_accounts","method":"POST","href":"/v1/social/accounts","summary":"Records a social account for the org and answers 201 with the stored row, including the generated id later calls address it by."},{"operationId":"delete_social_accounts_by_id","method":"DELETE","href":"/v1/social/accounts/{id}","summary":"Removes one connected account from the org and answers 204 with no body; an id that is not there is 404."},{"operationId":"get_social_accounts_by_id","method":"GET","href":"/v1/social/accounts/{id}","summary":"Returns one of the org's connected accounts by id — its network, handle, status and timestamps — or 404."},{"operationId":"put_social_accounts_by_id","method":"PUT","href":"/v1/social/accounts/{id}","summary":"Replaces the account's network, handle and status with what the body carries, and answers with the stored row."},{"operationId":"get_social_credentials","method":"GET","href":"/v1/social/credentials","summary":"Lists the apps this org has sealed."},{"operationId":"put_social_credentials","method":"PUT","href":"/v1/social/credentials","summary":"Seals the apps in the body."},{"operationId":"get_social_posts","method":"GET","href":"/v1/social/posts","summary":"Returns the org's posts — content, channel, status, scheduled time, media and timestamps — most-recently-updated first."},{"operationId":"post_social_posts","method":"POST","href":"/v1/social/posts","summary":"Stores a post for the org and answers 201 with the stored row."},{"operationId":"delete_social_posts_by_id","method":"DELETE","href":"/v1/social/posts/{id}","summary":"Removes one post from the org and answers 204 with no body; an id that is not there is 404."},{"operationId":"get_social_posts_by_id","method":"GET","href":"/v1/social/posts/{id}","summary":"Returns one of the org's posts by id, with its current status, scheduled time, media and — once it has published — the account and external id it published under."},{"operationId":"put_social_posts_by_id","method":"PUT","href":"/v1/social/posts/{id}","summary":"Replaces the post's content, channel, status, scheduled time and media with what the body carries, and answers with the stored row."},{"operationId":"post_social_posts_by_id_publish","method":"POST","href":"/v1/social/posts/{id}/publish","summary":"Publishes the post immediately to the connected accounts on its channel and answers with the updated row, carrying the account and external id it published under."},{"operationId":"get_social_providers","method":"GET","href":"/v1/social/providers","summary":"Reports each supported network's publish-readiness: whether this deployment holds the OAuth application credentials for it and, when it does not, exactly which environment variables are missing."},{"operationId":"get_social_summary","method":"GET","href":"/v1/social/summary","summary":"Returns four counts for the caller's org: total posts, how many are scheduled, how many have published, and how many accounts are connected."}],"_links":{"describedby":{"href":"/v1/openapi.json?capability=social"},"self":{"href":"/v1/social"},"up":{"href":"/v1"}}}