List API Keys

GET /keys

curl -X GET "https://api.astracollab.app/v1/keys?page=1&limit=20" \
  -H "Authorization: Bearer your-api-key-here"

{
  "success": true,
  "data": {
    "keys": [
      {
        "id": "key_1234567890abcdef",
        "name": "Production App Key",
        "prefix": "ak_1234",
        "permissions": ["files:read", "files:write", "folders:read"],
        "createdAt": "2024-01-15T10:30:00Z",
        "expiresAt": "2024-12-31T23:59:59Z",
        "lastUsedAt": "2024-01-20T15:45:00Z",
        "isActive": true,
        "usageCount": 1250
      },
      {
        "id": "key_0987654321fedcba",
        "name": "Development Testing",
        "prefix": "ak_5678",
        "permissions": ["files:read", "files:write"],
        "createdAt": "2024-01-10T09:15:00Z",
        "expiresAt": null,
        "lastUsedAt": "2024-01-19T11:20:00Z",
        "isActive": true,
        "usageCount": 89
      }
    ],
    "pagination": {
      "page": 1,
      "limit": 20,
      "total": 5,
      "totalPages": 1,
      "hasNext": false,
      "hasPrev": false
    }
  }
}

# Active keys only
curl -X GET "https://api.astracollab.app/v1/keys?status=active"

# Expired keys
curl -X GET "https://api.astracollab.app/v1/keys?status=expired"

# Revoked keys
curl -X GET "https://api.astracollab.app/v1/keys?status=revoked"

curl -X GET "https://api.astracollab.app/v1/keys?search=production" \
  -H "Authorization: Bearer your-api-key-here"

# Sort by name (alphabetical)
curl -X GET "https://api.astracollab.app/v1/keys?sortBy=name&sortOrder=asc"

# Sort by creation date (newest first)
curl -X GET "https://api.astracollab.app/v1/keys?sortBy=createdAt&sortOrder=desc"

# Sort by last usage (most recently used first)
curl -X GET "https://api.astracollab.app/v1/keys?sortBy=lastUsedAt&sortOrder=desc"

{
  "success": false,
  "error": {
    "code": "INVALID_PARAMETERS",
    "message": "Invalid query parameters",
    "details": {
      "limit": "Must be between 1 and 100"
    }
  }
}

{
  "success": false,
  "error": {
    "code": "INVALID_STATUS",
    "message": "Invalid status filter",
    "details": {
      "status": "invalid",
      "validStatuses": ["active", "expired", "revoked"]
    }
  }
}

const KeyManagementDashboard = () => {
  const [activeKeys, setActiveKeys] = useState([]);
  const [expiredKeys, setExpiredKeys] = useState([]);
  const [revokedKeys, setRevokedKeys] = useState([]);

  useEffect(() => {
    const fetchKeys = async () => {
      const [active, expired, revoked] = await Promise.all([
        client.keys.list({ status: 'active' }),
        client.keys.list({ status: 'expired' }),
        client.keys.list({ status: 'revoked' })
      ]);
      
      setActiveKeys(active.keys);
      setExpiredKeys(expired.keys);
      setRevokedKeys(revoked.keys);
    };
    
    fetchKeys();
  }, []);

  return (
    <div>
      <h2>Active Keys ({activeKeys.length})</h2>
      <KeyList keys={activeKeys} />
      
      <h2>Expired Keys ({expiredKeys.length})</h2>
      <KeyList keys={expiredKeys} />
      
      <h2>Revoked Keys ({revokedKeys.length})</h2>
      <KeyList keys={revokedKeys} />
    </div>
  );
};

const getKeyUsageAnalytics = (keys) => {
  const totalUsage = keys.reduce((sum, key) => sum + key.usageCount, 0);
  const mostUsedKey = keys.reduce((max, key) => 
    key.usageCount > max.usageCount ? key : max
  );
  const recentlyUsedKeys = keys
    .filter(key => key.lastUsedAt)
    .sort((a, b) => new Date(b.lastUsedAt) - new Date(a.lastUsedAt))
    .slice(0, 5);

  return {
    totalUsage,
    mostUsedKey,
    recentlyUsedKeys,
    averageUsage: totalUsage / keys.length
  };
};

const checkKeySecurity = (keys) => {
  const issues = [];
  
  keys.forEach(key => {
    // Check for unused keys
    if (!key.lastUsedAt && new Date(key.createdAt) < new Date(Date.now() - 30 * 24 * 60 * 60 * 1000)) {
      issues.push({
        keyId: key.id,
        name: key.name,
        issue: 'Key created 30+ days ago but never used'
      });
    }
    
    // Check for keys with admin permissions
    if (key.permissions.includes('admin')) {
      issues.push({
        keyId: key.id,
        name: key.name,
        issue: 'Key has admin permissions - consider reducing scope'
      });
    }
    
    // Check for expired keys still in use
    if (key.expiresAt && new Date(key.expiresAt) < new Date() && key.lastUsedAt) {
      issues.push({
        keyId: key.id,
        name: key.name,
        issue: 'Expired key still being used'
      });
    }
  });
  
  return issues;
};