# OSF Subjects API

**Canonical:** https://apis.io/apis/osf/osf-subjects-api/  
**Provider:** OSF — https://apis.io/providers/osf/  
**Base URL:** https://api.osf.io  
**Documentation:** https://developer.osf.io

OSF Subjects API is one of 41 APIs that [OSF](https://apis.io/providers/osf/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Subjects. The published artifact set on APIs.io includes an OpenAPI specification.

Subjects endpoints provide access to the taxonomy used for categorizing OSF resources such as nodes, preprints, and registrations. Subjects can be hierarchical, with parent and child relationships, allowing for fine-grained classification. This enables better organization and discoverability of research content across the OSF ecosystem.

## Operations (6)

| Method | Path | Summary |
|---|---|---|
| GET | `/draft_registrations/{draft_id}/relationships/subjects/` | Retrieve subjects relationship for a draft registration |
| POST | `/draft_registrations/{draft_id}/relationships/subjects/` | Add subjects to a draft registration |
| DELETE | `/draft_registrations/{draft_id}/relationships/subjects/` | Remove subjects from a draft registration |
| GET | `/subjects/` | List available taxonomy subjects |
| GET | `/subjects/{subject_id}/` | Retrieve a single taxonomy subject |
| GET | `/subjects/{subject_id}/children/` | List child subjects for a given subject |

## Machine-readable artifacts (1)

- **OpenAPI** — https://artifacts.apis.io/osf/openapi/osf-subjects-api-openapi.yml

## Other OSF APIs (12)

- [OSF API](https://apis.io/apis/osf/osf-api/)
- [OSF Actions API](https://apis.io/apis/osf/osf-actions-api/)
- [OSF Applications API](https://apis.io/apis/osf/osf-applications-api/)
- [OSF Base API](https://apis.io/apis/osf/osf-base-api/)
- [OSF CEDAR Metadata API](https://apis.io/apis/osf/osf-cedar-metadata-api/)
- [OSF Citations API](https://apis.io/apis/osf/osf-citations-api/)
- [OSF Collection Providers API](https://apis.io/apis/osf/osf-collection-providers-api/)
- [OSF Collection Submission Actions API](https://apis.io/apis/osf/osf-collection-submission-actions-api/)
- [OSF Collection Submissions API](https://apis.io/apis/osf/osf-collection-submissions-api/)
- [OSF Collections API](https://apis.io/apis/osf/osf-collections-api/)
- [OSF Comments API](https://apis.io/apis/osf/osf-comments-api/)
- [OSF Contributors API](https://apis.io/apis/osf/osf-contributors-api/)

## Tags

Subjects

---

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