> ## Documentation Index > Fetch the complete documentation index at: https://togai.mintlify.site/llms.txt > Use this file to discover all available pages before exploring further. # Activate usage meter > Activate usage meter ## OpenAPI ````yaml post /usage_meters/{usage_meter_id}/activate openapi: 3.0.3 info: version: '1.0' title: Togai Apis contact: email: engg@togai.com license: name: Apache 2.0 url: http://www.apache.org/licenses/LICENSE-2.0.html description: APIs for Togai App servers: - description: Api endpoint url: https://api.togai.com/ - description: Sandbox api endpoint url: https://sandbox-api.togai.com/ security: - bearerAuth: [] tags: - name: Customers description: Customer level calls - name: Accounts description: Account level calls - name: Event Schemas description: Event Schema level calls - name: Usage Meters description: Usage Meter level calls - name: Price Plans description: Price Plan level calls - name: Settings description: Settings - name: Price Experimentation description: Price Experimentation apis - name: InvoiceGroups description: Invoice Group level calls - name: Organization description: Organization level calls - name: FileStorage description: File Storage level calls - name: Aliases description: Alias level calls - name: Event Management description: APIs for getting events ingested in Togai externalDocs: description: docs url: https://togai.com/docs/billing/events - name: Metrics description: APIs for getting Togai metrics externalDocs: description: docs url: https://togai.com/docs/metrics - name: Licenses description: APIs for getting or updating license records in Togai - name: Entitlements description: APIs related to entitlements - name: Invoices description: Invoices API - name: Credits description: Credits API - name: Wallet description: Wallet API - name: InvoiceTemplates description: InvoiceTemplates API - name: Payments description: Payments API - name: Authentication description: Authentication API externalDocs: description: Find out more about Togai url: https://docs.togai.com/docs paths: /usage_meters/{usage_meter_id}/activate: post: tags: - Usage Meters summary: Activate usage meter description: Activate usage meter operationId: activateUsageMeter parameters: - $ref: '#/components/parameters/usage_meter_id' responses: '200': $ref: '#/components/responses/UsageMeterResponse' '400': $ref: '#/components/responses/ErrorResponse' '401': $ref: '#/components/responses/ErrorResponse' '403': $ref: '#/components/responses/ErrorResponse' '404': $ref: '#/components/responses/ErrorResponse' '429': $ref: '#/components/responses/ErrorResponse' default: $ref: '#/components/responses/ErrorResponse' components: parameters: usage_meter_id: in: path name: usage_meter_id required: true schema: type: string maxLength: 50 example: um.1zYnCiM9Bpg.1zYn responses: UsageMeterResponse: description: Response for Create and Get usage event requests content: application/json: schema: $ref: '#/components/schemas/UsageMeter' examples: Customer: $ref: '#/components/examples/UsageMeter' ErrorResponse: description: Error response content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: ErrorResponse: summary: Error message value: message: schemas: UsageMeter: description: Structure of usage meter type: object additionalProperties: false required: - id - name - displayName - type - aggregation properties: id: description: Identifier of the usage meter type: string maxLength: 20 name: description: Name of the usage meter type: string maxLength: 50 pattern: ^[\sa-zA-Z0-9_-]*$ example: rides-usage billableName: description: >- Billable name of addon. Billable name takes precedence over name to display in invoice. type: string maxLength: 255 example: Rides Usage displayName: description: > Display name of usage meter. This is an auto-generated field which contains billableName of usage meter. If billableName is not provided, name will be used as display name. type: string maxLength: 255 description: type: string maxLength: 255 example: Meter to track cab rides type: description: Type of usage meter type: string enum: - COUNTER example: COUNTER status: description: Status of usage meter type: string enum: - DRAFT - ACTIVE - INACTIVE - ARCHIVED example: DRAFT aggregation: description: Aggregation to be applied on usage meter result type: string enum: - COUNT - SUM computations: type: array minItems: 0 maxItems: 1 items: $ref: '#/components/schemas/Computation' createdAt: type: string format: date-time lastActivatedAt: type: string format: date-time updatedAt: type: string format: date-time ErrorResponse: type: object additionalProperties: false required: - message properties: message: type: string description: error description maxLength: 500 Computation: type: object required: - computation - order properties: id: description: Optional identifier describing the matcher and computation pair type: string maxLength: 50 matcher: description: > Condition to be applied on event. Upon matching it the corresponding computation will be considered for usage_meter unit calculation. The result of the matcher needs to be [truthy](https://jsonlogic.com/truthy.html) in order to be considered as a match. type: string maxLength: 1500 example: | { "and": [ {"in": [{"var": "dimension.city"}, "chennai", "mumbai"]}, "or": [ {">": [{"var": "attribute.distance"}, 100]}, {"<": [{"var": "attribute.distance"}, 20]} ] ] } computation: description: > Computation to be applied on an event if it matches the matcher. In case of a COUNT aggregation type, computation should be passed as '1' type: string maxLength: 500 example: '*': - var: attributes.distance - 0.4 order: description: The order in which multiple matched computations will get evaluated type: integer examples: UsageMeter: value: id: um.1zlQTBWlkeO.lB7fh name: Rides displayName: Rides description: Cab rides type: COUNTER aggregation: COUNT status: DRAFT computations: - matcher: | { "and": [ {"in": [{"var": "dimension.city"}, "chennai", "mumbai"]}, "or": [ {">": [{"var": "attribute.distance"}, 100]}, {"<": [{"var": "attribute.distance"}, 20]} ] ] } computation: '1' securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: Bearer ````