canonical: https://jentic.com/apis/amazonaws.com/aws-mobile

# AWS Mobile

Jentic publishes the only available OpenAPI specification for AWS Mobile, keeping it validated and agent-ready. AWS Mobile Hub provisions and configures the AWS resources required to back a mobile app - identity pools, analytics, push messaging, storage, APIs and bot connectors - and packages SDK bundles that ship those resources to a developer desktop. Through the Mobile API, agents can create projects, list their backing resources, fetch a snapshot, request platform-specific bundles (iOS, Android, JavaScript) and tear down a project once it is no longer needed. The service is region-scoped and access is controlled with AWS SigV4 (hmac) credentials.

## For AI agents

Programmatically create and tear down AWS Mobile Hub projects, list configured backend resources, and download platform-specific SDK bundles for iOS, Android, and JavaScript.

## Scope

Does not handle mobile push delivery, in-app analytics events, or device testing - use for provisioning and tearing down AWS Mobile Hub backend projects and SDK bundles only.

## Capabilities

- Create a mobile backend project that wires together Cognito, S3, Lambda, API Gateway, and Pinpoint resources from a single descriptor
- List existing Mobile Hub projects in a region and inspect their attached resources
- Fetch a project snapshot to see which backend services and ARNs are currently provisioned
- Generate and download an SDK bundle scoped to a specific project for iOS Swift, Android, or JavaScript targets
- Export a project YAML to clone its backend configuration into another region or account
- Delete a Mobile Hub project and its tracked backend resources in a single call

## Use cases

### Provision a Mobile App Backend From a Project Descriptor

Front-end teams that need a backend wired up - auth, storage, analytics and push - can have an agent create a Mobile Hub project that provisions Cognito identity pools, S3 buckets, Pinpoint apps and Lambda integrations from a single project descriptor. The CreateProject endpoint accepts a YAML or JSON contents block and returns the project identifier, removing the need to click through the AWS console to wire each service up by hand.

Example prompt: Call POST /projects with a project name and a YAML contents block defining Cognito and Pinpoint resources, then return the projectId from the response

### Distribute SDK Bundles To Mobile App Developers

Once a Mobile Hub project exists, mobile developers need the configured SDK to talk to those backend resources. An agent can list available bundles, then call ExportBundle scoped to a projectId and a target platform (iOS Swift, Android, JavaScript) to retrieve a download URL for a zipped SDK pre-wired with the project's resource ARNs and pool IDs. This removes the manual config-file step that mobile teams typically copy from the console.

Example prompt: List bundles via GET /bundles, then call POST /bundles/{bundleId} with platform=IOS_SWIFT and projectId to fetch a downloadUrl for the SDK archive

### Audit and Tear Down Stale Mobile Backends

Cost and security reviews require visibility into which Mobile Hub projects still exist and what backend resources they hold. An agent can enumerate every project with ListProjects, fetch the resource snapshot for each with DescribeProject, and call DeleteProject on stale ones to reclaim Cognito pools, S3 buckets and Pinpoint apps. The flow is fully API-driven and avoids the per-resource cleanup that an agent would otherwise have to script across several AWS services.

Example prompt: Call GET /projects to list project summaries, then for each older than a threshold call GET /project#projectId followed by DELETE /projects/{projectId}

### AI Agent Integration for Mobile Backend Lifecycle

Through Jentic, an AI coding agent can manage the full lifecycle of an AWS Mobile Hub project - create, describe, export, bundle, and delete - without browsing the AWS console or the boto3 reference. Jentic resolves natural-language intents like 'set up a mobile backend for an iOS chat app' to the right Mobile Hub operation, hands the agent the input schema, and brokers SigV4 credentials so raw AWS keys never enter the agent's context.

Example prompt: Resolve the intent 'create a mobile backend project' via Jentic search, load the CreateProject schema, and execute it with a project name and contents descriptor

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | /projects | Create a Mobile Hub project from a descriptor |
| GET | /projects | List all Mobile Hub projects in the account |
| GET | /project#projectId | Describe a project's resources |
| DELETE | /projects/{projectId} | Delete a Mobile Hub project |
| GET | /bundles | List available SDK bundles |
| POST | /bundles/{bundleId} | Generate a downloadable SDK bundle for a project |
| POST | /exports/{projectId} | Export a project's YAML configuration |

## Key resources

- **Projects** — Create, describe, list, update, and delete Mobile Hub projects
- **Bundles** — List downloadable SDK bundles and export project-scoped bundles for iOS, Android, and JavaScript
- **Exports** — Export a project's YAML configuration for cloning or version control

## Why Jentic

- **Setup:** Wiring AWS Mobile by hand means implementing Signature Version 4 signing, resolving the regional mobile host, and managing the project and bundle lifecycle yourself. Through Jentic you install once, import AWS Mobile from the API Directory, store the AWS keys once, and your agent calls it.
- **Permission scoping:** AWS Mobile puts the project id in the URL path (/projects/{projectId}) and bundle id in /bundles/{bundleId}, so a rule can pin your agent to one project: it can read and export that project and nothing else. You choose the operations it may call, so DeleteProject is not included unless you add it.
- **Credential handling:** Your AWS access keys are stored once, encrypted, by your own Jentic One instance and each request is signed with Signature Version 4 at execution time. They never enter the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'create a Mobile Hub project' or 'export an SDK bundle', and Jentic returns the matching AWS Mobile operation with its input schema, so the agent calls CreateProject or ExportBundle without browsing the reference docs.

## Related APIs

- **AWS Amplify** — AWS Amplify is the modern successor for hosting and provisioning mobile and web app backends
- **AWS Amplify Backend** — Amplify Backend manages the backend resources behind an Amplify-built mobile or web app
- **Amazon Cognito Identity** — Cognito Identity provides the user identity and federated auth that Mobile Hub projects wire into mobile clients
- **AWS Device Farm** — Device Farm runs automated tests against the resulting mobile app on real devices

## FAQ

### Why is there no official OpenAPI spec for AWS Mobile?

AWS does not publish an OpenAPI specification. Jentic generates and maintains this spec so that AI agents and developers can call AWS Mobile via structured tooling. It is validated against the live API and kept up to date. Get started with Jentic One, the self-hosted execution layer.

### What authentication does the AWS Mobile API use?

AWS Mobile uses AWS Signature Version 4 (hmac) signing with an access key ID and secret access key scoped by IAM. Through Jentic, those AWS credentials are stored in your Jentic One instance and used to sign requests on the agent's behalf - the raw access key never enters the agent's context.

### Can I create a full mobile backend with one API call using AWS Mobile?

Yes. POST /projects accepts a contents block (YAML or JSON) describing Cognito identity, S3 storage, Pinpoint analytics and other backend services, and Mobile Hub provisions the underlying resources and returns a projectId. You then call POST /bundles/{bundleId} with that projectId to fetch a platform-specific SDK archive.

### What are the rate limits for the AWS Mobile API?

AWS Mobile inherits standard AWS service throttling - quotas are per-account and per-region, and 429 responses include a retry-after hint. Specific TPS limits are not published in the spec; treat throttling as an expected error and apply exponential backoff.

### How do I generate an Android SDK bundle through Jentic?

Use the Jentic search query 'generate a Mobile Hub SDK bundle', load the operation behind POST /bundles/{bundleId}, and execute it with platform=ANDROID and your projectId. Jentic returns the downloadUrl from the response so the agent can fetch the SDK archive in a follow-up step.

### Is AWS Mobile being deprecated?

AWS has positioned AWS Amplify as the successor for new mobile and web app backends. AWS Mobile Hub is still callable for existing projects, but for greenfield work consider the Amplify or Amplify Backend APIs (also in the Jentic API Directory) for newer features and ongoing investment.

### Can I limit what my agent is allowed to do with the AWS Mobile API?

Yes. Jentic One is self-hosted, so your own rules decide which AWS Mobile operations and credentials your agent may use. Because the project id sits in the URL path (/projects/{projectId}) and the bundle id in /bundles/{bundleId}, you can pin the agent to a single project so it only describes and exports that one and touches nothing else. You choose the operations it may call, so a destructive call like DeleteProject is available only if you explicitly add it.