---
title: "Run agent with a prompt"
method: POST
path: "/api/v1/agents/{id}/run"
tags: ["Agents"]
---

# Run agent with a prompt

`POST /api/v1/agents/{id}/run`

## Request

- Base URL: `https://arcadeops.leadalpes.fr`
- URL: `https://arcadeops.leadalpes.fr/api/v1/agents/{id}/run`
- Auth: none declared

Run agent with a prompt.

## Path parameters

- `id` string, required

## Request body

- object
  - `googleAccounts` object
    - `gmail` string
    - `calendar` string
    - `drive` string
  - `orgId` string
  - `taskId` string
  - `prompt` string, required
  - `model` string
  - `temperature` number
  - `reasoningEffort` 'none' | 'low' | 'medium' | 'high' | 'xhigh'
  - `maxCostUsd` number
  - `allowedTools` string[]
  - `missionId` string
  - `goldenMission` object
    - `manifest` object, required
      - `schemaVersion` 'golden-mission-manifest-v2', required
      - `contractVersion` 'golden-audit-automation-v2', required
      - `campaignId` string, required
      - `missionKeys` string[], required
      - `denominatorPolicy` 'all_declared', required
      - `rerunsCountAsNewMissions` false, required
      - `release` object, required
        - `repository` 'AI-Company/arcadeops', required
        - `releaseId` string, required
        - `commitSha` string, required
        - `treeSha` string, required
        - `targetBaseUrl` string, uri, required
        - `environmentClass` 'staging' | 'production', required
      - `mission` object, required
        - `objective` string, required
        - `expectedOutcome` string, required
        - `process` string, required
        - `constraints` string[], required
        - `acceptanceCriteria` object[], required
          - `criterionId` string, required
          - `statement` string, required
          - `validatorRuleId` string, required
        - `requiredEvidence` string[], required
      - `corpus` object, required
        - `corpusId` string, required
        - `version` string, required
        - `sha256` string, required
        - `sources` object[], required
          - `sourceId` string, required
          - `version` string, required
          - `kind` 'document' | 'url' | 'note', required
          - `classification` 'public' | 'internal' | 'confidential', required
          - `content` string, required
          - `contentSha256` string, required
          - `authorizationRef` string, required
      - `llm` object, required
        - `model` string, required
        - `provider` 'openai' | 'anthropic' | 'gemini' | 'groq' | 'together' | 'deepseek' | 'mistral', required
        - `providerAuthorizationRef` string, required
      - `budget` object, required
        - `currency` 'USD', required
        - `plannedMissions` 10, required
        - `taskBudgetMicros` integer, required
        - `agentRunBudgetMicros` integer, required
        - `loopBudgetMicros` integer, required
        - `campaignMaxCostMicros` integer, required
        - `maxTurnsPerMission` integer, required
        - `maxDurationSecondsPerMission` integer, required
        - `maxTokensPerMission` integer, required
        - `maxToolCallsPerMission` integer, required
        - `maxConsecutiveErrors` integer, required
        - `maxStagnantCheckpoints` integer, required
      - `tenants` object, required
        - `canary` object, required
          - `orgId` string, required
          - `precreated` true, required
          - `disposable` true, required
          - `inventorySha256` string, required
        - `adversarial` object, required
          - `orgId` string, required
          - `precreated` true, required
          - `disposable` true, required
          - `inventorySha256` string, required
      - `decision` object, required
        - `initiatorPrincipalId` string, required
        - `missionOwnerPrincipalId` string, required
        - `sensitiveApproverPrincipalId` string, required
        - `reviewerPrincipalId` string, required
        - `deciderPrincipalId` string, required
        - `deciderRole` 'MANAGER', required
        - `roleRevalidationRequired` true, required
        - `evidencePackBindingRequired` true, required
        - `finalDecisionRequired` true, required
        - `selfAcceptanceAllowed` false, required
      - `retention` object, required
        - `policyId` string, required
        - `policyVersion` string, required
        - `evidenceDays` integer, required
        - `artifactDays` integer, required
        - `eligibleRunsStayInDenominator` true, required
        - `evidenceAppendOnly` true, required
        - `automaticDeletionAllowed` false, required
        - `deletionRequiresSeparateApproval` true, required
      - `policy` object, required
        - `policyId` string, required
        - `policyVersion` string, required
        - `policySha256` string, required
        - `policyMode` 'enforce', required
        - `fallbackPolicy` 'none', required
        - `allowedTools` string[], required
        - `allowedDomains` string[], required
        - `externalEffectMode` 'deny_all', required
        - `allowedExternalEffects` string[], required
        - `forbiddenExternalEffects` string[], required
        - `externalApprovalsAllowed` false, required
        - `outboundDraftOnly` true, required
        - `idempotencyRequired` true, required
      - `runtimeFlags` object, required
        - `requiredOn` string[], required
        - `requiredOff` string[], required
      - `validatorSet` object, required
        - `id` 'arcadeops.deterministic-evidence', required
        - `version` 'v1', required
        - `sha256` 'c73fedd24e8a6de2de836e4c9a540e6fd1051b710d632fc9d456794076dc7ea6', required
        - `authoritativeRuleIds` string[], required
        - `deterministic` true, required
        - `llmJudgeSupplementalOnly` true, required
      - `rollback` object, required
        - `targetReleaseSha` string, required
        - `runbookRef` string, required
        - `stopNextMissionOnHardFail` true, required
        - `preserveEvidenceOnRollback` true, required
      - `execution` object
        - `mode` 'dry-run' | 'live'
        - `target` 'none' | 'staging' | 'production'
        - `providerMode` 'none' | 'live'
    - `manifestSha256` string, required
    - `missionKey` string, required
    - `tenant` 'canary' | 'adversarial', required
  - `replay` object
    - `runId` string, required
    - `contractHash` string, required

## Response `200`

OK

- object
  - `ok` true, required
  - `id` string, required
  - `text` string, required
  - `executionStatus` 'awaiting_approval' | 'completed' | 'cancelled' | 'failed', required
  - `missionOutcome` object, nullable
    - `goalStatus` 'pass' | 'partial' | 'fail' | 'blocked' | 'not_evaluated', required
    - `releaseStatus` 'approved' | 'rejected' | 'pending', required
    - `overallStatus` 'completed' | 'partial_success' | 'blocked' | 'unknown', required
    - `blockedReasons` string[], required
    - `crmImportEvidence` 'proven_success' | 'proven_failure' | 'no_proof', required
    - `verificationVerdict` 'PASS' | 'FAIL' | 'PARTIAL', nullable, required
    - `verificationEvidence` object, nullable, required
      - `runId` string, required
      - `declaredVerdict` 'PASS' | 'FAIL' | 'PARTIAL', required
      - `effectiveVerdict` 'PASS' | 'FAIL' | 'PARTIAL', required
      - `checks` object[], required
        - `name` string, required
        - `result` 'PASS' | 'FAIL', required
        - `detail` string, required
      - `totalChecks` integer, required
      - `passedChecks` integer, required
      - `failedChecks` integer, required
      - `structurallyValid` boolean, required
      - `verifierRunId` string, nullable, required
      - `reportHash` string, nullable, required
      - `model` string, nullable, required
      - `durationMs` integer, nullable, required
      - `tokensUsed` integer, nullable, required
    - `deterministicEvidence` object, nullable, required
      - `version` 'v1', required
      - `runId` string, nullable, required
      - `verdict` 'PASS' | 'FAIL' | 'NOT_APPLICABLE', required
      - `coverage` 'authoritative' | 'supporting' | 'none', required
      - `checks` object[], required
        - `id` string, required
        - `validator` 'exact_output' | 'json_syntax' | 'file_artifact' | 'research_sources' | 'url' | 'http_success', required
        - `name` string, required
        - `result` 'PASS' | 'FAIL', required
        - `coverage` 'authoritative' | 'supporting', required
        - `detail` string, required
        - `evidence` object, required
      - `applicableChecks` integer, required
      - `passedChecks` integer, required
      - `failedChecks` integer, required
      - `evidenceHash` string, required
    - `verdictSource` 'crm_operational_evidence' | 'verification_agent' | 'deterministic_evidence' | 'combined' | 'none', required

---

[API](https://skmtc.dev/leadalpes/apis/arcadeops-api.md) · [All operations](https://skmtc.dev/leadalpes/apis/arcadeops-api/llms.txt) · [OpenAPI document](https://skmtc.dev/leadalpes/apis/arcadeops-api/revisions/f10422ec7412?raw)