# Firefly API

**Effective April 13, 2026, Firefly API v1 is officially deprecated and will be replaced by v2 to provide enhanced performance and security.**

## V2 API

**Base URL:** `https://api.firefly.ai/v2/`

All V2 API endpoints are relative to this base URL. Include this prefix when making requests to any of the services below.

The Firefly V2 API is organized into the following sections:

* [**Authentication**](/general-information/api/auth.md) - Manage API authentication and authorization
* [**Inventory**](/general-information/api/inventory.md) - Track and manage your infrastructure inventory
* [**Codification**](/general-information/api/codification.md) - Create IaC codification automation
* [**Workflows**](/general-information/api/workflows.md) - Create and manage automated workflows
* [**Policy & Governance**](/general-information/api/governance.md) - Implement and manage governance policies
* [**IaC Explorer**](/general-information/api/iac-explorer.md) - Explore and manage Infrastructure as Code
* [**Event Center**](/general-information/api/event-center.md) - Monitor and handle system events
* [**Backup & Disaster Recovery**](/general-information/api/backup-and-dr.md) - Manage backups and disaster recovery
* [**Integrations**](/general-information/api/integrations.md) - Connect with external services and tools
* [**Identity & Access Management**](/general-information/api/iam.md) - Manage users, teams, roles, and permissions
* [**Audit Log**](/general-information/api/audit-log.md) - Query activity logs and audit trails

## Rate Limiting

To ensure fair usage and platform stability, API requests are subject to rate limiting. Requests are aggregated based on the source IP address. A maximum of 500 requests is allowed within a rolling evaluation window of 1 minute (60 seconds). Requests that exceed this limit may be throttled or rejected until the window resets.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.firefly.ai/general-information/api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.