Making Your First Request

​

Prerequisites

1. API Key created in StackOne Dashboard and copied to a secure location
2. Basic Authentication Setup - Learn how to properly authenticate with StackOne API using your API key
3. Required provider integration enabled
4. Account linked successfully
5. (Optional) Use an SDK or Postman

​

Getting Account ID

1. List your linked accounts to find the account ID:

curl --request GET \
     --url https://api.stackone.com/accounts \
     --header 'accept: application/json' \
     --header 'authorization: Basic {base64_encoded_api_key}'

2. From the response, copy the id value for your desired provider account.

curl --request GET \
     --url 'https://api.stackone.com/accounts?providers={provider_name}' \
     --header 'accept: application/json' \
     --header 'authorization: Basic {base64_encoded_api_key}'

​

Making Your First Request

curl --request GET \
  --url 'https://api.stackone.com/unified/documents/drives' \
  --header 'accept: application/json' \
  --header 'authorization: Basic {base64_encoded_api_key}' \
  --header 'x-account-id: {account_id}'

import { StackOne } from "@stackone/stackone-client-ts";

const client = new StackOne({ apiKey: "YOUR_API_KEY" });

const response = await client.documents.listDrives({
  xAccountId: "your-account-id"
});

console.log(response.drives);

from stackone_client import StackOne

client = StackOne(api_key="YOUR_API_KEY")

response = client.documents.list_drives(
    x_account_id="your-account-id"
)

print(response.drives)

​

Example Response

{
  "data": [
    {
      "id": "drive_123",
      "remote_id": "abc123",
      "name": "My Drive",
      "description": "Personal storage",
      "url": "https://drive.google.com/drive/..."
    }
  ]
}

​

Next Steps

​

References

• Basic Authentication with API Keys
• List Accounts
• Libraries & SDKs
• Integrations List