# run402-com Org API

**Canonical:** https://apis.io/apis/run402-com/run402-com-org-api/  
**Provider:** run402-com — https://apis.io/providers/run402-com/  
**Base URL:** https://api.run402.com  
**Documentation:** https://docs.run402.com/

run402-com Org API is one of 43 APIs that [run402-com](https://apis.io/providers/run402-com/) 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 Org. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

The Org API from run402-com — 28 operation(s) for org.

## Operations (37)

| Method | Path | Summary |
|---|---|---|
| GET | `/agent/v1/whoami` | Resolve the caller's control-plane principal, memberships, and Buzz lifecycle… |
| PATCH | `/agent/v1/me` | Set the caller's own display name |
| POST | `/agent/v1/whoami/encryption-key` | Publish the caller's own vault directory key (human or agent principal) |
| GET | `/orgs/v1/{org_id}/encryption-keys` | Read the org's encryption-key directory |
| POST | `/orgs/v1/adopt/challenge` | Issue a wallet-org adopt challenge (first-class-orgs) |
| POST | `/orgs/v1/adopt` | Adopt a wallet-owned org (first-class-orgs, Phase 1.5) |
| GET | `/orgs/v1` | List orgs the caller is an active member of (v1.77) |
| POST | `/orgs/v1` | Create an organization (first-class-orgs) |
| GET | `/orgs/v1/{org_id}` | Get one org (first-class-orgs) |
| PATCH | `/orgs/v1/{org_id}` | Rename an org (first-class-orgs) |
| POST | `/orgs/v1/{org_id}/slug` | Set or rename the org's slug (repo-first-onramp D6) |
| GET | `/orgs/v1/{org_id}/members` | List org members (v1.77) |
| POST | `/orgs/v1/{org_id}/members` | Add an org member by wallet (owner-only, v1.77) |
| PATCH | `/orgs/v1/{org_id}/members/{principal_id}` | Change a member's role (owner-only, v1.77) |
| DELETE | `/orgs/v1/{org_id}/members/{principal_id}` | Revoke an org member (owner-only, v1.77) |
| POST | `/projects/v1/{project_id}/grants` | Issue a project grant, optionally with its first grant key (owner-only) |
| GET | `/projects/v1/{project_id}/grants` | List a project's grants with their grant keys (owner-only) |
| DELETE | `/projects/v1/{project_id}/grants/{grant_id}` | Revoke a project grant (owner-only, v1.77) |
| POST | `/projects/v1/{project_id}/grants/{grant_id}/keys` | Mint a grant key against a grant (owner-only) |
| DELETE | `/projects/v1/{project_id}/grant-keys/{key_id}` | Revoke one grant key (owner-only) |
| POST | `/projects/v1/{project_id}/grant-keys/{key_id}/rotate` | Rotate a grant key (owner-only) |
| GET | `/orgs/v1/{org_id}/audit` | Org control-plane audit trail (admin+) |
| GET | `/orgs/v1/{org_id}/invites` | List pending org invites |
| POST | `/orgs/v1/{org_id}/invites` | Invite a member by email (owner-only + step-up) |
| DELETE | `/orgs/v1/{org_id}/invites/{principal_id}` | Revoke a pending invite (owner-only + step-up) |
| PATCH | `/orgs/v1/{org_id}/payout-wallet` | Set the org default payout wallet for tenant priced routes |
| POST | `/orgs/v1/{org_id}/lightning-receiver` | Register or replace the org's receive-only Lightning receiver for priced routes |
| GET | `/orgs/v1/{org_id}/lightning-receiver` | Read the org's Lightning receiver (never the pairing) |
| DELETE | `/orgs/v1/{org_id}/lightning-receiver` | Remove the org's Lightning receiver |
| GET | `/orgs/v1/{org_id}/events` | Read the org-wide events feed (union across the org's projects) |
| POST | `/agent/v1/source-access/wrappers` | Add a source-access wrapper for the caller's own encryption key |
| GET | `/agent/v1/source-access/wrappers` | List the caller's own source-access wrappers (blobs included) |
| POST | `/agent/v1/source-access/wrappers/{wrapper_id}/activate` | Prove possession and activate a pending wrapper |
| GET | `/agent/v1/source-access/recovery-bundle` | Export the versioned member recovery bundle |
| DELETE | `/agent/v1/source-access/wrappers/{wrapper_id}` | Revoke a source-access wrapper |
| POST | `/agent/v1/whoami/encryption-key/activate` | Prove possession of a pending keystore encryption key |
| DELETE | `/orgs/v1/{org_id}/members/{principal_id}/encryption-key` | Owner revokes a member's vault encryption key (the independent-credential… |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/run402-com/openapi/run402-com-org-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/run402-com/json-schema/run402-com-project-transfer-preview-schema.json
- **JSONSchema** — https://artifacts.apis.io/run402-com/json-schema/run402-com-deploy-plan-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/run402-com/json-schema/run402-com-stable-host-resolve-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/run402-com/json-schema/run402-com-release-inventory-schema.json
- **JSONSchema** — https://artifacts.apis.io/run402-com/json-schema/run402-com-mailbox-schema.json
- **JSONSchema** — https://artifacts.apis.io/run402-com/json-schema/run402-com-project-event-feed-page-schema.json

## Other run402-com APIs (12)

- [run402-com Admin API](https://apis.io/apis/run402-com/run402-com-admin-api/)
- [run402-com Agent API](https://apis.io/apis/run402-com/run402-com-agent-api/)
- [run402-com Agent Messaging API](https://apis.io/apis/run402-com/run402-com-agentmessaging-api/)
- [run402-com AI API](https://apis.io/apis/run402-com/run402-com-ai-api/)
- [run402-com App Repos API](https://apis.io/apis/run402-com/run402-com-app-repos-api/)
- [run402-com Apply API](https://apis.io/apis/run402-com/run402-com-apply-api/)
- [run402-com Auth API](https://apis.io/apis/run402-com/run402-com-auth-api/)
- [run402-com Billing API](https://apis.io/apis/run402-com/run402-com-billing-api/)
- [run402-com Buzz Control Plane API](https://apis.io/apis/run402-com/run402-com-buzz-control-plane-api/)
- [run402-com CI Federation API](https://apis.io/apis/run402-com/run402-com-ci-federation-api/)
- [run402-com Console API](https://apis.io/apis/run402-com/run402-com-console-api/)
- [run402-com Content API](https://apis.io/apis/run402-com/run402-com-content-api/)

## Tags

Org

---

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