Use this when you hold an establishment.id: it starts a job to find and summarize the social media profiles of a business. Use it when you want a summary across platforms. For an account, use Request account social media.

Lifecycle: POST returns 201 and a request_id. Poll Get establishment social media with that request_id: 425 means not ready, 206 means partial data, and 200 means complete. If you send callback_url, Coris posts the result when it is done, as Handle async requests explains.

sequenceDiagram
  accTitle: Request establishment social media sequence diagram
  accDescr: Request establishment social media. You send POST .../social_media/. Coris replies 201 request_id. You send GET ?request_id=... Coris replies 425 not ready, or 206 partial data. You send GET ?request_id=... Coris replies 200 complete. Coris sends POST callback_url, if sent.
  participant You
  participant Coris
  You->>Coris: POST .../social_media/
  Coris-->>You: 201 request_id
  You->>Coris: GET ?request_id=...
  Coris-->>You: 425 not ready, or 206 partial data
  You->>Coris: GET ?request_id=...
  Coris-->>You: 200 complete
  Coris->>You: POST callback_url, if sent