> ## Documentation Index > Fetch the complete documentation index at: https://docs.vantage.sh/llms.txt > Use this file to discover all available pages before exploring further. > ## Agent Instructions > If the person you are helping needs a new Vantage account, read https://docs.vantage.sh/auth.md before you register one. # Revoke ingest token > Revoke an ingest token while preserving its metadata. Repeated revocation has no additional effect. ## OpenAPI ````yaml https://api.vantage.sh/v2/oas_v3.json post /ingest_tokens/{token_id}/revoke openapi: 3.0.1 info: title: Vantage description: Vantage API termsOfService: https://www.vantage.sh/terms-of-use contact: name: Vantage Support url: https://www.vantage.sh email: support@vantage.sh version: 2.0.0 servers: - url: https://api.vantage.sh/v2 security: - oauth2: - read tags: - name: AccessGrants description: Operations about AccessGrants - name: AccessPolicies description: Operations about AccessPolicies - name: Annotations description: Operations about Annotations - name: AnomalyAlerts description: Operations about AnomalyAlerts - name: AnomalyNotifications description: Operations about AnomalyNotifications - name: AuditLogs description: Operations about AuditLogs - name: BillingProfiles description: Operations about BillingProfiles - name: BillingRules description: Operations about BillingRules - name: BudgetAlerts description: Operations about BudgetAlerts - name: Budgets description: Operations about Budgets - name: BusinessMetrics description: Operations about BusinessMetrics - name: Canvases description: Operations about Canvases - name: CostAlertEvents description: Operations about CostAlertEvents - name: CostAlerts description: Operations about CostAlerts - name: CostProvider description: Operations about CostProviders - name: CostProviderAccounts description: Operations about CostProviderAccounts - name: Costs description: Operations about Costs - name: CostService description: Operations about CostServices - name: DashboardNotifications description: Operations about DashboardNotifications - name: Dashboards description: Operations about Dashboards - name: DataExports description: Operations about DataExports - name: EnrichmentSources description: Operations about EnrichmentSources - name: EnrichmentStatistics description: Operations about EnrichmentStatistics - name: ExchangeRates description: Operations about ExchangeRates - name: FinancialCommitmentReports description: Operations about FinancialCommitmentReports - name: FinancialCommitments description: Operations about FinancialCommitments - name: Folders description: Operations about Folders - name: IngestTokens description: Operations about IngestTokens - name: Integrations description: Operations about Integrations - name: Invoices description: Operations about Invoices - name: KubernetesEfficiencyReports description: Operations about KubernetesEfficiencyReports - name: ManagedAccounts description: Operations about ManagedAccounts - name: Me description: Operations about Mes - name: NetworkFlowLogs description: Operations about NetworkFlowLogs - name: NetworkFlowReports description: Operations about NetworkFlowReports - name: OpenAPISpecification description: Operations about OpenAPISpecifications - name: Ping description: Operations about Pings - name: Prices description: Operations about Prices - name: Recommendations description: Operations about Recommendations - name: RecommendationViews description: Operations about RecommendationViews - name: ReportForecasts description: Operations about ReportForecasts - name: ReportNotifications description: Operations about ReportNotifications - name: ResourceReports description: Operations about ResourceReports - name: Resources description: Operations about Resources - name: SavedFilters description: Operations about SavedFilters - name: ScenarioModels description: Operations about ScenarioModels - name: Segments description: Operations about Segments - name: Tags description: Operations about Tags - name: Teams description: Operations about Teams - name: UnitCosts description: Operations about UnitCosts - name: UserFeedback description: Operations about UserFeedbacks - name: Users description: Operations about Users - name: VirtualTags description: Operations about VirtualTags - name: Workspaces description: Operations about Workspaces paths: /ingest_tokens/{token_id}/revoke: post: tags: - IngestTokens summary: Revoke ingest token description: >- Revoke an ingest token while preserving its metadata. Repeated revocation has no additional effect. operationId: revokeIngestToken parameters: - name: token_id in: path required: true schema: type: string responses: '201': description: >- Revoke an ingest token while preserving its metadata. Repeated revocation has no additional effect. content: application/json: schema: $ref: '#/components/schemas/IngestToken' example: token: tlm_tok_b10bef544f7f324b feed_token: srvc_data_intgrtn_db12bf82d85fa6ca provider: bifrost name: null last4: HKAw retention_days: null issued_at: '2026-11-11T12:00:00Z' expires_at: '2028-05-11T12:00:00Z' revoked_at: '2026-11-11T12:00:00Z' created_by: usr_68164c550d677188 '404': description: NotFound content: application/json: schema: $ref: '#/components/schemas/Errors' security: - oauth2: - write components: schemas: IngestToken: required: - created_by - expires_at - feed_token - issued_at - last4 - name - provider - retention_days - revoked_at - token type: object properties: token: type: string description: >- The public identifier for this token, not the secret ingest credential. nullable: false feed_token: type: string description: The public token of the telemetry feed this token belongs to. nullable: false provider: type: string description: The telemetry provider for this token. nullable: false name: type: string description: The token name. nullable: true last4: type: string description: The last four characters of the secret ingest credential. nullable: false retention_days: type: integer description: The retention period in days, when specified. format: int32 nullable: true issued_at: type: string description: When the token was issued, in ISO 8601 format. nullable: false expires_at: type: string description: When the token expires, in ISO 8601 format. nullable: false revoked_at: type: string description: When the token was revoked, in ISO 8601 format. nullable: true created_by: type: string description: >- The public token of the user who created this ingest token, when available. nullable: true description: IngestToken model Errors: required: - errors type: object properties: links: $ref: '#/components/schemas/Links' errors: type: array nullable: false items: type: string description: Errors model Links: type: object properties: self: type: string description: The URL of the current page of results. nullable: true first: type: string description: The URL of the first page of results. nullable: true next: type: string description: The URL of the next page of results, if one exists. nullable: true last: type: string description: The URL of the last page of results, if one exists. nullable: true prev: type: string description: The URL of the previous page of results, if one exists. nullable: true securitySchemes: oauth2: type: oauth2 flows: clientCredentials: tokenUrl: https://console.vantage.sh/account/profile scopes: read: Grants read access write: Grants write access ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.