# AIMEAT Organisms API

**Canonical:** https://apis.io/apis/aimeat-io/aimeat-io-organisms-api/  
**Provider:** AIMEAT — https://apis.io/providers/aimeat-io/  
**Base URL:** https://aimeat-finland-001-genesis.overscalesolutions.com  
**Documentation:** https://aimeat.io/v1/spec

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

Phase 2.2 — Group entities (clubs, teams, communities)

## Operations (60 of 103)

| Method | Path | Summary |
|---|---|---|
| POST | `/v1/organisms` | Create an organism |
| GET | `/v1/organisms` | List organisms |
| GET | `/v1/organisms/{id}` | Get organism detail |
| PUT | `/v1/organisms/{id}` | Update organism |
| DELETE | `/v1/organisms/{id}` | Delete organism |
| POST | `/v1/organisms/{id}/join` | Join an organism |
| POST | `/v1/organisms/{id}/leave` | Leave an organism |
| GET | `/v1/organisms/{id}/members` | List organism members |
| POST | `/v1/organisms/{id}/members` | Directly add a member to an organism |
| GET | `/v1/organisms/{id}/workspace` | Read an organism's manifest-driven workspace |
| DELETE | `/v1/organisms/{id}/workspace` | Delete an organism's workspace (manifest + all data + schemas) |
| PUT | `/v1/organisms/{id}/workspace` | Update a workspace's definition in place (name/readme/structure/schemas/apps) |
| POST | `/v1/organisms/{id}/workspace/spaces` | Add spaces to a workspace as a member, under the workspace's rule |
| POST | `/v1/organisms/{id}/workspace/spaces/{space}/extensions` | Name an installed extension of your own account on one space of a workspace |
| PUT | `/v1/organisms/{id}/workspace/sections/{space}` | Set a document space's section index as a member, under the workspace's rule |
| GET | `/v1/organisms/{id}/workspace/suggestions` | The member suggestions a caller may see |
| POST | `/v1/organisms/{id}/workspace/suggestions/{sid}` | Approve or decline a member's suggestion |
| GET | `/v1/organisms/{id}/instruction-block` | Paste-into-your-AI instruction block for one organism (3 formats) |
| GET | `/v1/organisms/{id}/overview` | OKF-style structure overview of a whole organism (Markdown) |
| GET | `/v1/organisms/{id}/workspace/index` | A workspace's index (titles, no bodies), or the full values of named records |
| POST | `/v1/organisms/{id}/workspace/drafts` | Write one draft, or a batch of drafts, into a workspace |
| GET | `/v1/organisms/{id}/workspace/overview` | OKF-style structure overview of ONE workspace (Markdown) |
| GET | `/v1/organisms/{id}/graph` | Structured graph of an organism (for the interactive mindmap) |
| GET | `/v1/organisms/{id}/workspace/graph` | Structured graph of ONE workspace (for the interactive mindmap) |
| GET | `/v1/organisms/{id}/workspace/dangling-refs` | Referential-integrity scan (dangling reference detection) |
| GET | `/v1/organisms/{id}/structure/history` | Organism structure timeline (how its shape grew over time) |
| GET | `/v1/organisms/{id}/workspaces` | Discover every workspace in an organism (membership-gated) |
| GET | `/v1/organisms/{id}/workspace-access` | List access requests for a workspace you created (or all your workspaces) |
| POST | `/v1/organisms/{id}/workspace-access` | Request access to a workspace |
| POST | `/v1/organisms/{id}/workspace-access/decision` | Approve or deny a workspace access request |
| POST | `/v1/organisms/{id}/workspace-access/grant` | Directly grant an existing member a workspace role (no prior request) |
| POST | `/v1/organisms/{id}/workspace-access/revoke` | Remove a member's workspace role |
| GET | `/v1/organisms/{id}/workspace/engagements` | List a workspace's contract engagements (active + retired) |
| POST | `/v1/organisms/{id}/workspace/engagements` | Adopt (activate) a contract engagement for one of your agents |
| POST | `/v1/organisms/{id}/workspace/engagements/retire` | Retire a contract engagement (real off-switch) |
| GET | `/v1/organisms/{id}/workspace/export` | Download a full-fidelity ZIP backup of a workspace |
| POST | `/v1/organisms/{id}/workspace/records/publish` | Publish many workspace record drafts in one request |
| POST | `/v1/organisms/{id}/workspace/records/delete` | Delete many workspace records in one request |
| POST | `/v1/organisms/{id}/workspace/import` | Import a workspace ZIP as a new workspace |
| GET | `/v1/organisms/{id}/workspace/share` | Read a workspace's document-space public-sharing state |
| PUT | `/v1/organisms/{id}/workspace/share` | Set a workspace's document-space public-sharing state |
| POST | `/v1/organisms/{id}/workspace/share/unlock` | Exchange a share password for a share token (NO AUTH) |
| GET | `/v1/organisms/{id}/workspace/public/documents` | Read a workspace's public document-space pages (NO AUTH) |
| GET | `/v1/organisms/{id}/workspace/public/document` | Read a single public document-space page (NO AUTH) |
| GET | `/v1/organisms/{id}/workspace/public/records` | Read a workspace's public records-space entries (NO AUTH) |
| GET | `/v1/organisms/{id}/workspace/records` | Read a workspace's published records as an authorized member |
| POST | `/v1/organisms/{id}/workspace/rows/{space}` | Append rows to a workspace row space |
| GET | `/v1/organisms/{id}/workspace/rows/{space}` | Read one page of a workspace row space |
| DELETE | `/v1/organisms/{id}/workspace/rows/{space}` | Retention delete by age |
| GET | `/v1/organisms/{id}/workspace/rows/{space}/stats` | What a row space holds, without reading a row |
| GET | `/v1/organisms/{id}/workspace/rows/{space}/{rowId}` | Read one row by the id it was named with |
| DELETE | `/v1/organisms/{id}/workspace/rows/{space}/{rowId}` | Remove one row |
| GET | `/v1/organisms/{id}/workspace/rows/{space}/{rowId}/revisions` | A row's kept earlier contents |
| POST | `/v1/organisms/{id}/workspace/rows/{space}/{rowId}/revisions/{revisionId}/restore` | Put a kept revision back as a row's content |
| POST | `/v1/organisms/{id}/workspace/documents/{space}/{docId}/append` | Add markdown to a workspace document without resending it |
| POST | `/v1/organisms/{id}/workspace/documents/{space}/{docId}/frame` | The frame address of an HTML page, for a member |
| POST | `/v1/organisms/{id}/workspace/documents/{space}/{docId}/opened` | Record that a member opened a page today |
| POST | `/v1/organisms/{id}/workspace/documents/{space}/{docId}/section` | Replace one section of a workspace document |
| GET | `/v1/organisms/{id}/export` | Download a ZIP backup of a whole organism |
| POST | `/v1/organisms/import` | Import an organism bundle ZIP as a new organism |

…and 43 more operations. They are listed in full on the page.

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/aimeat-io/openapi/aimeat-io-organisms-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/aimeat-io/json-schema/aimeat-io-workflow-def-input-schema.json
- **JSONSchema** — https://artifacts.apis.io/aimeat-io/json-schema/aimeat-io-workflow-run-schema.json
- **JSONSchema** — https://artifacts.apis.io/aimeat-io/json-schema/aimeat-io-schedule-create-schema.json
- **JSONSchema** — https://artifacts.apis.io/aimeat-io/json-schema/aimeat-io-ai-provenance-declaration-schema.json
- **JSONSchema** — https://artifacts.apis.io/aimeat-io/json-schema/aimeat-io-app-summary-schema.json
- **JSONSchema** — https://artifacts.apis.io/aimeat-io/json-schema/aimeat-io-memory-write-schema.json

## Other AIMEAT APIs (12)

- [AIMEAT A2A API](https://apis.io/apis/aimeat-io/aimeat-io-a2a-api/)
- [AIMEAT Actions API](https://apis.io/apis/aimeat-io/aimeat-io-actions-api/)
- [AIMEAT Admin API](https://apis.io/apis/aimeat-io/aimeat-io-admin-api/)
- [AIMEAT Agent Crew API](https://apis.io/apis/aimeat-io/aimeat-io-agent-crew-api/)
- [AIMEAT Agent Directives API](https://apis.io/apis/aimeat-io/aimeat-io-agent-directives-api/)
- [AIMEAT Agent Goals API](https://apis.io/apis/aimeat-io/aimeat-io-agent-goals-api/)
- [AIMEAT Agent Integration API](https://apis.io/apis/aimeat-io/aimeat-io-agent-integration-api/)
- [AIMEAT Agent Messages API](https://apis.io/apis/aimeat-io/aimeat-io-agent-messages-api/)
- [AIMEAT Agent Onboarding API](https://apis.io/apis/aimeat-io/aimeat-io-agent-onboarding-api/)
- [AIMEAT Agent Tasks API](https://apis.io/apis/aimeat-io/aimeat-io-agent-tasks-api/)
- [AIMEAT Agent Telemetry API](https://apis.io/apis/aimeat-io/aimeat-io-agent-telemetry-api/)
- [AIMEAT Agent Webhooks API](https://apis.io/apis/aimeat-io/aimeat-io-agent-webhooks-api/)

## Tags

Organisms

---

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