Skip to main content

Resources

Tags: configuration, resources

Resource metadata and definitions

Resources​

Request and response models used by the endpoints on this page.

ResourceMetadataResponse​

FieldTypeRequiredDescription
descriptionString✓
labelString✓
requiresFeatureString✓
scopeLiteral['workspace', 'org', 'any']✓
slugString✓
unitString✓
unitPluralString✓

Example:

{
"slug": "string",
"label": "string",
"unit": "string",
"unitPlural": "string",
"description": "string",
"requiresFeature": "string",
"scope": "workspace"
}

ResourcesRegistryResponse​

FieldTypeRequiredDescription
resourcesArray<ResourceMetadataResponse>✓

Example:

{
"resources": []
}

Endpoints​

Registry​

GET /api/v2/resources/registry

Description:

Get the full resource registry with all metadata.

Returns all resource definitions including:

  • Display labels for UI
  • Unit names (singular and plural)
  • Descriptions
  • Required feature flag (if any)
  • Scope (workspace, org, or any)

This endpoint is public (no auth required) as it returns static configuration.

Authentication: Public endpoint (no authentication required)

Response: See ResourcesRegistryResponse


Get Slug​

GET /api/v2/resources/{slug}

Description:

Get a specific resource definition by slug.

Authentication: Public endpoint (no authentication required)

Parameters:

  • slug (String)

Response: See ResourceMetadataResponse