# AutoGPT V1 API

**Canonical:** https://apis.io/apis/autogpt/autogpt-v1-api/  
**Provider:** AutoGPT — https://apis.io/providers/autogpt/  
**Base URL:** https://backend.agpt.co/external-api  
**Documentation:** https://agpt.co/docs/platform/api-and-integrations/api-guide

AutoGPT V1 API is one of 21 APIs that [AutoGPT](https://apis.io/providers/autogpt/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include v1. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and an API reference.

The v1 API from AutoGPT — 77 operation(s) for v1.

## Operations (60 of 95)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/api-keys` | List user API keys |
| POST | `/api/api-keys` | Create new API key |
| DELETE | `/api/api-keys/{key_id}` | Revoke API key |
| GET | `/api/api-keys/{key_id}` | Get specific API key |
| PUT | `/api/api-keys/{key_id}/permissions` | Update key permissions |
| POST | `/api/api-keys/{key_id}/suspend` | Suspend API key |
| POST | `/api/auth/user` | Get or create user |
| POST | `/api/auth/user/email` | Update user email |
| GET | `/api/auth/user/preferences` | Get notification preferences |
| POST | `/api/auth/user/preferences` | Update notification preferences |
| POST | `/api/auth/user/preferences/from-email` | Apply a volume-knob choice from a Briefing footer link |
| GET | `/api/auth/user/timezone` | Get user timezone |
| POST | `/api/auth/user/timezone` | Update user timezone |
| GET | `/api/blocks` | List available blocks |
| POST | `/api/blocks/{block_id}/execute` | Execute graph block |
| GET | `/api/credits` | Get user credits |
| PATCH | `/api/credits` | Fulfill checkout session |
| POST | `/api/credits` | Request credit top up |
| GET | `/api/credits/auto-top-up` | Get auto top up |
| POST | `/api/credits/auto-top-up` | Configure auto top up |
| GET | `/api/credits/invoices` | List Stripe invoices |
| GET | `/api/credits/manage` | Manage payment methods |
| GET | `/api/credits/refunds` | Get refund requests |
| POST | `/api/credits/stripe_webhook` | Handle Stripe webhooks |
| GET | `/api/credits/subscription` | Get subscription tier, current cost, and all tier costs |
| POST | `/api/credits/subscription` | Update subscription tier or start a Stripe Checkout session |
| GET | `/api/credits/transactions` | Get credit history |
| POST | `/api/credits/{transaction_key}/refund` | Refund credit transaction |
| POST | `/api/email/` | Handle Postmark Email Webhooks |
| POST | `/api/email/unsubscribe` | One Click Email Unsubscribe |
| GET | `/api/executions` | List all executions |
| GET | `/api/executions/cost-summary` | User cost summary |
| DELETE | `/api/executions/{graph_exec_id}` | Delete graph execution |
| POST | `/api/files/upload` | Upload file to cloud storage |
| GET | `/api/graphs` | List user graphs |
| POST | `/api/graphs` | Create new graph |
| DELETE | `/api/graphs/{graph_id}` | Delete graph permanently |
| GET | `/api/graphs/{graph_id}` | Get specific graph |
| PUT | `/api/graphs/{graph_id}` | Update graph version |
| POST | `/api/graphs/{graph_id}/execute/{graph_version}` | Execute graph agent |
| GET | `/api/graphs/{graph_id}/executions` | List graph executions |
| GET | `/api/graphs/{graph_id}/executions/{graph_exec_id}` | Get execution details |
| DELETE | `/api/graphs/{graph_id}/executions/{graph_exec_id}/share` | Disable Execution Sharing |
| POST | `/api/graphs/{graph_id}/executions/{graph_exec_id}/share` | Enable Execution Sharing |
| POST | `/api/graphs/{graph_id}/executions/{graph_exec_id}/stop` | Stop graph execution |
| GET | `/api/graphs/{graph_id}/schedules` | List execution schedules for a graph |
| POST | `/api/graphs/{graph_id}/schedules` | Create execution schedule |
| PATCH | `/api/graphs/{graph_id}/settings` | Update graph settings |
| GET | `/api/graphs/{graph_id}/versions` | Get all graph versions |
| PUT | `/api/graphs/{graph_id}/versions/active` | Set active graph version |
| GET | `/api/graphs/{graph_id}/versions/{version}` | Get graph version |
| GET | `/api/integrations/ayrshare/sso_url` | Get Ayrshare Sso Url |
| GET | `/api/integrations/codex/credentials/{credential_id}/account` | Codex Account |
| GET | `/api/integrations/codex/credentials/{credential_id}/rate-limits` | Codex Rate Limits |
| GET | `/api/integrations/credentials` | List Credentials |
| GET | `/api/integrations/providers` | List Providers |
| GET | `/api/integrations/providers/constants` | Get Provider Constants |
| GET | `/api/integrations/providers/enum-example` | Get Provider Enum Example |
| GET | `/api/integrations/providers/names` | Get Provider Names |
| GET | `/api/integrations/providers/system` | List System Providers |

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

## Machine-readable artifacts (5)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/autogpt/refs/heads/main/openapi/autogpt-v1-api-openapi.yml
- **Documentation** — https://agpt.co/docs/platform/api-and-integrations/api-guide
- **APIReference** — https://backend.agpt.co/external-api/docs
- **Sandbox** — https://raw.githubusercontent.com/api-evangelist/autogpt/refs/heads/main/sandbox/autogpt-sandbox.yml
- **Documentation** — https://agpt.co/docs

## Other AutoGPT APIs (12)

- [AutoGPT Analytics API](https://apis.io/apis/autogpt/autogpt-analytics-api/)
- [AutoGPT Auth Email API](https://apis.io/apis/autogpt/autogpt-auth-email-api/)
- [AutoGPT Blocks API](https://apis.io/apis/autogpt/autogpt-blocks-api/)
- [AutoGPT Briefings API](https://apis.io/apis/autogpt/autogpt-briefings-api/)
- [AutoGPT Copilot Webhooks API](https://apis.io/apis/autogpt/autogpt-copilot-webhooks-api/)
- [AutoGPT Graphs API](https://apis.io/apis/autogpt/autogpt-graphs-api/)
- [AutoGPT Health API](https://apis.io/apis/autogpt/autogpt-health-api/)
- [AutoGPT Home API](https://apis.io/apis/autogpt/autogpt-home-api/)
- [AutoGPT Integrations API](https://apis.io/apis/autogpt/autogpt-integrations-api/)
- [AutoGPT Meta API](https://apis.io/apis/autogpt/autogpt-meta-api/)
- [AutoGPT Monitoring API](https://apis.io/apis/autogpt/autogpt-monitoring-api/)
- [AutoGPT Platform Linking API](https://apis.io/apis/autogpt/autogpt-platform-linking-api/)

## Tags

v1

---

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