Get Collection
GET/api/v1/infra/collections/:collectionId
Retrieves detailed information about a specific collection by its unique identifier. Returns comprehensive metadata including collection name, type, description, and associated organizational structure within the cloud provider.
Path Parameter Note: If the collections list returns a "provider not supported" error code, use "default" as the collectionId value.
Parameter Details
Header Parameters
integrationid(required): Unique identifier for the cloud provider integration configured in your Unizo account. This UUID associates the API request with the specific cloud account credentials and permissions. Use the integration ID from your Unizo dashboard under Connectors → [Provider] → Integration Details.
Path Parameters
collectionId(required): Unique identifier for the collection within the specified cloud provider. Format varies by provider:- AWS: Region identifier (e.g.,
us-east-1for US compliance,eu-west-1for GDPR compliance) - Google Cloud: Project ID (e.g.,
prod-compliance-env,audit-data-project-2024) - Azure: Use
"default"when no specific subscription or resource group mapping is configured - Other providers: Provider-specific collection identifiers for compliance scope management
- AWS: Region identifier (e.g.,
Request
Responses
- 200
- 400
- 401
- 403
- 404
- 500
Successful Operation
Bad Request
Response Headers
correlationId
Correlation Identifier
Unauthorized
Response Headers
correlationId
Correlation Identifier
Forbidden
Response Headers
correlationId
Correlation Identifier
Not Found
Response Headers
correlationId
Correlation Identifier
Internal Server Error
Response Headers
correlationId
Correlation Identifier