API Reference
  1. Business data
  2. Establishment

Refresh phone metadata

post
https://sandbox-api.coris.ai/api/v0_2/establishment//phones/metadata/

Starts a job to refresh metadata for an establishment's phone numbers.

Lifecycle: POST returns 201 and a request_id. Poll Get phone metadata status: 425 means not ready. If you send callback_url, Coris posts the result when it is done, as Handle async requests explains.

sequenceDiagram
  accTitle: Refresh phone metadata sequence diagram
  accDescr: Refresh phone metadata. You send POST .../phones/metadata/. Coris replies 201 request_id. You send GET ?request_id=... Coris replies 425 not ready. You send GET ?request_id=... Coris replies 500 refresh finished. Coris sends POST callback_url, if sent.
  participant You
  participant Coris
  You->>Coris: POST .../phones/metadata/
  Coris-->>You: 201 request_id
  You->>Coris: GET ?request_id=...
  Coris-->>You: 425 not ready
  You->>Coris: GET ?request_id=...
  Coris-->>You: 500 refresh finished
  Coris->>You: POST callback_url, if sent
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
uuid
required

The Coris ID of the establishment, from establishment.id in a search or profile.

Body Params
uri

A public HTTPS URL where Coris posts the result, if you want to skip polling.

integer

The minimum delay before the callback, in seconds, up to a recommended 3600. Send it if you might receive the callback before you store request_id.

Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses
201

The refresh started.

Callback

Updated about 23 hours ago

Did this page help you?
Language
Credentials
Header
URL
LoadingLoading…
Click Try It! to start a request and see the response here! Or choose an example:
text/html
application/json

Updated about 23 hours ago

Did this page help you?