# Certifyos Agent Runs API

**Canonical:** https://apis.io/apis/certifyos/certifyos-agentruns-api/  
**Provider:** Certifyos — https://apis.io/providers/certifyos/  
**Base URL:** https://api-service.certifyos.com  
**Documentation:** https://docs.certifyos.com/reference/api-service/openapi

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

Pass-through proxy to the agentOS application-release agent

## Operations (13)

| Method | Path | Summary |
|---|---|---|
| POST | `/agent/practitioners/{practitionerId}/runs` | Start an application-release run for a practitioner |
| GET | `/agent/runs/{runId}` | Get an agentOS run record |
| POST | `/agent/runs/{runId}/answers` | Submit answers to one or more open questions |
| GET | `/agent/runs/{runId}/events` | Get a run's activity log, cursor-paginated |
| GET | `/agent/runs/{runId}/proposals` | List a run's proposals plus its handoff state |
| POST | `/agent/runs/{runId}/proposals/approve-all` | Approve every pending proposal on a run |
| POST | `/agent/runs/{runId}/proposals/deny-all` | Deny every pending proposal on a run |
| POST | `/agent/runs/{runId}/proposals/{proposalId}/approve` | Approve one proposal |
| POST | `/agent/runs/{runId}/proposals/{proposalId}/deny` | Deny one proposal |
| GET | `/agent/runs/{runId}/questions` | Get a run's current suspension/open questions |
| POST | `/agent/runs/{runId}/resume` | Resume a suspended run after its questions are answered |
| POST | `/agent/runs/{runId}/take-over` | Claim human ownership of a live run |
| POST | `/agent/workflows/agent-state` | Batch agentState lookup by workflow/practitioner ids |

## Machine-readable artifacts (5)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/certifyos/refs/heads/main/openapi/certifyos-agentruns-api-openapi.yml
- **Documentation** — https://docs.certifyos.com/providerhub
- **APIReference** — https://docs.certifyos.com/reference/api-service/openapi
- **Webhooks** — https://raw.githubusercontent.com/api-evangelist/certifyos/refs/heads/main/asyncapi/certifyos-webhooks.yml
- **APIReference** — https://docs.certifyos.com/reference/application/api

## Other Certifyos APIs (12)

- [Certifyos Address Standardization API](https://apis.io/apis/certifyos/certifyos-addressstandardization-api/)
- [Certifyos Auth API](https://apis.io/apis/certifyos/certifyos-auth-api/)
- [Certifyos Contracts API](https://apis.io/apis/certifyos/certifyos-contracts-api/)
- [Certifyos Credentialing Outreach Resource API](https://apis.io/apis/certifyos/certifyos-credentialing-outreach-resource-api/)
- [Certifyos Credentialing Workflow API](https://apis.io/apis/certifyos/certifyos-credentialingworkflow-api/)
- [Certifyos Dal Reactive Test Resource API](https://apis.io/apis/certifyos/certifyos-dal-reactive-test-resource-api/)
- [Certifyos Directory API](https://apis.io/apis/certifyos/certifyos-directory-api/)
- [Certifyos Egress Template API](https://apis.io/apis/certifyos/certifyos-egresstemplate-api/)
- [Certifyos Event Email Settings API](https://apis.io/apis/certifyos/certifyos-event-email-settings-api/)
- [Certifyos Facility API](https://apis.io/apis/certifyos/certifyos-facility-api/)
- [Certifyos Facility Credentialing Outreach Resource API](https://apis.io/apis/certifyos/certifyos-facility-credentialing-outreach-resource-api/)
- [Certifyos Facility Note API](https://apis.io/apis/certifyos/certifyos-facility-note-api/)

## Tags

Agent Runs

---

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