# Ecs API Reference

> Amazon ECS API specification reference. Use when implementing ECS-compatible APIs in KECS to accurately reproduce request/response structures, parameters, error codes, and behaviors. Reference for implementing APIs like CreateCluster, CreateService, RunTask, RegisterTaskDefinition. Use when this capability is needed.

- Skill: `tomevault-io/ecs-api-reference` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/ecs-api-reference`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/ecs-api-reference/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Integrations & APIs
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/ecs-api-reference

---


# Amazon ECS API Reference for KECS

Reference skill for implementing ECS-compatible APIs in KECS.

## Overview

This skill provides detailed specifications for the following ECS API categories:

1. **Cluster API** - Cluster management (`cluster-api.md`)
2. **Service API** - Service management (`service-api.md`)
3. **Task API** - Task execution and management (`task-api.md`)
4. **Task Definition API** - Task definition management (`task-definition-api.md`)
5. **Other APIs** - Tags, TaskSets, Attributes, Account Settings, etc. (`other-apis.md`)

## Use Cases

- Implementing new ECS API endpoints
- Verifying request/response structures of existing APIs
- Aligning error codes and behaviors with AWS ECS
- Writing API compatibility tests

## Common API Specifications

### HTTP Request Format
```
POST / HTTP/1.1
Host: ecs.{region}.amazonaws.com
Content-Type: application/x-amz-json-1.1
X-Amz-Target: AmazonEC2ContainerServiceV20141113.{ActionName}
```

### Common Error Codes
| Error | HTTP | Description |
|-------|------|-------------|
| ClientException | 400 | Client-side error (insufficient permissions, invalid ID, etc.) |
| InvalidParameterException | 400 | Invalid parameter |
| ServerException | 500 | Server error |
| ClusterNotFoundException | 400 | Cluster not found |
| ServiceNotFoundException | 400 | Service not found |

### Tag Limits
- Maximum 50 tags per resource
- Key length: Maximum 128 characters (UTF-8)
- Value length: Maximum 256 characters (UTF-8)
- `aws:` prefix is reserved (cannot edit or delete)

### Pagination
- maxResults: 1-100 (default 10 or 100 depending on API)
- nextToken: Opaque continuation token

### ARN Format
```
arn:aws:ecs:{region}:{account}:{resource-type}/{resource-id}
```
Resource types: cluster, service, task, task-definition, container-instance, capacity-provider, task-set

## Detailed Specifications

Refer to the following support files for detailed API specifications:

- `cluster-api.md` - CreateCluster, DescribeClusters, ListClusters, DeleteCluster, UpdateCluster
- `service-api.md` - CreateService, DescribeServices, UpdateService, DeleteService, ListServices
- `task-api.md` - RunTask, StopTask, DescribeTasks, ListTasks, ExecuteCommand
- `task-definition-api.md` - RegisterTaskDefinition, DeregisterTaskDefinition, DescribeTaskDefinition, ListTaskDefinitions
- `other-apis.md` - TagResource, ListTagsForResource, CreateTaskSet, PutAttributes, PutAccountSetting, etc.

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/nandemo-ya) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->