pier-cloud

# Pier Cloud API ## Prerequisites ### Credentials Locate the `.env` file in the skill directory with the following variables: ```env PIERCLOUD_CLIENT_ID=your_client_id PIERCLOUD_CLIENT_SECRET=your_client_secret PIERCLOUD_TENANCY_ID=your_tenancy_id ``` If the `.env` file does not exist, inform the user that credentials must be obtained from the Pier Cloud platform before proceeding. Do not proceed without the `.env` file. > Note: `PIERCLOUD_TENANCY_ID` is equivalent to the former `PIERCLOUD_BUSINESS_ID`. Scripts accept both as fallback. ### Python Dependencies ```bash pip install requests python-dotenv ``` ## Basic Configuration The API uses JWT authentication. Required flow: 1. Authenticate via `POST /auth` with `client_id` and `client_secret` to obtain a JWT token 2. Include the token in all requests: `Authorization: Bearer {token}` 3. Renew the token upon expiration (default validity: 1 hour) **Base URL**: `https://api.piercloud.io` Verify the connection by running: ```bash python scripts/pier-cloud-auth.py ``` ## Available Scripts Ready-to-use scripts in `scripts/`. See `scripts/README.md` for detailed instructions. | Script | Description | |--------|-------------| | `pier-cloud-auth.py` | Authenticate and obtain JWT token | | `pier-cloud-list-contexts.py` | List available contexts | | `pier-cloud-list-workspaces.py` | List workspaces with pagination | | `pier-cloud-get-workspace.py` | Get specific workspace details | | `pier-cloud-get-all-workspaces.py` |...