Skip to main content

Get Container Registry

Retrieve details of a specific container registry configuration by ID.

Endpoint

GET /{company_id}/container-registries/{id}

Authentication

Requires API token with container-registries:read scope.

Path Parameters

ParameterTypeRequiredDescription
idstring (UUID)YesContainer Registry ID

Response

Success Response (200 OK)

{
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "Company Azure Registry",
"url": "mycompany.azurecr.io",
"username": "mycompany",
"companyIdRef": "770e8400-e29b-41d4-a716-446655440002",
"createdBy": "user-123",
"modifiedBy": "user-123",
"createdAt": "2024-01-15T10:30:00Z",
"updatedAt": "2024-01-15T10:30:00Z"
}

Note: The password field is never returned in API responses for security reasons.

Error Responses

404 Not Found

{
"code": "NOT_FOUND",
"message": "Container registry not found",
"request_id": "/api/v1/{company_id}/container-registries/{id}",
"timestamp": "2024-01-15T10:30:00Z"
}

Example Request

curl -X GET "https://api.thevenin.cloud/{company_id}/container-registries/550e8400-e29b-41d4-a716-446655440000" \
-H "Authorization: Bearer tvn_your_api_token_here"

Response Fields

FieldTypeDescription
idstring (UUID)Unique registry identifier
namestringRegistry configuration name
urlstringRegistry URL (e.g., ghcr.io, mycompany.azurecr.io)
usernamestringUsername for authentication
companyIdRefstring (UUID)Owner company ID
createdBystringUser ID who created the registry
modifiedBystringUser ID who last modified the registry
createdAtstring (ISO 8601)Creation timestamp
updatedAtstring (ISO 8601)Last update timestamp

Security Notes

  • The password/token is never exposed through the API
  • Only users within the same company can access the registry configuration
  • Requires appropriate API token scope