# Recorded Future ASI Project API

**Canonical:** https://apis.io/apis/recorded-future/asi-project/  
**Provider:** Recorded Future — https://apis.io/providers/recorded-future/  
**Base URL:** https://api.securitytrails.com/v2  
**Documentation:** https://docs.recordedfuture.com/reference/attack-surface-intelligence/llms.txt

Recorded Future ASI Project API is one of 25 APIs that [Recorded Future](https://apis.io/providers/recorded-future/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Threat Intelligence and Cybersecurity. The published artifact set on APIs.io includes an OpenAPI specification, an API reference, and 6 JSON Schemas.

The Attack Surface Intelligence (ASI) Project API is designed to allow you full-featured access to all of the `Assets` within all of the `Project`s as well as , most importantly, the `Exposures` that our system has identified on those assets, including proposed remediations. You can create new user-defined `Tags` and apply them to `Assets` either individually or in bulk. You can use either the GET-based listing endpoint to find assets or the /_search endpoint which accepts a more structured request and, in the future, will allow for even more complex boolean queries. Using it only requires a standard Security Trails API access key.

## Operations (18)

| Method | Path | Summary |
|---|---|---|
| GET | `/projects` | List Projects |
| GET | `/projects/{project_id}/assets` | Find Assets |
| POST | `/projects/{project_id}/assets/_search` | Search Assets |
| GET | `/projects/{project_id}/assets/{asset_id}` | Read Asset |
| GET | `/projects/{project_id}/assets/{asset_id}/exposures` | List Asset Exposures |
| POST | `/projects/{project_id}/assets/{asset_id}/tags` | Bulk Add Remove Asset Tags |
| PUT | `/projects/{project_id}/assets/{asset_id}/tags/{tag_name}` | Apply Tag To Asset |
| DELETE | `/projects/{project_id}/assets/{asset_id}/tags/{tag_name}` | Remove Tag From Asset |
| GET | `/projects/{project_id}/exposures` | List Exposures |
| GET | `/projects/{project_id}/exposures/{signature_id}` | Get Exposure Assets |
| POST | `/projects/{project_id}/filters` | Get Filters With Filter |
| GET | `/projects/{project_id}/filters` | Get Filters |
| POST | `/projects/{project_id}/rules/_bulk_static_assets` | Add Static Assets |
| GET | `/projects/{project_id}/rules/static_assets` | Get Static Assets |
| GET | `/projects/{project_id}/tags` | Get Tags |
| POST | `/projects/{project_id}/tags/_bulk_tag_assets` | Bulk Add Remove Assets |
| GET | `/projects/{project_id}/tags/_task_status/{task_id}` | Get Custom Tag Task Status |
| POST | `/projects/{project_id}/tags/{tag_name}` | Add Tag |

## Machine-readable artifacts (8)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/recorded-future/refs/heads/main/openapi/recorded-future-asi-project-api-openapi.yml
- **APIReference** — https://docs.recordedfuture.com/reference
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/recorded-future/refs/heads/main/json-schema/recorded-future-assets-filter-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/recorded-future/refs/heads/main/json-schema/recorded-future-asset-search-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/recorded-future/refs/heads/main/json-schema/recorded-future-filters-response-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/recorded-future/refs/heads/main/json-schema/recorded-future-bulk-tag-assets-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/recorded-future/refs/heads/main/json-schema/recorded-future-tag-asset-request-schema.json
- **JSONSchema** — https://raw.githubusercontent.com/api-evangelist/recorded-future/refs/heads/main/json-schema/recorded-future-update-static-assets-response-schema.json

## Other Recorded Future APIs (12)

- [Recorded Future Intelligence Cloud API](https://apis.io/apis/recorded-future/recorded-future-connect-api/)
- [Recorded Future Alert API](https://apis.io/apis/recorded-future/alert/)
- [Recorded Future Analyst Note API](https://apis.io/apis/recorded-future/analyst-note/)
- [Recorded Future Autonomous Threat Operations API](https://apis.io/apis/recorded-future/autonomous-threat-operations/)
- [Recorded Future Case](https://apis.io/apis/recorded-future/case/)
- [Recorded Future Collective Insights API](https://apis.io/apis/recorded-future/collective-insights/)
- [Recorded Future Common Platform Enumeration APIs V0](https://apis.io/apis/recorded-future/common-platform-enumeration-apis-v0/)
- [Recorded Future Customer APIs V0](https://apis.io/apis/recorded-future/customer-apis-v0/)
- [Recorded Future Customer APIs V2](https://apis.io/apis/recorded-future/customer-apis-v2/)
- [Recorded Future Detection Rule API](https://apis.io/apis/recorded-future/detection-rule/)
- [Recorded Future Detection Rule Relation API](https://apis.io/apis/recorded-future/detection-rule-relation/)
- [Recorded Future Entity Match API](https://apis.io/apis/recorded-future/entity-match/)

## Tags

Threat Intelligence, Cybersecurity

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/recorded-future/asi-project/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/recorded-future/.
