Get Started with Provider Connectivity Assurance APIs

Prev Next
Configuring API Access for SaaS/Cloud Tenants

Self-hosted deployment is not supported for SaaS/Cloud tenants. For on-premise tenants, see Configuring OAuth 2.0 Clients for API Access.

Getting Started

Use Postman (or a similar tool) to work with the APIs. Postman is recommended because it:

  • Shares APIs across teams with workspaces.
  • Supports environment variables to switch quickly between tenants or Provider Connectivity Assurance analytics instances.
  • Supports OpenAPI, which simplifies importing specifications.

For a REST refresher, see the REST tutorial.
For more information and API examples, see Querying Session PM Data via API.

Step 1: Download Postman

Step 2: Import Provider Connectivity Assurance Analytics API Specifications

  1. Go to http://api.accedian.io and download the OpenAPI specification.
    image.png

  2. Start Postman and import the swagger.json file.

1194154457978f0c9458c3b65ba60608ePostmanImport.png

The collection includes API folders for v1, v2, and v3. Use the newest version unless a required endpoint is unavailable.

image.png

Step 3: Set Up Global and Environment Variables

Use global and environment variables to reuse the same requests across environments.

  1. Embed variables in URLs or payloads using double curly brackets: {{variable_name}}.
  2. Click the environment settings cog in the top-right corner.

1194359429a3c635b981f704fc45ecbb5PostmanGlobalVars.png

  1. On the Manage Environments page, select Globals.
  2. Add a global parameter named protocol and set it to https.

119436024dc41c11eb38845c309665c85PostmanGlobalProtocol.png

  1. Create a new environment and add a host variable set to your tenant URL.

1194360995100c49ecf8b59a0ff85405bPostmanGSNEVar.png

  1. Save and select your environment.

119436137027f479a3610322b371894bePostmanEnvSelection.png

  1. Click the Eye icon to view current variable values at any time.

119436401b105c75c43e431c26099f608PostmanEnvQuickLook.png

Step 4: Authenticate

Set up a session with Provider Connectivity Assurance by sending a login request. Tokens periodically expire; obtain a new token when needed.

  1. In the collection, search for the Login API.

image.png

  1. Edit the request URL to use {{protocol}} and {{host}}.

    Note: The request body requires {{username}} and {{password}}.

  2. (Optional) Add username and password to your environment variables, or enter them directly in the request. If credentials do not vary across environments, variables are not required.

119440062c0eba46425376444c5de7ad6Postmanlogin2.png

  1. Click Send.
  2. Verify the response includes:
    • HTTP status code 200 OK.
    • A payload with account details.
    • Authorization and cookie headers.

119440052271502f86743035f4cda082bPostmanlogin3.png


Examples

Reset a User Password (Admin Only)

Admins can retrieve user IDs and issue a password reset to generate a new onboarding URL.

  1. Use Retrieve a list of users known to Skylight AAA.

    image.png

  2. Find the user and note the user ID.

  3. Use Reset a password for a user provisioned in Skylight AAA, and set {{userid}} in the URL or as a parameter.

    image.png

    119443325056ba7b48de73f1b5333fd85PostmanpasswordReset2.png

  4. Send the request. Copy the onboarding token from the response payload and share it with the user.

Onboarding URL format:

  • https://{{host}}/onboarding?token={{onboarding_token}}

© 2025 Cisco and/or its affiliates. All rights reserved.

For more information about trademarks, please visit: Cisco trademarks
For more information about legal terms, please visit: Cisco legal terms

For legal information about Accedian Skylight products, please visit: Accedian legal terms and trademarks