List disk templates
GET/organizations/organization/disk_templates
Return a list of all disk templates owned by an organization
Scopes
disk_templates
disk_templates:read
OAuth2 Scopes
When using OAuth2 authentication, scopes are prefixed with api.katapult.io/core/v1/
.
Request
Query Parameters
The organization to find disk templates for.
All 'organization[]' params are mutually exclusive, only one can be provided.
The organization to find disk templates for.
All 'organization[]' params are mutually exclusive, only one can be provided.
Whether or not to include universal templates
An operating system to use to filter disk templates.
All 'operating_system[]' params are mutually exclusive, only one can be provided.
Possible values: >= 1
Default value: 1
The page number to request. If not provided, the first page will be returned.
Possible values: >= 1
Default value: 30
The number of items to return per page. If not provided, the default value will be used.
Responses
- 200
- 400
- 403
- 404
- 429
- 503
Return a list of all disk templates owned by an organization
- application/json
- Schema
- Example (from schema)
Schema
Array [
]
pagination
object
required
The current page
The total number of pages
The total number of items across all pages
The number of items per page
Is this a large set and therefore the total number of records cannot be returned?
disk_templates
object[]
required
The list of disk templates
latest_version
object
nullable
operating_system
object
nullable
{
"pagination": {
"current_page": 0,
"total_pages": 0,
"total": 0,
"per_page": 0,
"large_set": true
},
"disk_templates": [
{
"id": "string",
"name": "string",
"description": "string",
"permalink": "string",
"universal": true,
"size_in_gb": 0,
"latest_version": {
"id": "string",
"number": 0
},
"operating_system": {
"id": "string",
"name": "string"
}
}
]
}
No API token was provided in the Authorization header. Ensure a token is provided prefixed with Bearer
- application/json
- Schema
- Example (from schema)
Schema
Possible values: [missing_api_token
]
{
"code": "missing_api_token",
"description": "string",
"detail": {}
}
403 error response
- application/json
- Schema
- Example (from schema)
Schema
- UnauthorizedNetworkForAPITokenSchema
- InvalidAPITokenSchema
- InvalidCapabilitiesTokenSchema
- ScopeNotGrantedErrorSchema
- OrganizationSuspendedSchema
- OrganizationNotActivatedSchema
oneOf
Network is not allowed to access the API with this API token
Possible values: [unauthorized_network_for_api_token
]
detail
object
The IP address the request was received from
The API token provided was not valid (it may not exist or have expired)
Possible values: [invalid_api_token
]
detail
object
The capabilities token provided was not valid (either not valid, expired or not signed by the correct key)
Possible values: [invalid_capabilities_token
]
The scope required for this endpoint has not been granted to the authenticating identity
Possible values: [scope_not_granted
]
detail
ScopeNotGrantedError
An organization was found from the arguments provided but it was suspended
Possible values: [organization_suspended
]
An organization was found from the arguments provided but it wasn't activated yet
Possible values: [organization_not_activated
]
{}
404 error response
- application/json
- Schema
- Example (from schema)
Schema
- OrganizationNotFoundSchema
- OperatingSystemNotFoundSchema
oneOf
No organization was found matching any of the criteria provided in the arguments
Possible values: [organization_not_found
]
No operating system was found matching any of the criteria provided in the arguments
Possible values: [operating_system_not_found
]
{}
You have reached the rate limit for this type of request
- application/json
- Schema
- Example (from schema)
Schema
Possible values: [rate_limit_reached
]
detail
object
The total number of requests per minute that are permitted
{
"code": "rate_limit_reached",
"description": "string",
"detail": {
"total_permitted": 0
}
}
The service is currently unavailable, please try again later
- application/json
- Schema
- Example (from schema)
Schema
Possible values: [service_unavailable
]
{
"code": "service_unavailable",
"description": "string",
"detail": {}
}