List websites

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Request parameters

ParameterTypeRequiredInDescription
AuthorizationstringYesHeaderPartner app token, sent raw. Bearer <token> is also accepted.
appIdstring (uuid)YesPathPartner Portal app id. Stands in for Meta's entity_id.

Example request

curl --location --request GET 'https://partner.gupshup.io/partner/app/<appId>/bizai/agent_config/websites' \
  --header 'Authorization: <PARTNER_APP_TOKEN>'

Response parameters — 200

The body is a JSON array; each element has the fields below.

ParameterTypeDescription
[].urlstringSite root to crawl. A URL without a scheme is normalised to https://.
[].included_sub_domainsarray of stringSub-domains to crawl in addition to the root.
[].included_url_patternsarray of stringOnly crawl paths matching these patterns.
[].excluded_sub_domainsarray of stringSub-domains to skip.
[].excluded_url_patternsarray of stringPaths to skip.
[].single_urlsarray of stringIndividual pages to add without crawling.
[].idstringResource id. Meta pfbid… id.
[].crawl_statusstringOne of: not_started, pending, in_progress, completed, completed_no_data, failed.
[].crawl_errorstringWhy the crawl failed, when crawl_status is failed.
[].pages_crawledintegerNumber of pages crawled so far.
[].last_crawled_atintegerLast crawl time, Unix seconds.
[].created_atintegerCreation time, Unix seconds.

Example response — 200 OK

[
  {
    "id": "pfbid0WebsiteExampleId",
    "url": "https://example.com",
    "included_sub_domains": ["support.example.com"],
    "included_url_patterns": ["/help/", "/faq/"],
    "excluded_sub_domains": ["staging.example.com"],
    "excluded_url_patterns": ["/admin/", "/private/"],
    "single_urls": ["https://example.com/pricing"],
    "crawl_status": "not_started",
    "pages_crawled": 1,
    "last_crawled_at": 1789630852,
    "created_at": 1789630852
  }
]

Error responses

400 Bad Request — The app is not live, or WASS does not consider it live.

{
  "message": "App is not live.",
  "status": "error"
}

400 Bad Request — The app has no phone number attached. Checked before the live check.

{
  "message": "Phone id not found for the given App",
  "status": "error"
}

401 Unauthorized — Authorization is missing or invalid, belongs to another app, or appId is unknown or not a UUID.

{
  "status": "error",
  "message": "Unauthorised access to the resource. Please review request parameters and headers and retry"
}

405 Method Not Allowed — Any method other than GET, POST, PUT or DELETE, e.g. PATCH.

{
  "status": "error",
  "message": "Request method 'PATCH' is not supported"
}

429 Too Many Requests — More than 30 /bizai/** requests in 60 seconds for this app. The 31st is rejected.

{
  "status": "error",
  "message": "Too Many Requests"
}
Path Params
uuid
required

Partner Portal app id. Stands in for Meta's entity_id.

Responses

429

Per-app rate limit exceeded. Retry after the 60-second window.

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json