# AIMEAT Companies API

**Canonical:** https://apis.io/apis/aimeat-io/aimeat-io-companies-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 Companies 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 Companies. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

The company registry — a company is a first-class entity like an app, and registering one claims {slug}.co.<apex> as its address

## Operations (16)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/companies/sendable` | The companies this caller may send AS, and from which address |
| GET | `/v1/companies` | List the companies you have registered |
| POST | `/v1/companies` | Register a company (claims {slug}.co.) |
| GET | `/v1/companies/available` | Is a company address free? |
| GET | `/v1/companies/{id}` | Read one company |
| PUT | `/v1/companies/{id}` | Update a company's name and legal identity |
| DELETE | `/v1/companies/{id}` | Delete a company (frees its address) |
| GET | `/v1/companies/{id}/portfolio` | Whether the company has a page published |
| PUT | `/v1/companies/{id}/portfolio` | Publish the company's own HTML page |
| DELETE | `/v1/companies/{id}/portfolio` | Remove the company's page |
| GET | `/v1/companies/{id}/smtp` | Read the company's own sending identity |
| PUT | `/v1/companies/{id}/smtp` | Store the company's own sending identity |
| DELETE | `/v1/companies/{id}/smtp` | Remove the company's sending identity |
| GET | `/v1/companies/{id}/front-page/check` | Does the company's public face answer? |
| PUT | `/v1/companies/{id}/front-page` | Set what the company address serves, and who may open it |
| POST | `/v1/companies/{id}/open` | The address that opens a company front page needing a sign-in |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/aimeat-io/openapi/aimeat-io-companies-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

Companies

---

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