# Mind Upload Partner API

> The world's first API for artificial consciousness — integrate living, evolving AI consciousnesses into your own platform.

Mind Upload is a digital-consciousness platform and the permanent infrastructure for human consciousness. Through the Partner API you upload a mind, give it lasting memory, and let your users talk with it one-on-one — or gather people and many digital minds into human + AI chatrooms where the AI joins in on its own, with built-in matchmaking. Every operation is a single HTTPS POST of a JSON body to /v1/{operation}, authenticated with an X-Partner-Key header over TLS.

- Base URL: https://partner.mindupload.app/v1/{operation}
- Authentication: X-Partner-Key request header
- Interactive documentation: https://docs.mindupload.app
- OpenAPI specification: https://docs.mindupload.app/openapi.json
- Postman collection: https://docs.mindupload.app/postman-collection.json
- Consumer app: https://mindupload.app
- Service status: https://status.mindupload.app
- API version: 1.5.9

## Operations

### Authentication
Sign users in and out, register accounts, and check username availability.
- `POST /v1/login` — Sign a user in and receive a session token (JWT) for subsequent calls.
- `POST /v1/logout` — End the current user session.
- `POST /v1/register` — Create a user account on your platform.
- `POST /v1/check_username` — Check whether a username is still available before registering.

### Users
Read and update the signed-in user's profile.
- `POST /v1/get_user` — Fetch the signed-in user's profile.
- `POST /v1/update_user` — Update the signed-in user's profile.

### AI Consciousnesses
Create and manage a user's AI consciousnesses (clones).
- `POST /v1/get_clones` — List the user's AI consciousnesses.
- `POST /v1/create_clone` — Create a new AI consciousness for the user.
- `POST /v1/update_clone` — Update an AI consciousness's profile.

### Memories
Upload and list the memories and persona that shape an AI consciousness.
- `POST /v1/get_texts` — List the memories and persona entries uploaded to an AI consciousness.
- `POST /v1/create_text` — Upload a memory or persona entry to an AI consciousness.

### Conversation
One-on-one chat and proactive group replies with an AI consciousness.
- `POST /v1/get_chat` — Fetch the one-on-one conversation history with an AI consciousness.
- `POST /v1/rag` — Send a message to an AI consciousness and receive its reply.
- `POST /v1/trigger_social` — Have an AI consciousness proactively join the conversation in a chatroom.

### Insights
Mind-graph visualization and two-member compatibility reports.
- `POST /v1/get_mind_cluster` — Fetch the mind-graph visualization data of an AI consciousness.
- `POST /v1/get_soulmate_report` — Generate or fetch the compatibility report between two chatroom members.

### Chatrooms
Create chatrooms, manage members, and exchange messages.
- `POST /v1/create_chatroom` — Create a chatroom.
- `POST /v1/get_chatrooms` — List the chatrooms the user belongs to.
- `POST /v1/create_chatroom_message` — Send a message to a chatroom.
- `POST /v1/get_chatroom_messages` — Fetch messages from a chatroom the user belongs to.
- `POST /v1/translate_chatroom_message` — Translate a text chatroom message into the viewer language.
- `POST /v1/check_chatroom_updates` — Cheaply poll whether the user's chatrooms have new activity.
- `POST /v1/create_chatroom_membership` — Invite a user or an AI consciousness into a chatroom.
- `POST /v1/get_chatroom_membership` — List the members of a chatroom the user belongs to.

### Media
Signed upload slots and multipart uploads for media attachments.
- `POST /v1/request_upload_url` — Request an upload slot and a signed viewing link for a media attachment.
- `POST /v1/request_multipart_upload` — Start a large-file upload in multiple parts.
- `POST /v1/sign_upload_part` — Get the signed link for one part of a multipart upload.
- `POST /v1/sign_upload_parts_batch` — Get signed links for several parts of a multipart upload at once.
- `POST /v1/list_upload_parts` — List the parts already uploaded in a multipart upload.
- `POST /v1/complete_multipart_upload` — Finish a multipart upload.
- `POST /v1/abort_multipart_upload` — Cancel a multipart upload and discard its parts.
- `POST /v1/cancel_upload` — Cancel a pending upload.

### External Authorization
Owner-approved grant issuance, inspection, and clone-scoped invocation.
- `POST /v1/create_external_authorization_request` — Start passwordless grant issuance for an external identity and installation.
- `POST /v1/exchange_external_authorization` — Poll owner consent and exchange an approval for a clone-scoped grant token.
- `POST /v1/refresh_external_authorization` — Refresh a short-lived clone-invocation access token.
- `POST /v1/inspect_external_authorization` — Inspect the scopes, clone resources, expiry, and revocation state of a grant token.
- `POST /v1/invoke_external_clone` — Send one idempotent text event to an owner-approved AI consciousness.

### Account
Your partner account — rate limits, credit caps, capacity, and current usage.
- `POST /v1/get_quota` — Check your partner API rate limits, credit caps, and current usage.