Tags

​

Creating Tags

​

Dashboard

1. Navigate to the Tags section
2. Click “Create New Tag”
3. Enter your tag name
4. Save your changes

​

API

POST /tags
Content-Type: application/json

{
  "name": "thisismytag",
}

​

Tagging Resources

​

Applications

• Environment (production, staging, development)
• Business unit
• Customer segment
• Geographic region

POST /api/v1/applications/{application_id}/tags
Content-Type: application/json

{
  "tags": [
    {"key": "environment", "value": "production"},
    {"key": "customer_tier", "value": "enterprise"}
  ]
}

​

API Keys

• Track feature-specific usage
• Monitor integrations
• Analyze customer behavior

POST /api/v1/keys/{key_id}/tags
Content-Type: application/json

{
  "tags": [
    {"key": "feature", "value": "auth"},
    {"key": "region", "value": "eu-west"}
  ]
}

​

Filtering

GET /api/v1/applications?tags[environment]=production
GET /api/v1/keys?tags[customer_tier]=enterprise

​

Usage Analysis

• Customer Segmentation: Track API usage across different customer segments
• Feature Adoption: Monitor which features are being used most frequently
• Environment Analysis: Compare usage patterns across different environments
• Billing Support: Generate accurate usage-based billing reports
• Custom Reporting: Create filtered reports based on specific tags

​

Best Practices

1. Consistent Naming: Use standardized naming conventions for your tags
2. Descriptive Keys: Keep tag keys short but meaningful
3. Tag Limits: Maintain a manageable number of unique tags
4. Documentation: Keep your team aligned by documenting your tagging strategy
5. Regular Reviews: Periodically audit and clean up unused tags

​

Sample Tag Structure

​

Tag Constraints

• Name must be between 3 and 50 characters
• Maximum of 5 tags per resource
• Names can only contain alphanumeric characters and underscores

​

API Reference

​

Create Tag

POST /tag

​

List Tags

GET /tag}

​

Delete Tag

DELETE /tag/{tag_id}

​

Need Help?