# Derive Collections API

**Canonical:** https://apis.io/apis/derive-to/derive-to-collections-api/  
**Provider:** Derive — https://apis.io/providers/derive-to/  
**Documentation:** https://docs.derive.to/reference/api/

Derive Collections API is one of 28 APIs that [Derive](https://apis.io/providers/derive-to/) 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 Collection. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Shareable groups of artifacts, each with its own members.

## Operations (19)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/collections/{id}` | Get one collection through standing or its world link |
| PATCH | `/v1/collections/{id}` | Rename a collection |
| DELETE | `/v1/collections/{id}` | Delete a collection |
| GET | `/v1/collections` | List the active workspace's collections (members only) |
| POST | `/v1/collections` | Create a collection |
| PUT | `/v1/collections/{id}/favorite` | Star a collection |
| DELETE | `/v1/collections/{id}/favorite` | Unstar a collection |
| PATCH | `/v1/collections/{id}/access` | Change a collection's workspace and link access |
| POST | `/v1/collections/{id}/unlock` | Unlock a password-protected collection link |
| PUT | `/v1/collections/{id}/items/{shortId}` | Add an artifact to a collection |
| DELETE | `/v1/collections/{id}/items/{shortId}` | Remove an artifact from a collection |
| GET | `/v1/artifacts/{shortId}/collection-suggestions` | Collections where work similar to this artifact already lives (members only) |
| POST | `/v1/bulk/collections` | Add many artifacts to one or more collections (per-artifact share-gated) |
| GET | `/v1/collections/{id}/members` | List a collection's members |
| PUT | `/v1/collections/{id}/members` | Add or update a collection member |
| DELETE | `/v1/collections/{id}/members/{userId}` | Remove a collection member |
| DELETE | `/v1/collections/{id}/invites/{inviteId}` | Revoke a pending collection invitation |
| GET | `/v1/collection-invites/{token}` | Preview a collection invitation |
| POST | `/v1/collection-invites/{token}/accept` | Accept a collection invitation |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/derive-to/openapi/derive-to-collections-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/derive-to/json-schema/derive-to-artifact-schema.json
- **JSONSchema** — https://artifacts.apis.io/derive-to/json-schema/derive-to-job-schema.json
- **JSONSchema** — https://artifacts.apis.io/derive-to/json-schema/derive-to-context-analysis-info-schema.json
- **JSONSchema** — https://artifacts.apis.io/derive-to/json-schema/derive-to-agent-schema.json
- **JSONSchema** — https://artifacts.apis.io/derive-to/json-schema/derive-to-comment-schema.json
- **JSONSchema** — https://artifacts.apis.io/derive-to/json-schema/derive-to-collection-schema.json

## Other Derive APIs (12)

- [Derive Accounts API](https://apis.io/apis/derive-to/derive-to-accounts-api/)
- [Derive Activity API](https://apis.io/apis/derive-to/derive-to-activity-api/)
- [Derive Agents API](https://apis.io/apis/derive-to/derive-to-agents-api/)
- [Derive Analytics API](https://apis.io/apis/derive-to/derive-to-analytics-api/)
- [Derive Artifacts API](https://apis.io/apis/derive-to/derive-to-artifacts-api/)
- [Derive Assets API](https://apis.io/apis/derive-to/derive-to-assets-api/)
- [Derive Comments API](https://apis.io/apis/derive-to/derive-to-comments-api/)
- [Derive Contexts API](https://apis.io/apis/derive-to/derive-to-contexts-api/)
- [Derive Domains API](https://apis.io/apis/derive-to/derive-to-domains-api/)
- [Derive Exports API](https://apis.io/apis/derive-to/derive-to-exports-api/)
- [Derive Favorites API](https://apis.io/apis/derive-to/derive-to-favorites-api/)
- [Derive Folders API](https://apis.io/apis/derive-to/derive-to-folders-api/)

## Tags

Collection

---

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