> ## Documentation Index
> Fetch the complete documentation index at: https://ai-development-environment.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# createSimulator

> Queues creation of a simulator on the selected Mac agent.



**mutation** `createSimulator(input: CreateSimulatorInput!): AgentJob!`

## Arguments

**`input`**: `CreateSimulatorInput!` (required)

The agent, device type, runtime, and name for the new simulator.

## Returns

`AgentJob!`

**`id`**: `ID!`

Stable identifier for this agent job.

---

**`agentId`**: `ID!`

Identifier of the related agent.

---

**`worktreeId`**: `ID`

Identifier of the related worktree. May be null when unavailable or not applicable.

---

**`kind`**: `String!`

Category of this agent job.

---

**`commandName`**: `String`

The saved command name captured when this job's command run started. Null for other jobs or unavailable runs.

---

**`payload`**: `JSON!`

Structured payload associated with this agent job.

---

**`operationResources`**: `JSON`

Versioned execution resources used for worktree-scoped scheduling.

---

**`blockedReason`**: `String`

The resource currently keeping this queued job from executing.

---

**`executionToken`**: `String`

Ownership token returned to the executing agent.

---

**`status`**: `AgentJobStatus!`

Current status of this agent job.

---

**`idempotencyKey`**: `String!`

The idempotency key associated with this agent job.

---

**`result`**: `JSON`

Structured result associated with this agent job. May be null when unavailable or not applicable.

---

**`error`**: `String`

Error message when this agent job did not complete successfully. May be null when unavailable or not applicable.

---

**`timeoutSeconds`**: `Int!`

Timeout, in seconds.

---

**`createdAt`**: `String!`

ISO 8601 timestamp when this agent job was created.

---

**`startedAt`**: `String`

ISO 8601 timestamp when this agent job started. May be null when unavailable or not applicable.

---

**`finishedAt`**: `String`

ISO 8601 timestamp when this agent job finished. May be null when unavailable or not applicable.

---

**`updatedAt`**: `String!`

ISO 8601 timestamp when this agent job was last updated.

---

**`codebaseId`**: `ID`

Registered checkout this job operates on, when applicable.

---

**`branchDeletionResults`**: `[BranchDeletionResult!]`

Per-branch outcomes from a local branch cleanup job; null until results are available.

---

**`simulatorInventory`**: `SimulatorInventory`

Inventory returned by a completed simulator inventory job.

---

**`simulatorDetails`**: `SimulatorDetails`

Simulator metadata returned by a completed simulator inspection job.

---

**`worktreeOperationResult`**: `WorktreeOperationResult`

Typed worktree-operation result when this is a worktree operation job.

---

**`worktreeTicketBranchResult`**: `WorktreeTicketBranchResult`

Typed output of a successful Jira branch generation job.



This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.