Codecloud icon

Codecloud

Run AI coding agents in the cloud with Codecloud

Agent Run → Create Run

AI-generated

Summary

Create a new AI agent run on a specified GitHub repository by submitting a prompt task to an AI provider and model of choice.

Inputs

  • Repository (required) — GitHub repository in format "owner/repo" to target for the agent run.
  • Prompt (required) — Task description for the AI agent, up to 100,000 characters.
  • Model (required) — AI model to use for the agent run; select from available models at https://models.dev/.
  • Provider (required) — AI provider to process the agent run from a predefined list including Anthropic, OpenAI, Google, and others.
  • Additional Options — Optional settings including target Git branch (defaults to default branch), execution mode (execute to run and make changes, or plan to get a plan without changes), whether to automatically create a pull request with changes, and an optional webhook URL to receive notifications on run completion.

Output shape

a single record representing the created agent run with details.

Request is a POST to /v1/agents with body containing all inputs. The output includes the created run data as returned by the Codecloud API.

Links

Discussion