# Derive Session API

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

Derive Session 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 Sessions. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Identity: the signed-in user, public profiles, and the people directory.

## Operations (14)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/me` | The signed-in user + their active-workspace role |
| GET | `/v1/me/github` | Whether a GitHub account is linked to the signed-in user |
| POST | `/v1/me/username` | Claim or change your @handle |
| POST | `/v1/me/profile` | Set your team role + one-line bio |
| POST | `/v1/me/discoverable` | Opt in/out of being findable in people search |
| POST | `/v1/me/onboarded` | Mark first-run onboarding finished (server-authoritative) |
| GET | `/v1/me/onboarding` | The signed-in user's activation signals (agent connected, first agent publish) |
| GET | `/v1/users/search` | Search opted-in accounts by handle or name |
| GET | `/v1/people` | Browse the people you work with (optionally filtered by ?query=) |
| GET | `/v1/users/{handle}` | A public profile by @handle (email never returned) |
| GET | `/v1/users/{handle}/artifacts` | A user's authored artifacts (keyset-paginated) |
| POST | `/v1/me/avatar` | Upload your profile picture (multipart; raster images only) |
| GET | `/v1/users` | The @mention directory: workspace people + agents (auth only) |
| GET | `/v1/bootstrap` | The signed-in boot payload: sidebar summary, collections, settings… |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/derive-to/openapi/derive-to-session-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 Collections API](https://apis.io/apis/derive-to/derive-to-collections-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/)

## Tags

Sessions

---

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