GET
/
api
/
organizations
/
{organizationId}
/
portals
/
{portalId}
/
verify
Verify upload portal information
curl --request GET \
  --url https://studio.edgeimpulse.com/v1/api/organizations/{organizationId}/portals/{portalId}/verify \
  --header 'x-api-key: <api-key>'
{
  "success": true,
  "error": "<string>",
  "connectionStatus": "connected",
  "connectionError": "<string>",
  "connectionStatusSince": "2023-11-07T05:31:56Z",
  "files": [
    {
      "name": "<string>",
      "size": 123,
      "folderName": "<string>"
    }
  ],
  "hasInfoLabelsFile": true,
  "signedUrl": "<string>",
  "endpoint": "<string>"
}

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
organizationId
integer
required

Organization ID

​
portalId
integer
required

Portal ID

Response

200 - application/json

OK

Response object for verifying an organization's bucket connectivity.

Workflow:

  1. The client initiates verification by sending a GET request to /api/organizations/{organizationId}/buckets/verify with bucket and credential details.
  2. The server responds with this VerifyOrganizationBucketResponse object.
  3. The client checks the connectionStatus:
    • If "connected": Verification is complete. Other properties (files, hasInfoLabelsFile, signedUrl) are available.
    • If "connecting": Verification is in progress. The client should continue polling. Other properties are not yet available.
    • If "error": Verification failed. Check connectionError for details. Other properties are not available.
  4. If connectionStatus is "connecting", the client should periodically poll the endpoint until the status changes to "connected" or "error".