> ## Documentation Index > Fetch the complete documentation index at: https://docs.tamradar.com/llms.txt > Use this file to discover all available pages before exploring further. # Deactivate Radar > Deactivate a radar by ID. ## OpenAPI ````yaml /api_specs.yaml DELETE /v1/radars/{radar_id} openapi: 3.0.0 info: title: TAMradar API version: '1.0' description: Canonical OpenAPI spec for TAMradar customer-facing APIs. servers: - url: https://api.tamradar.com description: Production API server security: [] paths: /v1/radars/{radar_id}: delete: tags: - Radars summary: Deactivate a radar description: >- Deactivates a radar (soft delete). Behavior depends on the radar's pricing model: - **Monthly subscription radars** — enter a grace period until the end of the current billing cycle, during which the radar continues to function normally. No additional charges will occur after deactivation. - **Update-based radars** — deactivated immediately. No grace period applies since there is no billing cycle to honor. operationId: deleteRadar parameters: - name: radar_id in: path description: The unique identifier of the radar to delete required: true schema: type: string format: uuid responses: '200': description: Radar successfully deactivated content: application/json: schema: type: object properties: status: type: string enum: - success code: type: integer enum: - 200 message: type: string data: type: object properties: radar_id: type: string format: uuid domain: type: string radar_type: type: string enum: - company_new_hires - company_job_openings - company_promotions - company_reviews - company_mentions - company_social_posts - company_social_posts_cxo - company_social_engagements - contact_job_changes - contact_social_posts - contact_social_engagements - industry_mentions - industry_funding_rounds - industry_new_companies - industry_job_openings radar_status: type: string enum: - inactive description: >- Public status after deactivation. Internally, monthly subscription radars may stay in `inactive_grace_period` until cycle end, while update-based radars are deactivated immediately. webhook_url: type: string format: uri nullable: true created_at: type: string format: date-time deactivated_at: type: string format: date-time nullable: true next_charge_at: type: string format: date-time nullable: true custom_fields: type: object additionalProperties: true profile_url: type: string format: uri nullable: true description: >- LinkedIn company page URL if provided during radar creation. timestamp: type: string format: date-time examples: monthly_subscription_grace_period: summary: Monthly subscription radar enters grace period value: status: success code: 200 timestamp: '2024-03-20T10:15:30.000Z' message: >- Radar deactivation initiated - service will continue until the end of the current billing cycle data: radar_id: 123e4567-e89b-12d3-a456-426614174000 radar_type: company_new_hires domain: example.com created_at: '2024-03-20T10:00:00.000Z' deactivated_at: '2024-03-20T10:15:00.000Z' next_charge_at: '2024-04-20T10:00:00.000Z' webhook_url: https://your-webhook.com/endpoint radar_status: inactive custom_fields: department: engineering notes: Track engineering hires update_based_immediate: summary: Update-based radar deactivates immediately value: status: success code: 200 timestamp: '2024-03-20T10:15:30.000Z' message: Radar deactivated successfully data: radar_id: 223e4567-e89b-12d3-a456-426614174111 radar_type: contact_job_changes domain: example.com created_at: '2024-03-20T10:00:00.000Z' deactivated_at: '2024-03-20T10:15:00.000Z' next_charge_at: null webhook_url: https://your-webhook.com/endpoint radar_status: inactive custom_fields: account_id: acc_123 '400': description: Bad Request - Radar already inactive or in grace period content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: status: error code: 400 message: Radar is already deactivated errors: - field: id reason: >- This radar has already been deactivated and is in the grace period. timestamp: '2026-04-23T17:05:26.000Z' error_id: f72ac8d3-4bca-4f4c-b14a-30af90e3eac2 '401': description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: status: error code: 401 message: Authentication required errors: - field: x-api-key reason: Missing or invalid API key timestamp: '2026-04-23T17:05:26.000Z' error_id: f72ac8d3-4bca-4f4c-b14a-30af90e3eac2 '403': description: Forbidden - Insufficient permissions content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: status: error code: 403 message: Insufficient permissions errors: - field: user reason: You do not have permission to deactivate this radar timestamp: '2026-04-23T17:05:26.000Z' error_id: f72ac8d3-4bca-4f4c-b14a-30af90e3eac2 '404': description: Not Found content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: status: error code: 404 message: Radar not found errors: - field: radar_id reason: >- No radar found with the specified ID or you don't have access to it timestamp: '2026-04-23T17:05:26.000Z' error_id: f72ac8d3-4bca-4f4c-b14a-30af90e3eac2 '429': description: >- Rate limit exceeded — no operation was performed. Check `Retry-After` to know when to retry, or `X-RateLimit-Remaining` to know your current budget. headers: Retry-After: schema: type: integer description: Seconds until your budget is restored X-RateLimit-Limit: schema: type: integer description: Your per-minute budget for this endpoint X-RateLimit-Remaining: schema: type: integer description: Tokens remaining right now content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' examples: minute_limit: summary: Per-minute budget exhausted value: status: error code: 429 message: Per-minute rate limit exceeded. Retry after 45 seconds. errors: - field: rate_limit reason: minute timestamp: '2026-04-23T17:05:26.000Z' error_id: f72ac8d3-4bca-4f4c-b14a-30af90e3eac2 burst_limit: summary: Per-second burst limit hit value: status: error code: 429 message: Per-second burst limit exceeded. Retry after 1 second. errors: - field: rate_limit reason: burst timestamp: '2026-04-23T17:05:26.000Z' error_id: f72ac8d3-4bca-4f4c-b14a-30af90e3eac2 '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' example: status: error code: 500 message: An internal server error occurred. errors: [] timestamp: '2026-04-23T17:05:26.000Z' error_id: f72ac8d3-4bca-4f4c-b14a-30af90e3eac2 security: - ApiKeyAuth: [] components: schemas: ErrorResponse: type: object required: - status - code - message - errors - timestamp - error_id properties: status: type: string enum: - error code: type: integer enum: - 400 - 401 - 402 - 403 - 404 - 409 - 429 - 500 - 503 message: type: string errors: type: array items: type: object required: - field - reason properties: field: type: string reason: type: string timestamp: type: string format: date-time error_id: type: string format: uuid securitySchemes: ApiKeyAuth: type: apiKey in: header name: x-api-key ````