Make your first API request - Clumio

This quickstart sends a read-only request to list users. It shows the minimum request shape before you move to task-specific API guides.

Prototype note. This request is an illustrative example and has not been validated against a live tenant. Confirm the endpoint version and response shape in the canonical endpoint reference before shipping an integration.

1. Set credentials

Create a token in Access management, then export it locally:

export CLUMIO_API_TOKEN="<your_api_token>"
export CLUMIO_API_BASE_URL="https://us-west-2.api.clumio.com"

Use the base URL for the control plane that issued the token. See regional API base URLs.

2. Send the request

curl "${CLUMIO_API_BASE_URL}/users?limit=10&start=1" \
  -H "Accept: application/api.clumio.users=v2+json" \
  -H "Authorization: Bearer ${CLUMIO_API_TOKEN}"

The response is a paginated HAL document. Inspect _embedded.items for users and _links.next for the next page.

3. Choose the next guide