# run-api ## Pages - [Run API](https://docs.ezghcloud.com/run-api/index.md) — Run deploys a container image that serves HTTP on a port behind an HTTPS URL, scaled from zero by its requests. Every path is under an organization; lists are paged with limit, cursor and nextCursor. - [Create a service](https://docs.ezghcloud.com/run-api/CreateService/index.md) — Asynchronous: answers 202 with the operation that deploys its first revision; the service is deploying. - [Delete a retired revision](https://docs.ezghcloud.com/run-api/DeleteRevision/index.md) — Asynchronous: answers 202 with the operation. 409 for a revision that isn't retired. - [Delete a service](https://docs.ezghcloud.com/run-api/DeleteService/index.md) — Asynchronous: answers 202 with the operation that drains and deletes its sandboxes, revisions and Bot. A service a load balancer target group is bound to is 409 service_in_use until the target group is deleted. - [Get an operation (poll it until it finishes)](https://docs.ezghcloud.com/run-api/GetOperation/index.md) — While it's queued or running, Retry-After suggests when to poll again. Not recorded in Trails. - [Get a revision](https://docs.ezghcloud.com/run-api/GetRevision/index.md) - [Get a service](https://docs.ezghcloud.com/run-api/GetService/index.md) - [List the organization's operations, newest first](https://docs.ezghcloud.com/run-api/ListOperations/index.md) - [List a service's revisions](https://docs.ezghcloud.com/run-api/ListRevisions/index.md) - [List a project's services](https://docs.ezghcloud.com/run-api/ListServices/index.md) - [Change a service](https://docs.ezghcloud.com/run-api/UpdateService/index.md) — With If-Match. Changing only access, ingress or traffic is synchronous (200, the service); changing any revision field makes a new revision and answers 202 with the operation that deploys it. - [Access](https://docs.ezghcloud.com/run-api/schemas/Access/index.md) - [Egress](https://docs.ezghcloud.com/run-api/schemas/Egress/index.md) - [Error](https://docs.ezghcloud.com/run-api/schemas/Error/index.md) — Every non-2xx answer. Clients branch on code, never on message. - [Ingress](https://docs.ezghcloud.com/run-api/schemas/Ingress/index.md) — all: the run URL and bound load balancers. loadBalancers: only load balancers whose target group is bound to the service; the service has no URL (url is null) until all restores the same URL. - [Operation](https://docs.ezghcloud.com/run-api/schemas/Operation/index.md) - [OperationList](https://docs.ezghcloud.com/run-api/schemas/OperationList/index.md) - [OperationStatus](https://docs.ezghcloud.com/run-api/schemas/OperationStatus/index.md) - [QuotaExceeded](https://docs.ezghcloud.com/run-api/schemas/QuotaExceeded/index.md) — quota_exceeded: the quota that refused the request. Never with Retry-After. - [Revision](https://docs.ezghcloud.com/run-api/schemas/Revision/index.md) - [RevisionList](https://docs.ezghcloud.com/run-api/schemas/RevisionList/index.md) - [RevisionStatus](https://docs.ezghcloud.com/run-api/schemas/RevisionStatus/index.md) - [Service](https://docs.ezghcloud.com/run-api/schemas/Service/index.md) - [ServiceCreate](https://docs.ezghcloud.com/run-api/schemas/ServiceCreate/index.md) - [ServiceList](https://docs.ezghcloud.com/run-api/schemas/ServiceList/index.md) - [ServiceStatus](https://docs.ezghcloud.com/run-api/schemas/ServiceStatus/index.md) - [ServiceUpdate](https://docs.ezghcloud.com/run-api/schemas/ServiceUpdate/index.md) — access, ingress and traffic alone change no revision; any other field makes one. - [Traffic](https://docs.ezghcloud.com/run-api/schemas/Traffic/index.md) — Entries sum to 100.