# BuildResponse

The result of a build: whether it succeeded, its log, and each definition it created, updated or left unchanged. The definition lists are empty when the build failed.

**Kind:** an object, used in responses.

## Fields

Every field is present in a response; empty ones are `null`.

| Field | Type | Description |
|---|---|---|
| `isSuccess` | `boolean` | Whether the build succeeded: its log has no `Error` entry. Set by Maitento. |
| `isDeployed` | `boolean` | Whether the definitions were deployed. Always false for a validation. |
| `buildId` | `uuid \| null` | The build's id. Read its record with `GET /builds/by-id/{id}`. Null when the build could not be recorded. |
| `log` | [`CompilationLogEntry`](https://docs.maitento.com/reference/types/compilation-log-entry.md)`[]` | The build's messages, in order: errors, warnings and information, each with where it came from. |
| `agents` | [`BuildEntityOfAgent`](https://docs.maitento.com/reference/types/build-entity-of-agent.md)`[]` | The agents in the build. |
| `capsules` | [`BuildEntityOfCapsule`](https://docs.maitento.com/reference/types/build-entity-of-capsule.md)`[]` | The capsules in the build. |
| `connectors` | [`BuildConnectorsResponse`](https://docs.maitento.com/reference/types/build-connectors-response.md) | The connectors in the build. |
| `externalOperations` | [`BuildExternalOperationsResponse`](https://docs.maitento.com/reference/types/build-external-operations-response.md) | The tools in the build. |
| `interactions` | [`BuildInteractionsResponse`](https://docs.maitento.com/reference/types/build-interactions-response.md) | The interactions in the build. |
| `apps` | [`BuildEntityOfApp`](https://docs.maitento.com/reference/types/build-entity-of-app.md)`[]` | The apps in the build. |
| `codePipelines` | [`BuildEntityOfCodePipeline`](https://docs.maitento.com/reference/types/build-entity-of-code-pipeline.md)`[]` | The code pipelines in the build. |
| `looms` | [`BuildEntityOfLoom`](https://docs.maitento.com/reference/types/build-entity-of-loom.md)`[]` | The named looms in the build. |

## Example

```json
{
  "isSuccess": false,
  "isDeployed": false,
  "buildId": "3f2b8c1e-5d4a-4e6b-9c7d-2a1b0c9d8e7f",
  "log": [
    {
      "text": "...",
      "date": "2026-10-26T12:00:00.0000000Z",
      "logLevel": "Debug",
      "filename": "...",
      "lineNumber": 0,
      "character": 0
    }
  ],
  "agents": [
    {
      "entity": {},
      "mode": "Created"
    }
  ],
  "capsules": [
    {
      "entity": {},
      "mode": "Created"
    }
  ],
  "connectors": {
    "openApi": [
      {}
    ],
    "modelContextProtocol": [
      {}
    ]
  },
  "externalOperations": {
    "openApi": [
      {}
    ],
    "modelContextProtocol": [
      {}
    ]
  },
  "interactions": {
    "roundRobin": [
      {}
    ],
    "oneShot": [
      {}
    ],
    "managed": [
      {}
    ]
  },
  "apps": [
    {
      "entity": {},
      "mode": "Created"
    }
  ],
  "codePipelines": [
    {
      "entity": {},
      "mode": "Created"
    }
  ],
  "looms": [
    {
      "entity": {},
      "mode": "Created"
    }
  ]
}
```

## Where it's used

- [`builds.deploy`](https://docs.maitento.com/reference/api/builds.md) (`PUT /namespaces/{namespaceName}/build`)
