<!-- נוצר אוטומטית ממקור התיעוד הקנוני של Teloring. אין לערוך קובץ זה. -->

עמוד קנוני: https://docs.teloring.com/he/api/create-object-field
עודכן לאחרונה: 2026-10-15T07:55:15.000Z

# Add a field

import MethodEndpoint from "@theme/ApiExplorer/MethodEndpoint";
import ParamsDetails from "@theme/ParamsDetails";
import RequestSchema from "@theme/RequestSchema";
import StatusCodes from "@theme/StatusCodes";
import OperationTabs from "@theme/OperationTabs";
import TabItem from "@theme/TabItem";
import Heading from "@theme/Heading";
import Translate from "@docusaurus/Translate";

<Heading
  as={"h1"}
  className={"openapi__heading"}
  children={"Add a field"}
>
</Heading>

<MethodEndpoint
  method={"post"}
  path={"/objects/{object_id}/fields"}
  context={"endpoint"}
>
  
</MethodEndpoint>



Add a field to an object. Scope `objects_admin`. Existing records receive it in
the background (an empty value, or the computed value of a lookup, count or
auto number).

`config` depends on `type`: choice fields take `options` (and optional `colors`,
`default`); `number` / `currency` take `decimal_places` and `currency_code`;
`relation` takes `target_object_id` and `cardinality` (`one` | `many`) and creates
the inverse field on the target; `lookup` takes `relation_field_id`,
`source_field_id` and `mode` (`live` | `frozen`); `related_count` takes
`inverse_field_id`; `auto_number` takes `prefix`, `padding`, `start_at`;
`rating` takes `max` (1–10) and `icon` (`star` | `heart` | `fire` | `thumb` | `number`);
`progress` takes `start`, `end`, `display` (`percent` | `value`) and `color`;
`button` takes `label`, `color` and `confirm`.

**Formulas.** `text`, `number`, `currency`, `date`, `datetime`, `checkbox`,
`dropdown`, `radio`, `rating` and `progress` fields may take `config.formula` (see
`FormulaDefinition`; fields by id or api_id): the value is then calculated from the
record's other fields, kept up to date by the platform and read-only. Existing
records are calculated in the background. Send `formula: null` on update to turn
it back into a field people type in.

<Heading
  id={"request"}
  as={"h2"}
  className={"openapi-tabs__heading"}
>
  <Translate id="theme.openapi.request.title">Request</Translate>
</Heading>

<ParamsDetails
  {...require("./create-object-field.ParamsDetails.json")}
>
  
</ParamsDetails>

<RequestSchema
  {...require("./create-object-field.RequestSchema.json")}
>
  
</RequestSchema>

<StatusCodes
  {...require("./create-object-field.StatusCodes.json")}
>
  
</StatusCodes>
