openapi: 3.0.3 info: description: OpenTelemetry-Native Logs, Metrics and Traces in a single pane title: SigNoz version: "" paths: /api/v1/changePassword/{id}: post: deprecated: false description: This endpoint changes the password by id operationId: ChangePassword parameters: - in: path name: id required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/TypesChangePasswordRequest' responses: "204": description: No Content "400": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Bad Request "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "404": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Not Found "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - ADMIN - tokenizer: - ADMIN summary: Change password tags: - users /api/v1/complete/google: get: deprecated: false description: This endpoint creates a session for a user using google callback operationId: CreateSessionByGoogleCallback responses: "303": content: application/json: schema: properties: data: $ref: '#/components/schemas/AuthtypesGettableToken' status: type: string type: object description: See Other "400": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Bad Request "404": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Not Found "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error summary: Create session by google callback tags: - sessions /api/v1/complete/oidc: get: deprecated: false description: This endpoint creates a session for a user using oidc callback operationId: CreateSessionByOIDCCallback responses: "303": content: application/json: schema: properties: data: $ref: '#/components/schemas/AuthtypesGettableToken' status: type: string type: object description: See Other "400": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Bad Request "404": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Not Found "451": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unavailable For Legal Reasons "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error summary: Create session by oidc callback tags: - sessions /api/v1/complete/saml: post: deprecated: false description: This endpoint creates a session for a user using saml callback operationId: CreateSessionBySAMLCallback parameters: - in: query name: RelayState schema: type: string - in: query name: SAMLResponse schema: type: string requestBody: content: application/x-www-form-urlencoded: schema: properties: RelayState: type: string SAMLResponse: type: string type: object responses: "303": content: application/json: schema: properties: data: $ref: '#/components/schemas/AuthtypesGettableToken' status: type: string type: object description: See Other "400": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Bad Request "404": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Not Found "451": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unavailable For Legal Reasons "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error summary: Create session by saml callback tags: - sessions /api/v1/dashboards/{id}/public: delete: deprecated: false description: This endpoint deletes the public sharing config and disables the public sharing of a dashboard operationId: DeletePublicDashboard parameters: - in: path name: id required: true schema: type: string responses: "204": content: application/json: schema: type: string description: No Content "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - ADMIN - tokenizer: - ADMIN summary: Delete public dashboard tags: - dashboard get: deprecated: false description: This endpoint returns public sharing config for a dashboard operationId: GetPublicDashboard parameters: - in: path name: id required: true schema: type: string responses: "200": content: application/json: schema: properties: data: $ref: '#/components/schemas/DashboardtypesGettablePublicDasbhboard' status: type: string type: object description: OK "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - ADMIN - tokenizer: - ADMIN summary: Get public dashboard tags: - dashboard post: deprecated: false description: This endpoint creates public sharing config and enables public sharing of the dashboard operationId: CreatePublicDashboard parameters: - in: path name: id required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/DashboardtypesPostablePublicDashboard' responses: "201": content: application/json: schema: properties: data: $ref: '#/components/schemas/TypesIdentifiable' status: type: string type: object description: Created "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - ADMIN - tokenizer: - ADMIN summary: Create public dashboard tags: - dashboard put: deprecated: false description: This endpoint updates the public sharing config for a dashboard operationId: UpdatePublicDashboard parameters: - in: path name: id required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/DashboardtypesUpdatablePublicDashboard' responses: "204": content: application/json: schema: type: string description: No Content "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - ADMIN - tokenizer: - ADMIN summary: Update public dashboard tags: - dashboard /api/v1/domains: get: deprecated: false description: This endpoint lists all auth domains operationId: ListAuthDomains responses: "200": content: application/json: schema: properties: data: items: $ref: '#/components/schemas/AuthtypesGettableAuthDomain' type: array status: type: string type: object description: OK "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - ADMIN - tokenizer: - ADMIN summary: List all auth domains tags: - authdomains post: deprecated: false description: This endpoint creates an auth domain operationId: CreateAuthDomain requestBody: content: application/json: schema: $ref: '#/components/schemas/AuthtypesPostableAuthDomain' responses: "200": content: application/json: schema: properties: data: $ref: '#/components/schemas/AuthtypesGettableAuthDomain' status: type: string type: object description: OK "400": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Bad Request "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "409": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Conflict "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - ADMIN - tokenizer: - ADMIN summary: Create auth domain tags: - authdomains /api/v1/domains/{id}: delete: deprecated: false description: This endpoint deletes an auth domain operationId: DeleteAuthDomain parameters: - in: path name: id required: true schema: type: string responses: "204": description: No Content "400": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Bad Request "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - ADMIN - tokenizer: - ADMIN summary: Delete auth domain tags: - authdomains put: deprecated: false description: This endpoint updates an auth domain operationId: UpdateAuthDomain parameters: - in: path name: id required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/AuthtypesUpdateableAuthDomain' responses: "204": description: No Content "400": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Bad Request "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "409": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Conflict "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - ADMIN - tokenizer: - ADMIN summary: Update auth domain tags: - authdomains /api/v1/fields/keys: get: deprecated: false description: This endpoint returns field keys operationId: GetFieldsKeys parameters: - in: query name: signal schema: type: string - in: query name: source schema: type: string - in: query name: limit schema: type: integer - in: query name: startUnixMilli schema: format: int64 type: integer - in: query name: endUnixMilli schema: format: int64 type: integer - in: query name: fieldContext schema: type: string - in: query name: fieldDataType schema: type: string - in: query name: metricName schema: type: string - in: query name: searchText schema: type: string responses: "200": content: application/json: schema: properties: data: $ref: '#/components/schemas/TelemetrytypesGettableFieldKeys' status: type: string type: object description: OK "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - VIEWER - tokenizer: - VIEWER summary: Get field keys tags: - fields /api/v1/fields/values: get: deprecated: false description: This endpoint returns field values operationId: GetFieldsValues parameters: - in: query name: signal schema: type: string - in: query name: source schema: type: string - in: query name: limit schema: type: integer - in: query name: startUnixMilli schema: format: int64 type: integer - in: query name: endUnixMilli schema: format: int64 type: integer - in: query name: fieldContext schema: type: string - in: query name: fieldDataType schema: type: string - in: query name: metricName schema: type: string - in: query name: searchText schema: type: string - in: query name: name schema: type: string - in: query name: existingQuery schema: type: string responses: "200": content: application/json: schema: properties: data: $ref: '#/components/schemas/TelemetrytypesGettableFieldValues' status: type: string type: object description: OK "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - VIEWER - tokenizer: - VIEWER summary: Get field values tags: - fields /api/v1/getResetPasswordToken/{id}: get: deprecated: false description: This endpoint returns the reset password token by id operationId: GetResetPasswordToken parameters: - in: path name: id required: true schema: type: string responses: "200": content: application/json: schema: properties: data: $ref: '#/components/schemas/TypesResetPasswordToken' status: type: string type: object description: OK "400": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Bad Request "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "404": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Not Found "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - ADMIN - tokenizer: - ADMIN summary: Get reset password token tags: - users /api/v1/global/config: get: deprecated: false description: This endpoint returns global config operationId: GetGlobalConfig responses: "200": content: application/json: schema: properties: data: $ref: '#/components/schemas/TypesGettableGlobalConfig' status: type: string type: object description: OK "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - EDITOR - tokenizer: - EDITOR summary: Get global config tags: - global /api/v1/invite: get: deprecated: false description: This endpoint lists all invites operationId: ListInvite responses: "200": content: application/json: schema: properties: data: items: $ref: '#/components/schemas/TypesInvite' type: array status: type: string type: object description: OK "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - ADMIN - tokenizer: - ADMIN summary: List invites tags: - users post: deprecated: false description: This endpoint creates an invite for a user operationId: CreateInvite requestBody: content: application/json: schema: $ref: '#/components/schemas/TypesPostableInvite' responses: "201": content: application/json: schema: properties: data: $ref: '#/components/schemas/TypesInvite' status: type: string type: object description: Created "400": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Bad Request "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "409": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Conflict "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - ADMIN - tokenizer: - ADMIN summary: Create invite tags: - users /api/v1/invite/{id}: delete: deprecated: false description: This endpoint deletes an invite by id operationId: DeleteInvite parameters: - in: path name: id required: true schema: type: string responses: "204": description: No Content "400": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Bad Request "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "404": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Not Found "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - ADMIN - tokenizer: - ADMIN summary: Delete invite tags: - users /api/v1/invite/{token}: get: deprecated: false description: This endpoint gets an invite by token operationId: GetInvite parameters: - in: path name: token required: true schema: type: string responses: "200": content: application/json: schema: properties: data: $ref: '#/components/schemas/TypesInvite' status: type: string type: object description: OK "400": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Bad Request "404": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Not Found "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error summary: Get invite tags: - users /api/v1/invite/accept: post: deprecated: false description: This endpoint accepts an invite by token operationId: AcceptInvite requestBody: content: application/json: schema: $ref: '#/components/schemas/TypesPostableAcceptInvite' responses: "201": content: application/json: schema: properties: data: $ref: '#/components/schemas/TypesUser' status: type: string type: object description: Created "400": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Bad Request "404": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Not Found "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error summary: Accept invite tags: - users /api/v1/invite/bulk: post: deprecated: false description: This endpoint creates a bulk invite for a user operationId: CreateBulkInvite requestBody: content: application/json: schema: items: $ref: '#/components/schemas/TypesPostableInvite' type: array responses: "201": description: Created "400": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Bad Request "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "409": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Conflict "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - ADMIN - tokenizer: - ADMIN summary: Create bulk invite tags: - users /api/v1/logs/promote_paths: get: deprecated: false description: This endpoints promotes and indexes paths operationId: ListPromotedAndIndexedPaths responses: "200": content: application/json: schema: properties: data: items: $ref: '#/components/schemas/PromotetypesPromotePath' nullable: true type: array status: type: string type: object description: OK "400": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Bad Request "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error summary: Promote and index paths tags: - logs post: deprecated: false description: This endpoints promotes and indexes paths operationId: HandlePromoteAndIndexPaths requestBody: content: application/json: schema: items: $ref: '#/components/schemas/PromotetypesPromotePath' nullable: true type: array responses: "201": description: Created "400": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Bad Request "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error summary: Promote and index paths tags: - logs /api/v1/org/preferences: get: deprecated: false description: This endpoint lists all org preferences operationId: ListOrgPreferences responses: "200": content: application/json: schema: properties: data: items: $ref: '#/components/schemas/PreferencetypesPreference' type: array status: type: string type: object description: OK "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - ADMIN - tokenizer: - ADMIN summary: List org preferences tags: - preferences /api/v1/org/preferences/{name}: get: deprecated: false description: This endpoint returns the org preference by name operationId: GetOrgPreference parameters: - in: path name: name required: true schema: type: string responses: "200": content: application/json: schema: properties: data: $ref: '#/components/schemas/PreferencetypesPreference' status: type: string type: object description: OK "400": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Bad Request "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "404": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Not Found "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - ADMIN - tokenizer: - ADMIN summary: Get org preference tags: - preferences put: deprecated: false description: This endpoint updates the org preference by name operationId: UpdateOrgPreference parameters: - in: path name: name required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/PreferencetypesUpdatablePreference' responses: "204": description: No Content "400": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Bad Request "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "404": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Not Found "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - ADMIN - tokenizer: - ADMIN summary: Update org preference tags: - preferences /api/v1/pats: get: deprecated: false description: This endpoint lists all api keys operationId: ListAPIKeys responses: "200": content: application/json: schema: properties: data: items: $ref: '#/components/schemas/TypesGettableAPIKey' type: array status: type: string type: object description: OK "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - ADMIN - tokenizer: - ADMIN summary: List api keys tags: - users post: deprecated: false description: This endpoint creates an api key operationId: CreateAPIKey requestBody: content: application/json: schema: $ref: '#/components/schemas/TypesPostableAPIKey' responses: "201": content: application/json: schema: properties: data: $ref: '#/components/schemas/TypesGettableAPIKey' status: type: string type: object description: Created "400": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Bad Request "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "409": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Conflict "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - ADMIN - tokenizer: - ADMIN summary: Create api key tags: - users /api/v1/pats/{id}: delete: deprecated: false description: This endpoint revokes an api key operationId: RevokeAPIKey parameters: - in: path name: id required: true schema: type: string responses: "204": description: No Content "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "404": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Not Found "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - ADMIN - tokenizer: - ADMIN summary: Revoke api key tags: - users put: deprecated: false description: This endpoint updates an api key operationId: UpdateAPIKey parameters: - in: path name: id required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/TypesStorableAPIKey' responses: "204": content: application/json: schema: type: string description: No Content "400": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Bad Request "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "404": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Not Found "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - ADMIN - tokenizer: - ADMIN summary: Update api key tags: - users /api/v1/public/dashboards/{id}: get: deprecated: false description: This endpoint returns the sanitized dashboard data for public access operationId: GetPublicDashboardData parameters: - in: path name: id required: true schema: type: string responses: "200": content: application/json: schema: properties: data: $ref: '#/components/schemas/DashboardtypesGettablePublicDashboardData' status: type: string type: object description: OK "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - anonymous: - public-dashboard:read summary: Get public dashboard data tags: - dashboard /api/v1/public/dashboards/{id}/widgets/{idx}/query_range: get: deprecated: false description: This endpoint return query range results for a widget of public dashboard operationId: GetPublicDashboardWidgetQueryRange parameters: - in: path name: id required: true schema: type: string - in: path name: idx required: true schema: type: string responses: "200": content: application/json: schema: properties: data: $ref: '#/components/schemas/Querybuildertypesv5QueryRangeResponse' status: type: string type: object description: OK "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - anonymous: - public-dashboard:read summary: Get query range result tags: - dashboard /api/v1/resetPassword: post: deprecated: false description: This endpoint resets the password by token operationId: ResetPassword requestBody: content: application/json: schema: $ref: '#/components/schemas/TypesPostableResetPassword' responses: "204": description: No Content "400": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Bad Request "409": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Conflict "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error summary: Reset password tags: - users /api/v1/roles: get: deprecated: false description: This endpoint lists all roles operationId: ListRoles responses: "200": content: application/json: schema: properties: data: items: $ref: '#/components/schemas/RoletypesRole' type: array status: type: string type: object description: OK "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - ADMIN - tokenizer: - ADMIN summary: List roles tags: - role post: deprecated: false description: This endpoint creates a role operationId: CreateRole responses: "201": content: application/json: schema: properties: data: $ref: '#/components/schemas/TypesIdentifiable' status: type: string type: object description: Created "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - ADMIN - tokenizer: - ADMIN summary: Create role tags: - role /api/v1/roles/{id}: delete: deprecated: false description: This endpoint deletes a role operationId: DeleteRole parameters: - in: path name: id required: true schema: type: string responses: "204": content: application/json: schema: type: string description: No Content "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - ADMIN - tokenizer: - ADMIN summary: Delete role tags: - role get: deprecated: false description: This endpoint gets a role operationId: GetRole parameters: - in: path name: id required: true schema: type: string responses: "200": content: application/json: schema: properties: data: $ref: '#/components/schemas/RoletypesRole' status: type: string type: object description: OK "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - ADMIN - tokenizer: - ADMIN summary: Get role tags: - role patch: deprecated: false description: This endpoint patches a role operationId: PatchRole parameters: - in: path name: id required: true schema: type: string responses: "204": content: application/json: schema: type: string description: No Content "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - ADMIN - tokenizer: - ADMIN summary: Patch role tags: - role /api/v1/user: get: deprecated: false description: This endpoint lists all users operationId: ListUsers responses: "200": content: application/json: schema: properties: data: items: $ref: '#/components/schemas/TypesUser' type: array status: type: string type: object description: OK "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - ADMIN - tokenizer: - ADMIN summary: List users tags: - users /api/v1/user/{id}: delete: deprecated: false description: This endpoint deletes the user by id operationId: DeleteUser parameters: - in: path name: id required: true schema: type: string responses: "204": description: No Content "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "404": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Not Found "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - ADMIN - tokenizer: - ADMIN summary: Delete user tags: - users get: deprecated: false description: This endpoint returns the user by id operationId: GetUser parameters: - in: path name: id required: true schema: type: string responses: "200": content: application/json: schema: properties: data: $ref: '#/components/schemas/TypesUser' status: type: string type: object description: OK "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "404": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Not Found "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - ADMIN - tokenizer: - ADMIN summary: Get user tags: - users put: deprecated: false description: This endpoint updates the user by id operationId: UpdateUser parameters: - in: path name: id required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/TypesUser' responses: "200": content: application/json: schema: properties: data: $ref: '#/components/schemas/TypesUser' status: type: string type: object description: OK "400": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Bad Request "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "404": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Not Found "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - ADMIN - tokenizer: - ADMIN summary: Update user tags: - users /api/v1/user/me: get: deprecated: false description: This endpoint returns the user I belong to operationId: GetMyUser responses: "200": content: application/json: schema: properties: data: $ref: '#/components/schemas/TypesUser' status: type: string type: object description: OK "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - tokenizer: [] summary: Get my user tags: - users /api/v1/user/preferences: get: deprecated: false description: This endpoint lists all user preferences operationId: ListUserPreferences responses: "200": content: application/json: schema: properties: data: items: $ref: '#/components/schemas/PreferencetypesPreference' type: array status: type: string type: object description: OK "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - VIEWER - tokenizer: - VIEWER summary: List user preferences tags: - preferences /api/v1/user/preferences/{name}: get: deprecated: false description: This endpoint returns the user preference by name operationId: GetUserPreference parameters: - in: path name: name required: true schema: type: string responses: "200": content: application/json: schema: properties: data: $ref: '#/components/schemas/PreferencetypesPreference' status: type: string type: object description: OK "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "404": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Not Found "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - VIEWER - tokenizer: - VIEWER summary: Get user preference tags: - preferences put: deprecated: false description: This endpoint updates the user preference by name operationId: UpdateUserPreference parameters: - in: path name: name required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/PreferencetypesUpdatablePreference' responses: "204": description: No Content "400": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Bad Request "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "404": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Not Found "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - VIEWER - tokenizer: - VIEWER summary: Update user preference tags: - preferences /api/v2/factor_password/forgot: post: deprecated: false description: This endpoint initiates the forgot password flow by sending a reset password email operationId: ForgotPassword requestBody: content: application/json: schema: $ref: '#/components/schemas/TypesPostableForgotPassword' responses: "204": description: No Content "400": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Bad Request "422": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unprocessable Entity "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error summary: Forgot password tags: - users /api/v2/features: get: deprecated: false description: This endpoint returns the supported features and their details operationId: GetFeatures responses: "200": content: application/json: schema: properties: data: items: $ref: '#/components/schemas/FeaturetypesGettableFeature' type: array status: type: string type: object description: OK "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - VIEWER - tokenizer: - VIEWER summary: Get features tags: - features /api/v2/gateway/ingestion_keys: get: deprecated: false description: This endpoint returns the ingestion keys for a workspace operationId: GetIngestionKeys parameters: - in: query name: page schema: type: integer - in: query name: per_page schema: type: integer responses: "200": content: application/json: schema: properties: data: $ref: '#/components/schemas/GatewaytypesGettableIngestionKeys' status: type: string type: object description: OK "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - ADMIN - tokenizer: - ADMIN summary: Get ingestion keys for workspace tags: - gateway post: deprecated: false description: This endpoint creates an ingestion key for the workspace operationId: CreateIngestionKey requestBody: content: application/json: schema: $ref: '#/components/schemas/GatewaytypesPostableIngestionKey' responses: "200": content: application/json: schema: properties: data: $ref: '#/components/schemas/GatewaytypesGettableCreatedIngestionKey' status: type: string type: object description: OK "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - ADMIN - tokenizer: - ADMIN summary: Create ingestion key for workspace tags: - gateway /api/v2/gateway/ingestion_keys/{keyId}: delete: deprecated: false description: This endpoint deletes an ingestion key for the workspace operationId: DeleteIngestionKey parameters: - in: path name: keyId required: true schema: type: string responses: "204": description: No Content "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - ADMIN - tokenizer: - ADMIN summary: Delete ingestion key for workspace tags: - gateway patch: deprecated: false description: This endpoint updates an ingestion key for the workspace operationId: UpdateIngestionKey parameters: - in: path name: keyId required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/GatewaytypesPostableIngestionKey' responses: "204": description: No Content "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - ADMIN - tokenizer: - ADMIN summary: Update ingestion key for workspace tags: - gateway /api/v2/gateway/ingestion_keys/{keyId}/limits: post: deprecated: false description: This endpoint creates an ingestion key limit operationId: CreateIngestionKeyLimit parameters: - in: path name: keyId required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/GatewaytypesPostableIngestionKeyLimit' responses: "201": content: application/json: schema: properties: data: $ref: '#/components/schemas/GatewaytypesGettableCreatedIngestionKeyLimit' status: type: string type: object description: Created "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - ADMIN - tokenizer: - ADMIN summary: Create limit for the ingestion key tags: - gateway /api/v2/gateway/ingestion_keys/limits/{limitId}: delete: deprecated: false description: This endpoint deletes an ingestion key limit operationId: DeleteIngestionKeyLimit parameters: - in: path name: limitId required: true schema: type: string responses: "204": description: No Content "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - ADMIN - tokenizer: - ADMIN summary: Delete limit for the ingestion key tags: - gateway patch: deprecated: false description: This endpoint updates an ingestion key limit operationId: UpdateIngestionKeyLimit parameters: - in: path name: limitId required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/GatewaytypesUpdatableIngestionKeyLimit' responses: "204": description: No Content "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - ADMIN - tokenizer: - ADMIN summary: Update limit for the ingestion key tags: - gateway /api/v2/gateway/ingestion_keys/search: get: deprecated: false description: This endpoint returns the ingestion keys for a workspace operationId: SearchIngestionKeys parameters: - in: query name: name schema: type: string - in: query name: page schema: type: integer - in: query name: per_page schema: type: integer responses: "200": content: application/json: schema: properties: data: $ref: '#/components/schemas/GatewaytypesGettableIngestionKeys' status: type: string type: object description: OK "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - ADMIN - tokenizer: - ADMIN summary: Search ingestion keys for workspace tags: - gateway /api/v2/metric/alerts: get: deprecated: false description: This endpoint returns associated alerts for a specified metric operationId: GetMetricAlerts parameters: - in: query name: metricName required: true schema: type: string responses: "200": content: application/json: schema: properties: data: $ref: '#/components/schemas/MetricsexplorertypesMetricAlertsResponse' status: type: string type: object description: OK "400": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Bad Request "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - VIEWER - tokenizer: - VIEWER summary: Get metric alerts tags: - metrics /api/v2/metric/dashboards: get: deprecated: false description: This endpoint returns associated dashboards for a specified metric operationId: GetMetricDashboards parameters: - in: query name: metricName required: true schema: type: string responses: "200": content: application/json: schema: properties: data: $ref: '#/components/schemas/MetricsexplorertypesMetricDashboardsResponse' status: type: string type: object description: OK "400": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Bad Request "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - VIEWER - tokenizer: - VIEWER summary: Get metric dashboards tags: - metrics /api/v2/metric/highlights: get: deprecated: false description: This endpoint returns highlights like number of datapoints, totaltimeseries, active time series, last received time for a specified metric operationId: GetMetricHighlights parameters: - in: query name: metricName required: true schema: type: string responses: "200": content: application/json: schema: properties: data: $ref: '#/components/schemas/MetricsexplorertypesMetricHighlightsResponse' status: type: string type: object description: OK "400": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Bad Request "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - VIEWER - tokenizer: - VIEWER summary: Get metric highlights tags: - metrics /api/v2/metrics/{metric_name}/metadata: post: deprecated: false description: This endpoint helps to update metadata information like metric description, unit, type, temporality, monotonicity for a specified metric operationId: UpdateMetricMetadata parameters: - in: path name: metric_name required: true schema: type: string requestBody: content: application/json: schema: $ref: '#/components/schemas/MetricsexplorertypesUpdateMetricMetadataRequest' responses: "200": content: application/json: schema: type: string description: OK "400": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Bad Request "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - EDITOR - tokenizer: - EDITOR summary: Update metric metadata tags: - metrics /api/v2/metrics/attributes: post: deprecated: false description: This endpoint returns attribute keys and their unique values for a specified metric operationId: GetMetricAttributes requestBody: content: application/json: schema: $ref: '#/components/schemas/MetricsexplorertypesMetricAttributesRequest' responses: "200": content: application/json: schema: properties: data: $ref: '#/components/schemas/MetricsexplorertypesMetricAttributesResponse' status: type: string type: object description: OK "400": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Bad Request "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - VIEWER - tokenizer: - VIEWER summary: Get metric attributes tags: - metrics /api/v2/metrics/metadata: get: deprecated: false description: This endpoint returns metadata information like metric description, unit, type, temporality, monotonicity for a specified metric operationId: GetMetricMetadata parameters: - in: query name: metricName required: true schema: type: string responses: "200": content: application/json: schema: properties: data: $ref: '#/components/schemas/MetricsexplorertypesMetricMetadata' status: type: string type: object description: OK "400": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Bad Request "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "404": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Not Found "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - VIEWER - tokenizer: - VIEWER summary: Get metric metadata tags: - metrics /api/v2/metrics/stats: post: deprecated: false description: This endpoint provides list of metrics with their number of samples and timeseries for the given time range operationId: GetMetricsStats requestBody: content: application/json: schema: $ref: '#/components/schemas/MetricsexplorertypesStatsRequest' responses: "200": content: application/json: schema: properties: data: $ref: '#/components/schemas/MetricsexplorertypesStatsResponse' status: type: string type: object description: OK "400": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Bad Request "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - VIEWER - tokenizer: - VIEWER summary: Get metrics statistics tags: - metrics /api/v2/metrics/treemap: post: deprecated: false description: This endpoint returns a treemap visualization showing the proportional distribution of metrics by sample count or time series count operationId: GetMetricsTreemap requestBody: content: application/json: schema: $ref: '#/components/schemas/MetricsexplorertypesTreemapRequest' responses: "200": content: application/json: schema: properties: data: $ref: '#/components/schemas/MetricsexplorertypesTreemapResponse' status: type: string type: object description: OK "400": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Bad Request "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - VIEWER - tokenizer: - VIEWER summary: Get metrics treemap tags: - metrics /api/v2/orgs/me: get: deprecated: false description: This endpoint returns the organization I belong to operationId: GetMyOrganization responses: "200": content: application/json: schema: properties: data: $ref: '#/components/schemas/TypesOrganization' status: type: string type: object description: OK "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - ADMIN - tokenizer: - ADMIN summary: Get my organization tags: - orgs put: deprecated: false description: This endpoint updates the organization I belong to operationId: UpdateMyOrganization requestBody: content: application/json: schema: $ref: '#/components/schemas/TypesOrganization' responses: "204": description: No Content "400": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Bad Request "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "409": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Conflict "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - api_key: - ADMIN - tokenizer: - ADMIN summary: Update my organization tags: - orgs /api/v2/sessions: delete: deprecated: false description: This endpoint deletes the session operationId: DeleteSession responses: "204": description: No Content "400": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Bad Request "401": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Unauthorized "403": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Forbidden "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error security: - tokenizer: [] summary: Delete session tags: - sessions /api/v2/sessions/context: get: deprecated: false description: This endpoint returns the context for the session operationId: GetSessionContext responses: "200": content: application/json: schema: properties: data: $ref: '#/components/schemas/AuthtypesSessionContext' status: type: string type: object description: OK "400": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Bad Request "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error summary: Get session context tags: - sessions /api/v2/sessions/email_password: post: deprecated: false description: This endpoint creates a session for a user using email and password. operationId: CreateSessionByEmailPassword requestBody: content: application/json: schema: $ref: '#/components/schemas/AuthtypesPostableEmailPasswordSession' responses: "200": content: application/json: schema: properties: data: $ref: '#/components/schemas/AuthtypesGettableToken' status: type: string type: object description: OK "400": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Bad Request "404": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Not Found "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error summary: Create session by email and password tags: - sessions /api/v2/sessions/rotate: post: deprecated: false description: This endpoint rotates the session operationId: RotateSession requestBody: content: application/json: schema: $ref: '#/components/schemas/AuthtypesPostableRotateToken' responses: "200": content: application/json: schema: properties: data: $ref: '#/components/schemas/AuthtypesGettableToken' status: type: string type: object description: OK "400": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Bad Request "500": content: application/json: schema: $ref: '#/components/schemas/RenderErrorResponse' description: Internal Server Error summary: Rotate session tags: - sessions components: schemas: AuthtypesAttributeMapping: properties: email: type: string groups: type: string name: type: string role: type: string type: object AuthtypesAuthDomainConfig: properties: googleAuthConfig: $ref: '#/components/schemas/AuthtypesGoogleConfig' oidcConfig: $ref: '#/components/schemas/AuthtypesOIDCConfig' roleMapping: $ref: '#/components/schemas/AuthtypesRoleMapping' samlConfig: $ref: '#/components/schemas/AuthtypesSamlConfig' ssoEnabled: type: boolean ssoType: type: string type: object AuthtypesAuthNProviderInfo: properties: relayStatePath: nullable: true type: string type: object AuthtypesAuthNSupport: properties: callback: items: $ref: '#/components/schemas/AuthtypesCallbackAuthNSupport' nullable: true type: array password: items: $ref: '#/components/schemas/AuthtypesPasswordAuthNSupport' nullable: true type: array type: object AuthtypesCallbackAuthNSupport: properties: provider: type: string url: type: string type: object AuthtypesGettableAuthDomain: properties: authNProviderInfo: $ref: '#/components/schemas/AuthtypesAuthNProviderInfo' createdAt: format: date-time type: string googleAuthConfig: $ref: '#/components/schemas/AuthtypesGoogleConfig' id: type: string name: type: string oidcConfig: $ref: '#/components/schemas/AuthtypesOIDCConfig' orgId: type: string roleMapping: $ref: '#/components/schemas/AuthtypesRoleMapping' samlConfig: $ref: '#/components/schemas/AuthtypesSamlConfig' ssoEnabled: type: boolean ssoType: type: string updatedAt: format: date-time type: string type: object AuthtypesGettableToken: properties: accessToken: type: string expiresIn: type: integer refreshToken: type: string tokenType: type: string type: object AuthtypesGoogleConfig: properties: allowedGroups: items: type: string type: array clientId: type: string clientSecret: type: string domainToAdminEmail: additionalProperties: type: string type: object fetchGroups: type: boolean fetchTransitiveGroupMembership: type: boolean insecureSkipEmailVerified: type: boolean redirectURI: type: string serviceAccountJson: type: string type: object AuthtypesOIDCConfig: properties: claimMapping: $ref: '#/components/schemas/AuthtypesAttributeMapping' clientId: type: string clientSecret: type: string getUserInfo: type: boolean insecureSkipEmailVerified: type: boolean issuer: type: string issuerAlias: type: string type: object AuthtypesOrgSessionContext: properties: authNSupport: $ref: '#/components/schemas/AuthtypesAuthNSupport' id: type: string name: type: string warning: $ref: '#/components/schemas/ErrorsJSON' type: object AuthtypesPasswordAuthNSupport: properties: provider: type: string type: object AuthtypesPostableAuthDomain: properties: config: $ref: '#/components/schemas/AuthtypesAuthDomainConfig' name: type: string type: object AuthtypesPostableEmailPasswordSession: properties: email: type: string orgId: type: string password: type: string type: object AuthtypesPostableRotateToken: properties: refreshToken: type: string type: object AuthtypesRoleMapping: properties: defaultRole: type: string groupMappings: additionalProperties: type: string nullable: true type: object useRoleAttribute: type: boolean type: object AuthtypesSamlConfig: properties: attributeMapping: $ref: '#/components/schemas/AuthtypesAttributeMapping' insecureSkipAuthNRequestsSigned: type: boolean samlCert: type: string samlEntity: type: string samlIdp: type: string type: object AuthtypesSessionContext: properties: exists: type: boolean orgs: items: $ref: '#/components/schemas/AuthtypesOrgSessionContext' nullable: true type: array type: object AuthtypesUpdateableAuthDomain: properties: config: $ref: '#/components/schemas/AuthtypesAuthDomainConfig' type: object DashboardtypesDashboard: properties: createdAt: format: date-time type: string createdBy: type: string data: $ref: '#/components/schemas/DashboardtypesStorableDashboardData' id: type: string locked: type: boolean org_id: type: string updatedAt: format: date-time type: string updatedBy: type: string type: object DashboardtypesGettablePublicDasbhboard: properties: defaultTimeRange: type: string publicPath: type: string timeRangeEnabled: type: boolean type: object DashboardtypesGettablePublicDashboardData: properties: dashboard: $ref: '#/components/schemas/DashboardtypesDashboard' publicDashboard: $ref: '#/components/schemas/DashboardtypesGettablePublicDasbhboard' type: object DashboardtypesPostablePublicDashboard: properties: defaultTimeRange: type: string timeRangeEnabled: type: boolean type: object DashboardtypesStorableDashboardData: additionalProperties: {} type: object DashboardtypesUpdatablePublicDashboard: properties: defaultTimeRange: type: string timeRangeEnabled: type: boolean type: object ErrorsJSON: properties: code: type: string errors: items: $ref: '#/components/schemas/ErrorsResponseerroradditional' type: array message: type: string url: type: string type: object ErrorsResponseerroradditional: properties: message: type: string type: object FeaturetypesGettableFeature: properties: defaultVariant: type: string description: type: string kind: type: string name: type: string resolvedValue: {} stage: type: string variants: additionalProperties: {} nullable: true type: object type: object GatewaytypesGettableCreatedIngestionKey: properties: id: type: string value: type: string type: object GatewaytypesGettableCreatedIngestionKeyLimit: properties: id: type: string type: object GatewaytypesGettableIngestionKeys: properties: _pagination: $ref: '#/components/schemas/GatewaytypesPagination' keys: items: $ref: '#/components/schemas/GatewaytypesIngestionKey' nullable: true type: array type: object GatewaytypesIngestionKey: properties: created_at: format: date-time type: string expires_at: format: date-time type: string id: type: string limits: items: $ref: '#/components/schemas/GatewaytypesLimit' nullable: true type: array name: type: string tags: items: type: string nullable: true type: array updated_at: format: date-time type: string value: type: string workspace_id: type: string type: object GatewaytypesLimit: properties: config: $ref: '#/components/schemas/GatewaytypesLimitConfig' created_at: format: date-time type: string id: type: string key_id: type: string metric: $ref: '#/components/schemas/GatewaytypesLimitMetric' signal: type: string tags: items: type: string nullable: true type: array updated_at: format: date-time type: string type: object GatewaytypesLimitConfig: properties: day: $ref: '#/components/schemas/GatewaytypesLimitValue' second: $ref: '#/components/schemas/GatewaytypesLimitValue' type: object GatewaytypesLimitMetric: properties: day: $ref: '#/components/schemas/GatewaytypesLimitMetricValue' second: $ref: '#/components/schemas/GatewaytypesLimitMetricValue' type: object GatewaytypesLimitMetricValue: properties: count: format: int64 type: integer size: format: int64 type: integer type: object GatewaytypesLimitValue: properties: count: format: int64 type: integer size: format: int64 type: integer type: object GatewaytypesPagination: properties: page: type: integer pages: type: integer per_page: type: integer total: type: integer type: object GatewaytypesPostableIngestionKey: properties: expires_at: format: date-time type: string name: type: string tags: items: type: string nullable: true type: array type: object GatewaytypesPostableIngestionKeyLimit: properties: config: $ref: '#/components/schemas/GatewaytypesLimitConfig' signal: type: string tags: items: type: string nullable: true type: array type: object GatewaytypesUpdatableIngestionKeyLimit: properties: config: $ref: '#/components/schemas/GatewaytypesLimitConfig' tags: items: type: string nullable: true type: array type: object MetricsexplorertypesMetricAlert: properties: alertId: type: string alertName: type: string required: - alertName - alertId type: object MetricsexplorertypesMetricAlertsResponse: properties: alerts: items: $ref: '#/components/schemas/MetricsexplorertypesMetricAlert' nullable: true type: array required: - alerts type: object MetricsexplorertypesMetricAttribute: properties: key: type: string valueCount: minimum: 0 type: integer values: items: type: string nullable: true type: array required: - key - values - valueCount type: object MetricsexplorertypesMetricAttributesRequest: properties: end: nullable: true type: integer metricName: type: string start: nullable: true type: integer required: - metricName type: object MetricsexplorertypesMetricAttributesResponse: properties: attributes: items: $ref: '#/components/schemas/MetricsexplorertypesMetricAttribute' nullable: true type: array totalKeys: format: int64 type: integer required: - attributes - totalKeys type: object MetricsexplorertypesMetricDashboard: properties: dashboardId: type: string dashboardName: type: string widgetId: type: string widgetName: type: string required: - dashboardName - dashboardId - widgetId - widgetName type: object MetricsexplorertypesMetricDashboardsResponse: properties: dashboards: items: $ref: '#/components/schemas/MetricsexplorertypesMetricDashboard' nullable: true type: array required: - dashboards type: object MetricsexplorertypesMetricHighlightsResponse: properties: activeTimeSeries: minimum: 0 type: integer dataPoints: minimum: 0 type: integer lastReceived: minimum: 0 type: integer totalTimeSeries: minimum: 0 type: integer required: - dataPoints - lastReceived - totalTimeSeries - activeTimeSeries type: object MetricsexplorertypesMetricMetadata: properties: description: type: string isMonotonic: type: boolean temporality: $ref: '#/components/schemas/MetrictypesTemporality' type: $ref: '#/components/schemas/MetrictypesType' unit: type: string required: - description - type - unit - temporality - isMonotonic type: object MetricsexplorertypesStat: properties: description: type: string metricName: type: string samples: minimum: 0 type: integer timeseries: minimum: 0 type: integer type: $ref: '#/components/schemas/MetrictypesType' unit: type: string required: - metricName - description - type - unit - timeseries - samples type: object MetricsexplorertypesStatsRequest: properties: end: format: int64 type: integer filter: $ref: '#/components/schemas/Querybuildertypesv5Filter' limit: type: integer offset: type: integer orderBy: $ref: '#/components/schemas/Querybuildertypesv5OrderBy' start: format: int64 type: integer required: - start - end - limit type: object MetricsexplorertypesStatsResponse: properties: metrics: items: $ref: '#/components/schemas/MetricsexplorertypesStat' nullable: true type: array total: minimum: 0 type: integer required: - metrics - total type: object MetricsexplorertypesTreemapEntry: properties: metricName: type: string percentage: format: double type: number totalValue: minimum: 0 type: integer required: - metricName - percentage - totalValue type: object MetricsexplorertypesTreemapMode: enum: - timeseries - samples type: string MetricsexplorertypesTreemapRequest: properties: end: format: int64 type: integer filter: $ref: '#/components/schemas/Querybuildertypesv5Filter' limit: type: integer mode: $ref: '#/components/schemas/MetricsexplorertypesTreemapMode' start: format: int64 type: integer required: - start - end - limit - mode type: object MetricsexplorertypesTreemapResponse: properties: samples: items: $ref: '#/components/schemas/MetricsexplorertypesTreemapEntry' nullable: true type: array timeseries: items: $ref: '#/components/schemas/MetricsexplorertypesTreemapEntry' nullable: true type: array required: - timeseries - samples type: object MetricsexplorertypesUpdateMetricMetadataRequest: properties: description: type: string isMonotonic: type: boolean metricName: type: string temporality: $ref: '#/components/schemas/MetrictypesTemporality' type: $ref: '#/components/schemas/MetrictypesType' unit: type: string required: - metricName - type - description - unit - temporality - isMonotonic type: object MetrictypesTemporality: enum: - delta - cumulative - unspecified type: string MetrictypesType: enum: - gauge - sum - histogram - summary - exponentialhistogram type: string PreferencetypesPreference: properties: allowedScopes: items: type: string nullable: true type: array allowedValues: items: type: string nullable: true type: array defaultValue: $ref: '#/components/schemas/PreferencetypesValue' description: type: string name: type: string value: $ref: '#/components/schemas/PreferencetypesValue' valueType: type: string type: object PreferencetypesUpdatablePreference: properties: value: {} type: object PreferencetypesValue: type: object PromotetypesPromotePath: properties: indexes: items: $ref: '#/components/schemas/PromotetypesWrappedIndex' type: array path: type: string promote: type: boolean type: object PromotetypesWrappedIndex: properties: column_type: type: string granularity: type: integer type: type: string type: object Querybuildertypesv5ExecStats: properties: bytesScanned: minimum: 0 type: integer durationMs: minimum: 0 type: integer rowsScanned: minimum: 0 type: integer stepIntervals: additionalProperties: minimum: 0 type: integer type: object type: object Querybuildertypesv5Filter: properties: expression: type: string type: object Querybuildertypesv5OrderBy: properties: direction: type: string key: $ref: '#/components/schemas/Querybuildertypesv5OrderByKey' type: object Querybuildertypesv5OrderByKey: properties: description: type: string fieldContext: type: string fieldDataType: type: string name: type: string signal: type: string unit: type: string required: - name type: object Querybuildertypesv5QueryData: properties: results: items: {} nullable: true type: array type: object Querybuildertypesv5QueryRangeResponse: properties: data: $ref: '#/components/schemas/Querybuildertypesv5QueryData' meta: $ref: '#/components/schemas/Querybuildertypesv5ExecStats' type: type: string warning: $ref: '#/components/schemas/Querybuildertypesv5QueryWarnData' type: object Querybuildertypesv5QueryWarnData: properties: message: type: string url: type: string warnings: items: $ref: '#/components/schemas/Querybuildertypesv5QueryWarnDataAdditional' type: array type: object Querybuildertypesv5QueryWarnDataAdditional: properties: message: type: string type: object RenderErrorResponse: properties: error: $ref: '#/components/schemas/ErrorsJSON' status: type: string type: object RoletypesRole: properties: createdAt: format: date-time type: string description: type: string id: type: string name: type: string orgId: type: string type: type: string updatedAt: format: date-time type: string type: object TelemetrytypesGettableFieldKeys: properties: complete: type: boolean keys: additionalProperties: items: $ref: '#/components/schemas/TelemetrytypesTelemetryFieldKey' type: array nullable: true type: object required: - keys - complete type: object TelemetrytypesGettableFieldValues: properties: complete: type: boolean values: $ref: '#/components/schemas/TelemetrytypesTelemetryFieldValues' required: - values - complete type: object TelemetrytypesTelemetryFieldKey: properties: description: type: string fieldContext: type: string fieldDataType: type: string name: type: string signal: type: string unit: type: string required: - name type: object TelemetrytypesTelemetryFieldValues: properties: boolValues: items: type: boolean type: array numberValues: items: format: double type: number type: array relatedValues: items: type: string type: array stringValues: items: type: string type: array type: object TypesChangePasswordRequest: properties: newPassword: type: string oldPassword: type: string userId: type: string type: object TypesGettableAPIKey: properties: createdAt: format: date-time type: string createdBy: type: string createdByUser: $ref: '#/components/schemas/TypesUser' expiresAt: format: int64 type: integer id: type: string lastUsed: format: int64 type: integer name: type: string revoked: type: boolean role: type: string token: type: string updatedAt: format: date-time type: string updatedBy: type: string updatedByUser: $ref: '#/components/schemas/TypesUser' userId: type: string type: object TypesGettableGlobalConfig: properties: external_url: type: string ingestion_url: type: string type: object TypesIdentifiable: properties: id: type: string type: object TypesInvite: properties: createdAt: format: date-time type: string email: type: string id: type: string inviteLink: type: string name: type: string orgId: type: string role: type: string token: type: string updatedAt: format: date-time type: string type: object TypesOrganization: properties: alias: type: string createdAt: format: date-time type: string displayName: type: string id: type: string key: minimum: 0 type: integer name: type: string updatedAt: format: date-time type: string type: object TypesPostableAPIKey: properties: expiresInDays: format: int64 type: integer name: type: string role: type: string type: object TypesPostableAcceptInvite: properties: displayName: type: string password: type: string sourceUrl: type: string token: type: string type: object TypesPostableForgotPassword: properties: email: type: string frontendBaseURL: type: string orgId: type: string required: - orgId - email type: object TypesPostableInvite: properties: email: type: string frontendBaseUrl: type: string name: type: string role: type: string type: object TypesPostableResetPassword: properties: password: type: string token: type: string type: object TypesResetPasswordToken: properties: expiresAt: format: date-time type: string id: type: string passwordId: type: string token: type: string type: object TypesStorableAPIKey: properties: createdAt: format: date-time type: string createdBy: type: string id: type: string name: type: string revoked: type: boolean role: type: string token: type: string updatedAt: format: date-time type: string updatedBy: type: string userId: type: string type: object TypesUser: properties: createdAt: format: date-time type: string displayName: type: string email: type: string id: type: string isRoot: type: boolean orgId: type: string role: type: string updatedAt: format: date-time type: string type: object securitySchemes: api_key: description: API Keys in: header name: SigNoz-Api-Key type: apiKey tokenizer: bearerFormat: Tokenizer description: Tokens generated by the tokenizer scheme: bearer type: http