---
title: "Create a data definition"
description: "Define one thing Agents should capture. `kind`: `attribute` (a property of the subject), `assessment` (a judgement about a conversation; yes/no ones feed the `assessment_results_daily` report), `category` (a classification) or `metric` (a measured number with a `unit`). `subject`: `contact` or `conversation`. `valueType`: `text`, `number`, `boolean`, `date` or `option` (with its `options`). Give a unique `key`, a `name`, optional `instructions` telling the Agent how to decide, and the `agentIds` that collect it. Fails with KEY_IN_USE when a draft or active definition already has the key.\n\n- **Scope:** `raiz:definitions:write`\n- **Credentials:** an API key, a client-credentials token or a person's access token\n- **Effect:** writes; not idempotent: check the outcome before you retry\n- **Limits:** request body up to 32 KB, response up to 1 MB\n- **CLI:** `arbol raiz definitions create` · **MCP tool:** `raiz_definitions_create`"
---

> Documentation Index
> Fetch the complete documentation index at: https://docs.getarbol.com/llms.txt
> Use this file to discover all available pages before exploring further.

Path: Raíz API › Definitions

`POST /v1/raiz/definitions`

Define one thing Agents should capture. `kind`: `attribute` (a property of the subject), `assessment` (a judgement about a conversation; yes/no ones feed the `assessment_results_daily` report), `category` (a classification) or `metric` (a measured number with a `unit`). `subject`: `contact` or `conversation`. `valueType`: `text`, `number`, `boolean`, `date` or `option` (with its `options`). Give a unique `key`, a `name`, optional `instructions` telling the Agent how to decide, and the `agentIds` that collect it. Fails with KEY_IN_USE when a draft or active definition already has the key.

- **Scope:** `raiz:definitions:write`
- **Credentials:** an API key, a client-credentials token or a person's access token
- **Effect:** writes; not idempotent: check the outcome before you retry
- **Limits:** request body up to 32 KB, response up to 1 MB
- **CLI:** `arbol raiz definitions create` · **MCP tool:** `raiz_definitions_create`

## Authentication

Requires one of the following:

- `arbolHuman`, oauth2, scopes: `raiz:definitions:write`
- `arbolMachine`, oauth2, scopes: `raiz:definitions:write`
- `arbolApiKey`, http, header `Authorization`

## Request body

_Required._

- `key` (`raiz.definitions.create.key`; string, required) — Stable machine name: lower case letters, digits and `_`, starting with a letter. A CSV column with this header imports into the definition.
  - pattern `^[a-z][a-z0-9_]{0,63}$`
- `kind` (`raiz.definitions.create.kind`; string, required) — `attribute`: a property of the subject. `assessment`: a judgement about a conversation (yes/no assessments feed the assessment report). `category`: a classification. `metric`: a measured number, with a `unit`.
  - one of `"attribute"`, `"assessment"`, `"category"`, `"metric"`
- `name` (`raiz.definitions.create.name`; string, required)
  - minLength 1; maxLength 120
- `subject` (`raiz.definitions.create.subject`; string, required) — What the facts describe.
  - one of `"contact"`, `"conversation"`
- `valueType` (`raiz.definitions.create.valueType`; string, required) — The JSON type of the facts' values: a string, a number, a boolean, a `YYYY-MM-DD` date, or the key of one of the options.
  - one of `"text"`, `"number"`, `"boolean"`, `"date"`, `"option"`
- `agentIds` (`raiz.definitions.create.agentIds`; array<string>, optional) — The Agents that use the definition; empty for every Agent. In an update, the complete new set.
  - pattern `^agt_(?:[0-7][0-9a-hjkmnp-tv-z]{25}|(?:[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}|[a-f0-9]{32}))$`
- `description` (`raiz.definitions.create.description`; string | null, optional)
  - maxLength 2000
- `instructions` (`raiz.definitions.create.instructions`; string | null, optional)
  - maxLength 4000
- `options` (`raiz.definitions.create.options`; array<object>, optional) — The options of an `option` definition, in order, with unique keys. In an update, the complete new set: an option is matched by key and keeps its id; one left out is retired, never deleted, because facts reference it.
  - `key` (`raiz.definitions.create.options.key`; string, required) — Stable machine name of the option; a fact's value is this key.
    - pattern `^[a-z][a-z0-9_]{0,63}$`
  - `label` (`raiz.definitions.create.options.label`; string, required)
    - minLength 1; maxLength 120
  - `description` (`raiz.definitions.create.options.description`; string | null, optional)
    - maxLength 1000
- `status` (`raiz.definitions.create.status`; string, optional) — `active` definitions accept facts and Agents use them; `draft` ones are being prepared. Retiring is `deleteDefinition`.
  - one of `"draft"`, `"active"`
- `unit` (`raiz.definitions.create.unit`; string | null, optional)
  - minLength 1; maxLength 32

## Example request

```json
{
  "agentIds": [
    "agt_01m45h8q2rf3t9w6y7z0b1c2d3"
  ],
  "description": "string",
  "instructions": "string",
  "options": [
    {
      "description": "string",
      "key": "string",
      "label": "string"
    }
  ],
  "status": "draft",
  "unit": "string",
  "key": "eps",
  "kind": "attribute",
  "name": "string",
  "subject": "contact",
  "valueType": "text"
}
```

## Code samples

### cURL

```bash
curl https://api.getarbol.com/v1/raiz/definitions \
  --request POST \
  --header "Authorization: Bearer $ARBOL_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{
  "key": "eps",
  "kind": "attribute",
  "name": "<name>",
  "subject": "contact",
  "valueType": "text"
}'
```

### TypeScript

```typescript
import { createClient } from "@arbol-ai/sdk";

const arbol = createClient({
  baseUrl: "https://api.getarbol.com",
  token: process.env.ARBOL_API_KEY!,
});

const { data } = await arbol.raiz.definitions.create({
  key: "eps",
  kind: "attribute",
  name: "<name>",
  subject: "contact",
  valueType: "text",
});
```

### Rust

```rust
use arbol_sdk::{types, Client, Credential};

let arbol = Client::new(Credential::ApiKey(std::env::var("ARBOL_API_KEY")?))?;

let data = arbol
    .raiz()
    .definitions()
    .create(&types::RaizDefinitionsCreateInput {
        key: "eps".into(),
        kind: types::RaizDefinitionsCreateInputKind::Attribute,
        name: "<name>".into(),
        subject: types::RaizDefinitionsCreateInputSubject::Contact,
        value_type: types::RaizDefinitionsCreateInputValueType::Text,
        agent_ids: None,
        description: None,
        instructions: None,
        options: None,
        status: None,
        unit: None,
    })
    .await?;
```

### CLI

```bash
arbol raiz definitions create --key eps --kind attribute --name '<name>' --subject contact --value-type text
```

### MCP

```json
{
  "name": "raiz_definitions_create",
  "arguments": {
    "key": "eps",
    "kind": "attribute",
    "name": "<name>",
    "subject": "contact",
    "valueType": "text"
  }
}
```

## Responses

### 200

Successful operation.

#### Example

```json
{
  "success": true,
  "data": {
    "agentIds": [
      "agt_01m45h8q2rf3t9w6y7z0b1c2d3"
    ],
    "createdAt": "2019-08-24T14:15:22Z",
    "description": "string",
    "id": "def_01m45h8q2rf3t9w6y7z0b1c2d3",
    "instructions": "string",
    "key": "string",
    "kind": "attribute",
    "name": "string",
    "options": [
      {
        "description": "string",
        "id": "opt_01m45h8q2rf3t9w6y7z0b1c2d3",
        "key": "string",
        "label": "string"
      }
    ],
    "status": "draft",
    "subject": "contact",
    "unit": "string",
    "updatedAt": "2019-08-24T14:15:22Z",
    "valueType": "text",
    "version": 1
  },
  "error": null,
  "metadata": {
    "requestId": "string"
  }
}
```

- `success` (`raiz.definitions.create.response.200.success`; boolean, required)
- `data` (`raiz.definitions.create.response.200.data`; object, required)
  - `agentIds` (`raiz.definitions.create.response.200.data.agentIds`; array<string>, required) — The Agents that use the definition. Empty: every Agent of the organization.
    - pattern `^agt_(?:[0-7][0-9a-hjkmnp-tv-z]{25}|(?:[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}|[a-f0-9]{32}))$`
  - `createdAt` (`raiz.definitions.create.response.200.data.createdAt`; string, required) — An instant in RFC 3339 format, in UTC.
    - format `date-time`
  - `description` (`raiz.definitions.create.response.200.data.description`; string | null, required)
  - `id` (`raiz.definitions.create.response.200.data.id`; string, required) — Definition id.
    - pattern `^def_(?:[0-7][0-9a-hjkmnp-tv-z]{25}|(?:[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}|[a-f0-9]{32}))$`
  - `instructions` (`raiz.definitions.create.response.200.data.instructions`; string | null, required) — How the AI decides the value.
  - `key` (`raiz.definitions.create.response.200.data.key`; string, required)
  - `kind` (`raiz.definitions.create.response.200.data.kind`; string, required) — `attribute`: a property of the subject. `assessment`: a judgement about a conversation (yes/no assessments feed the assessment report). `category`: a classification. `metric`: a measured number, with a `unit`.
    - one of `"attribute"`, `"assessment"`, `"category"`, `"metric"`
  - `name` (`raiz.definitions.create.response.200.data.name`; string, required)
  - `options` (`raiz.definitions.create.response.200.data.options`; array<object>, required) — The active options, in order. Retired options keep typing the facts that use them but are not listed.
    - `description` (`raiz.definitions.create.response.200.data.options.description`; string | null, required)
    - `id` (`raiz.definitions.create.response.200.data.options.id`; string, required) — Option id.
      - pattern `^opt_(?:[0-7][0-9a-hjkmnp-tv-z]{25}|(?:[a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12}|[a-f0-9]{32}))$`
    - `key` (`raiz.definitions.create.response.200.data.options.key`; string, required)
    - `label` (`raiz.definitions.create.response.200.data.options.label`; string, required)
  - `status` (`raiz.definitions.create.response.200.data.status`; string, required)
    - one of `"draft"`, `"active"`, `"retired"`
  - `subject` (`raiz.definitions.create.response.200.data.subject`; string, required) — What the facts describe.
    - one of `"contact"`, `"conversation"`
  - `unit` (`raiz.definitions.create.response.200.data.unit`; string | null, required) — UCUM unit of a metric.
  - `updatedAt` (`raiz.definitions.create.response.200.data.updatedAt`; string, required) — An instant in RFC 3339 format, in UTC.
    - format `date-time`
  - `valueType` (`raiz.definitions.create.response.200.data.valueType`; string, required) — The JSON type of the facts' values: a string, a number, a boolean, a `YYYY-MM-DD` date, or the key of one of the options.
    - one of `"text"`, `"number"`, `"boolean"`, `"date"`, `"option"`
  - `version` (`raiz.definitions.create.response.200.data.version`; integer, required)
    - min 1
- `error` (`raiz.definitions.create.response.200.error`; null, required)
- `metadata` (`raiz.definitions.create.response.200.metadata`; object, required)
  - `requestId` (`raiz.definitions.create.response.200.metadata.requestId`; string, required) — Request correlation identifier, also sent as X-Request-Id.

### 400

`INVALID_INPUT`: The request does not match the published schema.

#### Example

```json
{
  "error": {
    "code": "INVALID_INPUT"
  }
}
```

- `error` (`raiz.definitions.create.response.400.error`; object, required)
  - any of: `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`

### 401

`UNAUTHORIZED`: A valid access token is required.

#### Example

```json
{
  "error": {
    "code": "UNAUTHORIZED"
  }
}
```

- `error` (`raiz.definitions.create.response.401.error`; object, required)
  - any of: `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`

### 403

`FORBIDDEN`: The token does not authorize this operation.

#### Example

```json
{
  "error": {
    "code": "FORBIDDEN"
  }
}
```

- `error` (`raiz.definitions.create.response.403.error`; object, required)
  - any of: `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`

### 404

- `NOT_FOUND`: The requested operation does not exist.
- `RESOURCE_NOT_FOUND`: The requested resource does not exist in this organization.

#### Example

```json
{
  "error": {
    "code": "NOT_FOUND"
  }
}
```

- `error` (`raiz.definitions.create.response.404.error`; object, required)
  - any of: `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`

### 405

`HTTP_METHOD_NOT_ALLOWED`: The HTTP method is not supported for this resource.

#### Example

```json
{
  "error": {
    "code": "HTTP_METHOD_NOT_ALLOWED"
  }
}
```

- `error` (`raiz.definitions.create.response.405.error`; object, required)
  - any of: `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`

### 409

- `DEFINITION_RETIRED`: The definition is retired and can no longer change.
- `DEFINITION_TYPE_LOCKED`: The value type and subject of a definition cannot change once it has facts. Retire it and create a new one instead.
- `KEY_IN_USE`: Another active resource in this organization already uses this key.
- `VERSION_CONFLICT`: The resource changed after it was read. Read it again and retry with the new version.

#### Example

```json
{
  "error": {
    "code": "DEFINITION_RETIRED"
  }
}
```

- `error` (`raiz.definitions.create.response.409.error`; object, required)
  - any of: `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`

### 413

`REQUEST_TOO_LARGE`: The request exceeds the allowed size.

#### Example

```json
{
  "error": {
    "code": "REQUEST_TOO_LARGE"
  }
}
```

- `error` (`raiz.definitions.create.response.413.error`; object, required)
  - any of: `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`

### 415

`UNSUPPORTED_MEDIA_TYPE`: The request content type is not supported.

#### Example

```json
{
  "error": {
    "code": "UNSUPPORTED_MEDIA_TYPE"
  }
}
```

- `error` (`raiz.definitions.create.response.415.error`; object, required)
  - any of: `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`

### 422

`DEFINITION_OPTIONS_INVALID`: Only a definition whose value type is `option` has options; it needs at least one, and option keys must be unique.

#### Example

```json
{
  "error": {
    "code": "DEFINITION_OPTIONS_INVALID"
  }
}
```

- `error` (`raiz.definitions.create.response.422.error`; object, required)
  - any of: `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`

### 429

`RATE_LIMITED`: The request rate limit was exceeded. Try again later.

#### Example

```json
{
  "error": {
    "code": "RATE_LIMITED"
  }
}
```

- `error` (`raiz.definitions.create.response.429.error`; object, required)
  - any of: `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`

### 500

`INTERNAL_ERROR`: The service could not complete the operation.

#### Example

```json
{
  "error": {
    "code": "INTERNAL_ERROR"
  }
}
```

- `error` (`raiz.definitions.create.response.500.error`; object, required)
  - any of: `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`

### 502

`OUTCOME_UNKNOWN`: The operation may have been applied; check its result before repeating it.

#### Example

```json
{
  "error": {
    "code": "OUTCOME_UNKNOWN"
  }
}
```

- `error` (`raiz.definitions.create.response.502.error`; object, required)
  - any of: `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`

### 503

- `UPSTREAM_UNAVAILABLE`: The upstream service could not complete the request.
- `INTEGRATIONS_UNAVAILABLE`: The organization's integrations cannot be read right now. Try again shortly.

#### Example

```json
{
  "error": {
    "code": "UPSTREAM_UNAVAILABLE"
  }
}
```

- `error` (`raiz.definitions.create.response.503.error`; object, required)
  - any of: `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`

### 504

`UPSTREAM_TIMEOUT`: The upstream service did not respond before its deadline.

#### Example

```json
{
  "error": {
    "code": "UPSTREAM_TIMEOUT"
  }
}
```

- `error` (`raiz.definitions.create.response.504.error`; object, required)
  - any of: `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`, `object`


Source: https://docs.getarbol.com/api/raiz/definitions/create/index.md