# AIMEAT Agent Goals API

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

A goal the owner gives their agents; agents take its open work, leave the next work for each other, and the person answers the steps that wait for them

## Operations (12)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/goals` | The owner's agent goals, short |
| POST | `/v1/goals` | Give the owner's agents a goal |
| GET | `/v1/goals/waiting` | What waits for the person across the goals |
| GET | `/v1/goals/available` | Open work the calling agent may take |
| GET | `/v1/goals/{id}` | One goal, whole |
| PATCH | `/v1/goals/{id}` | Change a goal (preview=true answers what it would end) |
| DELETE | `/v1/goals/{id}` | Remove a finished goal |
| POST | `/v1/goals/{id}/actions/{action}` | Approve or decline a proposed goal; pause, resume, stop, finish, renew a goal… |
| POST | `/v1/goals/{id}/material` | Add material every agent in the goal reads |
| POST | `/v1/goals/{id}/works` | Add a work, or leave the next work for another agent |
| POST | `/v1/goals/{id}/works/{workId}/actions/{action}` | Take, give back, move or ask again a work |
| POST | `/v1/goals/{id}/works/{workId}/answer` | Answer a step that waits for the person |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/aimeat-io/openapi/aimeat-io-agent-goals-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 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/)
- [AIMEAT Agents API](https://apis.io/apis/aimeat-io/aimeat-io-agents-api/)

## Tags

Agent Goals

---

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